Skip to main content
POST
/
form
Generate KYC Link
curl --request POST \
  --url https://sandbox.cashfree.com/verification/form \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "name": "John Doe",
  "phone": "9999999999",
  "email": "test@cashfree.com",
  "template_name": "Aadhaar_verification",
  "link_expiry": "2025-06-01",
  "notification_types": [
    "sms"
  ],
  "verification_id": "ABC00123"
}'
{
  "name": "John Doe",
  "phone": "9999999999",
  "email": "test@cashfree.com",
  "verification_id": "ABC00123",
  "reference_id": 235461,
  "form_link": "https://forms-test.cashfree.com/verification/Y7tpcan5ksm0",
  "form_status": "RECEIVED"
}

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-cf-signature
string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters for Generate KYC Link.

ā€‹
phone
string
required

It is the phone number of the individual.

Example:

"9999999999"

ā€‹
template_name
string
required

It is the name of the template you created using the merchant dashboard. You can also use the default template found there to generate the verification form. The default template is Aadhaar_verification. Using merchant dashboard, customized KYC Link templates can be created.

Example:

"Aadhaar_verification"

ā€‹
verification_id
string
required

It is the unique ID you created to identify the KYC link.

Example:

"ABC00123"

ā€‹
name
string

It is the name of the individual.

Example:

"John Doe"

ā€‹
email
string

It is the email address of the individual.

Example:

"test@cashfree.com"

ā€‹
link_expiry
string

It is the expiry date of the link. Its value can be max 30 days from the current date.

Example:

"2025-06-01"

ā€‹
notification_types
string[]

It is the type(s) of notification used for sending the link.

SMS string

Response

Response Body for Generate KYC Link API

ā€‹
name
string

It displays the name of the individual.

Example:

"John Doe"

ā€‹
phone
string

It displays the phone number of the individual.

Example:

"9999999999"

ā€‹
email
string

It displays the email address of the individual.

Example:

"test@cashfree.com"

ā€‹
verification_id
string

It displays the unique ID you created to identity the form.

Example:

"ABC00123"

ā€‹
reference_id
integer

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

Example:

235461

ā€‹
form_link
string

It displays the URL of the KYC Link.

Example:

"https://forms-test.cashfree.com/verification/Y7tpcan5ksm0"

ā€‹
form_status
string

It displays the status of the form.

Example:

"RECEIVED"