Verify

curl --request POST \
  --url https://sandbox.cashfree.com/verification/document/pan \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --form verification_id=12345678 \
  --form front_image=FRONT_IMAGE

{
  "name": "JOHN DOE",
  "dob": "03/06/1993",
  "father": "JOSH DOE",
  "pan_type": "Individual",
  "pan": "AUHPJ0671P",
  "valid": true,
  "age": "29",
  "status": "VALID",
  "reference_id": "106",
  "verification_id": "76",
  "message": "PAN card is valid"
}

Verify

Use this PAN Verification via OCR API to verify and validate the PAN information quickly. Provide the front image of PAN and a verification ID. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Response Codes

Sub Code	Status	Message	Next Action
200	SUCCESS	PAN card is valid	-
200	SUCCESS	PAN card is Invalid	Upload a valid PAN card copy.
400	ERROR	File size exceeded 10MB limit	The max file size of the file is 10MB.
400	ERROR	please upload the file of valid format(jpeg/jpg/png)	Allowed file type - JPEG/JPG/PNG.
400	ERROR	verification_id is missing in the request.	Enter a unique verification ID in the request.
400	ERROR	Front Image File is missing	Upload the copy of the PAN card in the front_image parameter.
400	ERROR	verification_id can include a maximum of 50 characters.	The maximum character limit is 50.
400	ERROR	verification_id can include only alphanum, dot, hyphen and underscores.	Only alphanumeric, period (.), hyphen (-), and underscore ( Â ) are allowed.
400	ERROR	Client secret belongs to test environment	Enter the correct environment credentials in the request.
400	ERROR	x-client-id is missing in the request	Enter all the header information in the API request.
401	ERROR	Invalid clientId and clientSecret combination	Enter valid client ID and secret key in the request.
403	ERROR	IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://www.cashfree.com/docs/secure-id/get-started/integration/ip-whitelisting-verification	Whitelist the IP address.
422	ERROR	Insufficient balance to process this request.	Ensure you have sufficient balance and then process the request.
500	ERROR	Unable to validate, please retry later	Try again after some time.

POST

document

pan

Verify

curl --request POST \
  --url https://sandbox.cashfree.com/verification/document/pan \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --form verification_id=12345678 \
  --form front_image=FRONT_IMAGE

{
  "name": "JOHN DOE",
  "dob": "03/06/1993",
  "father": "JOSH DOE",
  "pan_type": "Individual",
  "pan": "AUHPJ0671P",
  "valid": true,
  "age": "29",
  "status": "VALID",
  "reference_id": "106",
  "verification_id": "76",
  "message": "PAN card is valid"
}

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

It is the API version. To receive the aadhaar seeding status in the response, use any date after 2022-09-12

x-cf-signature

string

Send the signature if IP is not whitelisted

Body

multipart/form-data

Find the request parameters to verify and validate the PAN information

Find the request parameters to verify PAN via OCR

Response

200

application/json

Success response for verifiying the PAN information

PAN Verification via OCR success response

Secure ID APIs

V2

V1

Verify

Response Codes

Authorizations

Headers

Body

Response