Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Payment Gateway endpoints

Use the following base URLs depending on whether you are testing or processing live payments.
EnvironmentBase URL
Testhttps://sandbox.cashfree.com/pg
Productionhttps://api.cashfree.com/pg
The latest API version is 2025-01-01 (v5). Previous versions were 2023-08-01, 2022-09-01, 2022-01-01, and 2021-05-21.

Authentication

All APIs require authentication except POST /orders/sessions, which does not require credentials and can be called directly from the browser. For authentication details for merchants and partners, see API authentication.

Payment gateway APIs

The following sections list all available APIs grouped by function.

Orders

Use these APIs to create and manage payment orders.
APIDescription
Create OrderUse this API to create orders with Cashfree from your backend and get the payment link.
Order PayUse this API when you have already created the orders and want Cashfree Payments to process the payment.
PreauthorisationUse this API to capture or void a preauthorised payment.
Get OrderUse this API to view all details of an order.

Authentication

Use this API to submit or resend an OTP during a payment flow.
APIDescription
Submit or Resend OTPUse this API to submit or resend an OTP to Cashfree during payment authentication.

Payments

Use these APIs to retrieve payment details for an order.
APIDescription
Get Payments for an OrderUse this API to view all payment details for an order.
Get Payment by IDUse this API to view payment details by payment ID.

Settlements

Use these APIs to fetch settlement details for individual orders or across a date range.
APIDescription
Get Settlements by Order IDUse this API to view all settlements for an order.
Get All SettlementsUse this API to get all settlement details by specifying the settlement ID, settlement UTR or date range.
Use these APIs to create, retrieve, and manage payment links.
APIDescription
Create Payment LinkUse this API to create a new payment link. The URL is returned in the link_url parameter of the response.
Fetch Payment Link DetailsUse this API to view all details and status of a payment link.
Get Orders for a Payment LinkUse this API to view all order details for a payment link.
Cancel Payment LinkUse this API to cancel a payment link. No further payments can be done against a cancelled link. Only a link in ACTIVE status can be cancelled.

Token vault

Use these APIs to manage saved payment instruments for a customer.
APIDescription
Fetch All Saved InstrumentsUse this API to get all saved instruments for a customer ID.
Fetch Single Saved InstrumentUse this API to get a specific saved instrument for a customer ID and instrument ID.
Delete Saved InstrumentUse this API to delete a saved instrument for a customer ID and instrument ID.
Fetch Cryptogram for Saved InstrumentUse this API to get the card network token, token expiry and cryptogram for a saved instrument using instrument ID.

Reconciliation

Use these APIs to fetch reconciliation reports for settlements and payment gateway transactions.
APIDescription
Settlement ReconciliationUse this API to get settlement reconciliation details using a settlement ID, settlement UTR, or date range.
PG ReconciliationUse this API to get the payment gateway reconciliation details with date range.