Skip to main content
POST
/
api
/
v2
/
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"
            ]
          }
        ]
      }
    ]
  }
}

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
ā€‹
notificationChannels
string[]

Notification channels for subscription.

Example:
["EMAIL", "SMS"]
ā€‹
tpvEnabled
boolean

Whether Third Party Verification (TPV) is enabled.

Example:

true

ā€‹
splitDetails
object

Response

Successful subscription creation.

ā€‹
status
integer

Status code of the response.

Example:

200

ā€‹
message
string

Status message.

Example:

"Subscription Created"

ā€‹
data
object