Telr Developer Documentation

curl --request POST \
  --url https://sandbox.cashfree.com/api/v2/subscriptions/seamless/subscription \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriptionId": "DemoSubscription",
  "planId": "TestPlan_ReArch_002",
  "customerName": "John",
  "customerPhone": "99999XXXXX",
  "customerEmail": "john@gmail.com",
  "returnUrl": "www.google.com",
  "authAmount": 1,
  "expiresOn": "2024-12-02 09:20:12",
  "firstChargeDate": "2024-12-02",
  "payerAccountDetails": {
    "accountNumber": "007200000000",
    "accountHolderName": "John",
    "bankId": "ICIC",
    "accountType": "SAVINGS",
    "ifsc": "ICIC0000072"
  },
  "notificationChannels": [
    "EMAIL",
    "SMS"
  ]
}
'

{
  "status": 200,
  "message": "Subscription Created",
  "data": {
    "subReferenceId": 107350,
    "subscriptionId": "DemoSubscription",
    "customerPhone": "9999988888",
    "customerEmail": "demo.email@gmail.com",
    "planId": "TestPlan_ReArch_002",
    "status": "INITIALIZED",
    "currentCycle": 0,
    "authAmount": 1,
    "returnUrl": "www.google.com",
    "startDate": {
      "E_MANDATE": "2024-12-02",
      "UPI": "2024-12-02"
    },
    "endDate": "2024-12-02 09:20:12",
    "tpvEnabled": false,
    "paymentOptions": [
      {
        "type": "E_MANDATE",
        "accountTypes": [
          "SAVINGS",
          "CURRENT"
        ],
        "frequentBankDetails": [
          {
            "bankId": "SBIN",
            "bankName": "STATE BANK OF INDIA",
            "accountAuthModes": [
              "DEBIT_CARD",
              "NET_BANKING"
            ]
          }
        ]
      }
    ]
  }
}

{
  "status": "ERROR",
  "subCode": "400",
  "message": "Invalid subscription expiresOn"
}

{
  "status": "ERROR",
  "message": "Server encountered an unexpected condition."
}

POST

api

subscriptions

seamless

subscription

curl --request POST \
  --url https://sandbox.cashfree.com/api/v2/subscriptions/seamless/subscription \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriptionId": "DemoSubscription",
  "planId": "TestPlan_ReArch_002",
  "customerName": "John",
  "customerPhone": "99999XXXXX",
  "customerEmail": "john@gmail.com",
  "returnUrl": "www.google.com",
  "authAmount": 1,
  "expiresOn": "2024-12-02 09:20:12",
  "firstChargeDate": "2024-12-02",
  "payerAccountDetails": {
    "accountNumber": "007200000000",
    "accountHolderName": "John",
    "bankId": "ICIC",
    "accountType": "SAVINGS",
    "ifsc": "ICIC0000072"
  },
  "notificationChannels": [
    "EMAIL",
    "SMS"
  ]
}
'

{
  "status": 200,
  "message": "Subscription Created",
  "data": {
    "subReferenceId": 107350,
    "subscriptionId": "DemoSubscription",
    "customerPhone": "9999988888",
    "customerEmail": "demo.email@gmail.com",
    "planId": "TestPlan_ReArch_002",
    "status": "INITIALIZED",
    "currentCycle": 0,
    "authAmount": 1,
    "returnUrl": "www.google.com",
    "startDate": {
      "E_MANDATE": "2024-12-02",
      "UPI": "2024-12-02"
    },
    "endDate": "2024-12-02 09:20:12",
    "tpvEnabled": false,
    "paymentOptions": [
      {
        "type": "E_MANDATE",
        "accountTypes": [
          "SAVINGS",
          "CURRENT"
        ],
        "frequentBankDetails": [
          {
            "bankId": "SBIN",
            "bankName": "STATE BANK OF INDIA",
            "accountAuthModes": [
              "DEBIT_CARD",
              "NET_BANKING"
            ]
          }
        ]
      }
    ]
  }
}

{
  "status": "ERROR",
  "subCode": "400",
  "message": "Invalid subscription expiresOn"
}

{
  "status": "ERROR",
  "message": "Server encountered an unexpected condition."
}

Headers

x-client-id

string

Example:

"{{X-Client-Id}}"

x-client-secret

string

Example:

"{{X-Client-Secret}}"

Body

application/json

subscriptionId

string

Unique identifier for the subscription.

Example:

"DemoSubscription"

planId

string

Unique identifier for the subscription plan.

Example:

"TestPlan_ReArch_002"

customerName

string

Name of the customer subscribing.

Example:

"John"

customerPhone

string

Customer's phone number.

Example:

"99999XXXXX"

customerEmail

string

Customer's email address.

Example:

"john@gmail.com"

returnUrl

string

URL to redirect the user after successful subscription.

Example:

"www.google.com"

authAmount

number

Authorization amount for the subscription.

Example:

1

expiresOn

string

Expiration date for the subscription.

Example:

"2024-12-02 09:20:12"

firstChargeDate

string

First charge date for the subscription.

Example:

"2024-12-02"

payerAccountDetails

object

Show child attributes

notificationChannels

string[]

Notification channels for subscription.

Example:

["EMAIL", "SMS"]

tpvEnabled

boolean

Whether Third Party Verification (TPV) is enabled.

Example:

true

splitDetails

object

Show child attributes

Response

Successful subscription creation.

status

integer

Status code of the response.

Example:

200

message

string

Status message.

Example:

"Subscription Created"

data

object

Show child attributes