POST
/
oauth2
/
session
Initiate OAuth
curl --request POST \
  --url https://sandbox.cashfree.com/verification/oauth2/session \
  --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 '{
  "user": {
    "identifier_type": "MOBILE",
    "identifier_value": "9988776655"
  },
  "verification_id": "test_verification_id"
}'
{
  "reference_id": 3123123,
  "verification_id": "123456",
  "user": [
    {
      "identifier_type": "MOBILE",
      "identifier_value": "9988123456"
    }
  ],
  "expiry": "2024-12-31T23:59:59Z",
  "session_id": "session_id_value"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your 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 initiate Oauth

The body is of type object.

Response

200
application/json

Initiate Oauth Response Body

The response is of type object.