Skip to main content
POST
Submit Tier 1 verification

Overview

Submit Tier 1 identity verification (BVN + selfie) for a customer. This is required before creating permanent NGN funding accounts. The verification process matches the customer’s selfie against their BVN record to confirm identity.

Authentication

X-Api-Key
string
required
Your merchant API key

Path Parameters

id
string
required
Customer ID (UUID)Example: 650e8400-e29b-41d4-a716-446655440000

Request Body

bvn
string
required
11-digit Bank Verification NumberExample: 22345678901
Must be exactly 11 digits. The BVN is validated against the national identity database.
image_url
string
required
Face image for identity matching. Accepts an HTTPS URL to a jpg/png image, or base64-encoded image data up to 1 MiB decoded.Example: https://example.com/selfie.jpg
For base64, include the data URI prefix: data:image/jpeg;base64,/9j/4AAQ.... The decoded payload must not exceed 1 MiB.

Request Examples

Response

Returns the updated customer object. See Get customer for the full field list. On success, tier_1_kyc_complete flips to true.

Success Response

Error Responses

Next Steps

Create Funding Account

Create a permanent funding account for the verified customer

Get Customer

Check the customer’s current verification status