Paired NIN+BVN identity verification
POST/v1/kyc/identity/verify-paired
Looks up both NIN and BVN, then cross-checks the holder names. On match, awards EventNINLookup (+10) once. Mismatch returns 200 with names_match=false and mismatched_fields populated; no score is awarded. Failed lookup at either provider returns 400.
If the provider does not have direct NIN/BVN lookup provisioned for the account, the response is 200 with names_match=false and widget_fallback populated; the client should launch the hosted verification widget directly using those credentials instead of treating it as a failure.
Request
Responses
- 200
- 400
- 401
Both lookups succeeded; names_match indicates whether names matched
bad_request: Invalid input
unauthorized: Unauthorized