Skip to navigation
Customer Onboarding

Create a customer on your partner book

View as Markdown

The PAN is established ONE of two ways:

  • Liquify verified it — send verification_id from POST /v1/pan-verifications.
  • You verified it — send pan_verified: true with name_as_per_pan, dob and gender exactly as the PAN record states them. Individual (fourth character P), adult PANs only. If Liquify already holds a verification of this PAN, Liquify’s record wins and dob must equal it.

consent must grant KYC_PAN. Retrying a create that succeeded answers the same customer_id with created: false.

Authentication

AuthorizationBearer

The token Liquify issued your organisation. Shown once; rotate it from Liquify if it is exposed.

Request

This endpoint expects an object.
mobilestringRequiredformat: "^[6-9][0-9]{9}$"
Ten digits, no country code.
panstringRequiredformat: "^[A-Za-z]{5}[0-9]{4}[A-Za-z]$"
consentobjectRequired
verification_idstringOptional<=64 characters

From POST /v1/pan-verifications.

pan_verifiedbooleanOptional

true when you verified the PAN yourself.

name_as_per_panstringOptional<=120 characters

With pan_verified. As the PAN record states it; letters, spaces, ., ' and -.

dobdateOptional

With pan_verified. 18 or over.

genderenumOptional

With pan_verified.

Allowed values:

Response

The customer — new, or the one this PAN and mobile already are.

dataobject
metaobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
503
Service Unavailable Error