Cashfree Payments Developer Documentation

curl --request POST \
  --url https://sandbox.cashfree.com/api/v2/subscriptions/seamless/authorization \
  --header 'Content-Type: application/json' \
  --data '
{
  "subReferenceId": 123456,
  "merchantTxnId": "merchant-txn-id-1",
  "authPaymentInfo": {
    "paymentType": "UPI",
    "vpa": "johndoe@upi",
    "authFlow": "UPI_COLLECT"
  }
}
'

{
  "status": 200,
  "message": "Authorization Created",
  "data": {
    "subReferenceId": 123456,
    "authId": 23456789,
    "authStatus": "INITIALIZED",
    "merchantTxnId": "txn.id-1_2_3",
    "authPaymentData": {
      "paymentType": "UPI"
    }
  }
}

POST

api

subscriptions

seamless

authorization

curl --request POST \
  --url https://sandbox.cashfree.com/api/v2/subscriptions/seamless/authorization \
  --header 'Content-Type: application/json' \
  --data '
{
  "subReferenceId": 123456,
  "merchantTxnId": "merchant-txn-id-1",
  "authPaymentInfo": {
    "paymentType": "UPI",
    "vpa": "johndoe@upi",
    "authFlow": "UPI_COLLECT"
  }
}
'

{
  "status": 200,
  "message": "Authorization Created",
  "data": {
    "subReferenceId": 123456,
    "authId": 23456789,
    "authStatus": "INITIALIZED",
    "merchantTxnId": "txn.id-1_2_3",
    "authPaymentData": {
      "paymentType": "UPI"
    }
  }
}

Headers

x-client-id

string

Example:

"{{X-Client-Id}}"

x-client-secret

string

Example:

"{{X-Client-Secret}}"

Body

application/json

subReferenceId

integer

Reference ID for the subscription.

Example:

123456

merchantTxnId

string

Unique transaction ID for the merchant.

Example:

"merchant-txn-id-1"

authPaymentInfo

object

Show child attributes

authPaymentInfo.paymentType

string

Type of payment (e.g., UPI, CARD, E_MANDATE).

Example:

"UPI"

authPaymentInfo.vpa

string

Virtual Payment Address for UPI payments.

Example:

"johndoe@upi"

authPaymentInfo.authFlow

string

Type of UPI flow (e.g., UPI_COLLECT, UPI_INTENT).

Example:

"UPI_COLLECT"

authPaymentInfo.cardNumber

string

Card number for card payments.

Example:

"4444333322221111"

authPaymentInfo.cardHolderName

string

Name on the card.

Example:

"John Doe"

authPaymentInfo.cardCvv

string

CVV number of the card.

Example:

"123"

authPaymentInfo.cardExpiryMonth

string

Expiry month of the card.

Example:

"12"

authPaymentInfo.cardExpiryYear

string

Expiry year of the card.

Example:

"2099"

authPaymentInfo.accountHolderName

string

Account holder name for E_MANDATE.

Example:

"John Doe"

authPaymentInfo.accountNumber

string

Account number for E_MANDATE.

Example:

"1234567890"

authPaymentInfo.bankId

string

Bank identifier for E_MANDATE.

Example:

"SBIN"

authPaymentInfo.accountType

string

Account type for E_MANDATE (e.g., SAVINGS).

Example:

"SAVINGS"

authPaymentInfo.authMode

string

Authentication mode for E_MANDATE (e.g., DEBIT_CARD, NET_BANKING).

Example:

"DEBIT_CARD"

authPaymentInfo.pNachFileId

string

Physical Nach File ID for mandate.

Example:

"1475380791"

authPaymentInfo.mandateCreationDate

string

Date the mandate was created.

Example:

"2023-07-25"

authPaymentInfo.mandateStartDate

string

Start date of the mandate.

Example:

"2023-07-27"

Response

Successful authorization request.

Create Seamless Subscription with Plan ID Get Authorization Status

⌘I

Payments API

v2025-01-01

Other Versions

Create Authorization Request

Headers

Body

Response