post https://sandbox.cashfree.com/verification/verification/oauth2/session
Use this API to initiate the OAuth process by providing necessary credentials and obtaining the authorization URL to proceed with authentication.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | - | Initiate SDK using session ID. |
| 400 | ERROR | verification_id is missing in the request. | Enter a valid verification_id in the request. |
| 400 | ERROR | verification_id can include only alphanumeric, dot, hyphen, and underscores. | Ensure verification_id meets the character requirements. |
| 400 | ERROR | verification_id can include a maximum of 50 characters. | Limit verification_id to 50 characters. |
| 400 | ERROR | identifier_type is missing in the request. | Include the identifier_type parameter in the request. |
| 400 | ERROR | identifier_value is missing in the request. | Provide the identifier_value parameter in the request. |
| 400 | ERROR | identifier_type should be valid. | Use a valid identifier_type. |
| 400 | ERROR | identifier_value should be valid. | Use a valid identifier_value. |
| 400 | ERROR | x-client-id is missing in the request. | Include the x-client-id in the request headers. |
| 400 | ERROR | x-client-secret is missing in the request. | Include the x-client-secret in the request headers. |
| 401 | ERROR | Invalid clientId and clientSecret combination. | Ensure the clientId and clientSecret are correct. |
| 409 | ERROR | verification id already exists. | Provide a unique verification_id. |
| 422 | ERROR | Insufficient balance to process this request. | Retry after ensuring sufficient balance. |
| 500 | ERROR | something went wrong | Retry the request after some time. |