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": "[email protected]", "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": "[email protected]",
    "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:

"[email protected]"

​
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