Products

Identity checks

Check a Nigerian BVN or NIN against the details a person gave you.

Identity checks is switched on by request. Ask from Settings › Products and access; once approved it works in test and live mode. Until then the API answers 403 with the code shown below.

curl https://api.paygenthq.ai/v1/identity/checks \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" \
  -d '{ "type": "bvn", "number": "22222222222", "consent": true,
        "first_name": "Ada", "last_name": "Okafor", "date_of_birth": "1990-04-12" }'

consent: true is required: it says the person agreed. The answer has the record's details and match: whether the name and date of birth you sent are right. We keep no ID numbers or personal details: only that a check was made, its result and your reference. Each live check is charged from your balance. Not switched on: 403 identity_not_enabled.