curl --request POST \
--url https://sandbox.cashfree.com/pg/orders/sessions/authorize \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"payment_session_id": "session__CvcEmNKDkmERQrxnx39ibhJ3Ii034pjc8ZVxf3qcgEXCWlgDDlHRgz2XYZCqpajDQSXMMtCusPgOIxYP2LZx0-05p39gC2Vgmq1RAj--gcn",
"authorization_data": {
"authentication_token": "BwABBJQ1AgAAAAAgJDUCAAAAAAA=",
"directory_server_transaction_id": "8ac7b70f-9c5c-4e8f-9f4a-6d7c8b2a1e3f",
"three_ds_server_transaction_id": "9b8a7c6d-5e4f-3210-9876-543210fedcba",
"eci": "02",
"token_number": "4111111111111111",
"token_expiry_year": "2029",
"token_expiry_month": "09",
"token_cryptogram": "/wAAAAAAUSwFGXgAAAAAgPAAAA=",
"transaction_type": "TOKEN"
}
}
'
{
"auth_id": "302651",
"authorization": null,
"bank_reference": "524410198110",
"cf_payment_id": "4304193706",
"entity": "payment",
"error_details": null,
"international_payment": {
"international": false
},
"is_captured": false,
"order_amount": 1,
"order_currency": "INR",
"order_id": "CFPay_payme_rohittest_3vv0ethp9r",
"payment_amount": 1,
"payment_completion_time": "2025-09-01T15:42:38+05:30",
"payment_currency": "INR",
"payment_gateway_details": {
"gateway_name": "CASHFREE",
"gateway_order_id": "CF_ORDER_987654321",
"gateway_payment_id": "CF_PAY_123456789",
"gateway_order_reference_id": "REF_ORD_2025010112345",
"gateway_status_code": "SUCCESS",
"gateway_settlement": "cashfree",
"gateway_reference_name": "APPLE_PAY_TXN_REF"
},
"payment_group": "debit_card",
"payment_message": "PRE_AUTH|Transaction Success",
"payment_method": {
"card": {
"card_bank_name": "KOTAK MAHINDRA BANK",
"card_country": "IN",
"card_network": "visa",
"card_network_reference_id": "VIS_REF_20250101123456",
"card_number": "XXXXXXXXXXXX4738",
"card_sub_type": "R",
"card_type": "debit_card",
"channel": "link",
"instrument_id": "0dca46b1-01f7-4a60-9e4a-ae5474603563",
"par": "V0010014623022637739353641436"
}
},
"payment_offers": [],
"payment_status": "SUCCESS",
"payment_surcharge": {
"payment_surcharge_service_charge": 0,
"payment_surcharge_service_tax": 0
},
"payment_time": "2025-09-01T15:40:58+05:30"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Payment session not found or has expired",
"help": "Verify the payment_session_id is correct and hasn't expired. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "payment_session_not_found",
"type": "invalid_request_error"
}{
"message": "Payment has already been processed for this session",
"help": "Each payment session can only be used once. Create a new order and payment session for additional transactions. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "payment_already_exists",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Apple Pay transaction declined by issuing bank",
"help": "The customer's bank declined the Apple Pay transaction. Advise customer to try a different payment method or contact their bank. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "bank_processing_failure",
"type": "api_error"
}Order Pay Authorise Only
Use this API when an order has already been created and you want Cashfree to process the payment for authorisation only. To use this API, the āAUTHORIZE_ONLYā flag must be enabled for your account. Submit Support Form to enable this feature.
POST
/
orders
/
sessions
/
authorize
curl --request POST \
--url https://sandbox.cashfree.com/pg/orders/sessions/authorize \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"payment_session_id": "session__CvcEmNKDkmERQrxnx39ibhJ3Ii034pjc8ZVxf3qcgEXCWlgDDlHRgz2XYZCqpajDQSXMMtCusPgOIxYP2LZx0-05p39gC2Vgmq1RAj--gcn",
"authorization_data": {
"authentication_token": "BwABBJQ1AgAAAAAgJDUCAAAAAAA=",
"directory_server_transaction_id": "8ac7b70f-9c5c-4e8f-9f4a-6d7c8b2a1e3f",
"three_ds_server_transaction_id": "9b8a7c6d-5e4f-3210-9876-543210fedcba",
"eci": "02",
"token_number": "4111111111111111",
"token_expiry_year": "2029",
"token_expiry_month": "09",
"token_cryptogram": "/wAAAAAAUSwFGXgAAAAAgPAAAA=",
"transaction_type": "TOKEN"
}
}
'
{
"auth_id": "302651",
"authorization": null,
"bank_reference": "524410198110",
"cf_payment_id": "4304193706",
"entity": "payment",
"error_details": null,
"international_payment": {
"international": false
},
"is_captured": false,
"order_amount": 1,
"order_currency": "INR",
"order_id": "CFPay_payme_rohittest_3vv0ethp9r",
"payment_amount": 1,
"payment_completion_time": "2025-09-01T15:42:38+05:30",
"payment_currency": "INR",
"payment_gateway_details": {
"gateway_name": "CASHFREE",
"gateway_order_id": "CF_ORDER_987654321",
"gateway_payment_id": "CF_PAY_123456789",
"gateway_order_reference_id": "REF_ORD_2025010112345",
"gateway_status_code": "SUCCESS",
"gateway_settlement": "cashfree",
"gateway_reference_name": "APPLE_PAY_TXN_REF"
},
"payment_group": "debit_card",
"payment_message": "PRE_AUTH|Transaction Success",
"payment_method": {
"card": {
"card_bank_name": "KOTAK MAHINDRA BANK",
"card_country": "IN",
"card_network": "visa",
"card_network_reference_id": "VIS_REF_20250101123456",
"card_number": "XXXXXXXXXXXX4738",
"card_sub_type": "R",
"card_type": "debit_card",
"channel": "link",
"instrument_id": "0dca46b1-01f7-4a60-9e4a-ae5474603563",
"par": "V0010014623022637739353641436"
}
},
"payment_offers": [],
"payment_status": "SUCCESS",
"payment_surcharge": {
"payment_surcharge_service_charge": 0,
"payment_surcharge_service_tax": 0
},
"payment_time": "2025-09-01T15:40:58+05:30"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Payment session not found or has expired",
"help": "Verify the payment_session_id is correct and hasn't expired. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "payment_session_not_found",
"type": "invalid_request_error"
}{
"message": "Payment has already been processed for this session",
"help": "Each payment session can only be used once. Create a new order and payment session for additional transactions. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "payment_already_exists",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Invalid Apple Pay cryptogram or missing required authorisation data",
"code": "invalid_request",
"type": "invalid_request_error"
}{
"message": "Apple Pay transaction declined by issuing bank",
"help": "The customer's bank declined the Apple Pay transaction. Advise customer to try a different payment method or contact their bank. Check latest errors and resolution from Merchant Dashboard API logs: https://bit.ly/4glEd0W Help Document: https://bit.ly/4eeZYO9",
"code": "bank_processing_failure",
"type": "api_error"
}Headers
API version to be used. Format is YYYY-MM-DD.
Request id for the API call. Can be used to resolve tech issues.
An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.
Body
application/json
Request parameters to authorise the payment transaction.
Unique identifier for the payment session, returned in the response of the Create Order API.
Example:
"session__CvcEmNKDkmERQrxnx39ibhJ3Ii034pjc8ZVxf3qcgEXCWlgDDlHRgz2XYZCqpajDQSXMMtCusPgOIxYP2LZx0-05p39gC2Vgmq1RAj--gcn"
3DS / token authorisation details.
Show child attributes
Show child attributes
Response
Success response for authorising the Apple Pay payment transaction.
Example:
"302651"
Additional authorisation object if available.
Example:
"524410198110"
Example:
"4304193706"
Example:
"payment"
Show child attributes
Show child attributes
Example:
false
Example:
1
Example:
"INR"
Example:
"CFPay_payme_rohittest_3vv0ethp9r"
Example:
1
Example:
"2025-09-01T15:42:38+05:30"
Example:
"INR"
Show child attributes
Show child attributes
Example:
"debit_card"
Example:
"PRE_AUTH|Transaction Success"
Show child attributes
Show child attributes
Example:
"SUCCESS"
Show child attributes
Show child attributes
Example:
"2025-09-01T15:40:58+05:30"
Was this page helpful?
āI