Sign in

v1

latestOpenAPI 3.1.02026-07-24360204.4 KB

Name Verification - PAN vs Account Verification

Use this API to verify the PAN name with their existing Bank account name.

post/v1/kycs/name-match

Request body

typestring required

The inputs you want to use to compare the individual's name.<br><br>Accepted value: pan_vs_account_verification

pan_verification_idstring required

Unique identifier obtained when the applicant's PAN is digitally verified.<br><br>Use the <a href="https://developers.zwitch.io/reference/verifications-pan" target="_blank">PAN Verification API</a> to digitally verify the applicant's PAN.<br><br>Has to be 29 characters.<br><br>Example: pan_SYkpuiAbXC9ZHUmf2YuYFvGW1<br><br>Supported characters: <ul><li>A-Z</li><li>a-z</li><li>0-9</li></ul>

account_verification_idstring required

Unique identifier of the account verification request in the ZWITCH database.<br><br>Use our <a href="https://developers.zwitch.io/reference/verifications-bank-account-create" target="_block">Bank Account Verification API</a> to verify your applicant's account and get the unique identifier.<br><br>Has to be 32 characters.<br><br>Example: accver_T7tf1mHC4Cgd544uQhuoLNDd5<br><br>Supported characters: <ul><li>A-Z</li><li>a-z</li><li>0-9</li></ul>

minimum_match_scorenumber float required

The minimum acceptable match score set by you.<ul><li>Minimum value: 60</li><li>Maximum score: 100</li><li>Whole numbers only</li></ul>Example: 75

Response

200

idstring
typestring
objectstring
minimum_match_scorenumber
statusstring
name_as_per_panstring
pan_verification_idstring
account_verification_idstring
name_as_per_verificationstring
match_scorenumber
messagestring
review_neededboolean
created_atinteger
updated_atinteger
is_sandboxboolean

Example response

{
  "id": "nm_BbDMJHOVydaXraXQuSWPPquoZ",
  "type": "pan_vs_account_verification",
  "object": "name_match.pan_vs_account_verification",
  "minimum_match_score": 60.5,
  "status": "success",
  "name_as_per_pan": "Anil Reddy",
  "pan_verification_id": "pan_vTQ7sBPRAApHORmN5PfT3Uk3N",
  "account_verification_id": "accver_wIEhmszz13go8eiUSbYDZlBKu",
  "name_as_per_verification": "Anil Reddy",
  "match_score": 70.83,
  "message": "success",
  "metadata": {
    "key_1": "DD",
    "key_2": "XOF"
  },
  "created_at": 1704868805,
  "updated_at": 1704868805,
  "is_sandbox": true
}