Skip to main content
POST
/
oauth2
/
generate-token
OAuth Access Token Generation
curl --request POST \
  --url https://sandbox.cashfree.com/verification/oauth2/generate-token \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "auth_code": "auth_code_value"
}
'
{ "reference_id": 123456, "verification_id": "test_verification_id", "expiry": "2024-12-31T23:59:59Z", "access_token": "access_token_value" }

Documentation Index

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

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

Authorizations

​
x-client-id
string
header
required

Client ID. You can find your ID in the Merchant Dashboard.

​
x-client-secret
string
header
required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

​
x-api-version
string
required

API version to be used. Format is in YYYY-MM-DD

Body

application/json

Find the request parameters to Access Token Generation

​
auth_code
string
required

This is the authcode for generating the access token. The SDK sends the callback using the redirect URL provided in the Merchant Dashboard while creating the app. The authcode will be included in the callback sent to the redirect URL.

Example:

"auth_code_value"

Response

Access Token Generation Response Body

​
verification_id
string

It displays the unique ID you created to identify the verification request in initiate OAuth request.

Example:

"test_verification_id"

​
reference_id
integer

It displays the unique ID created by Cashfree Payments for reference purposes. format: int64

Example:

123

​
expiry
string

The expiration date and time for the access token, in UTC format. Format - YYYY-MM-DDTHH:mm:ssZ.

Example:

"2024-12-31T23:59:59Z"

​
access_token
string

It displays the the access token value. Use this access token to get the user details in fetch user details API.

Example:

"access_token_value"