Skip to main content
POST
https://api.fossapay.com
/
v1
/
customers
/
kyc
/
bvn
Verify BVN
curl --request POST \
  --url https://api.fossapay.com/v1/customers/kyc/bvn \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "bvn": "<string>"
}
'
{
  "success": true,
  "message": "BVN verification completed successfully"
}

​
Headers

​
x-api-key
string
required
API Key for authentication

​
Request Body

​
customerId
string
required
Customer ID
​
bvn
string
required
Bank Verification Number (11 digits)

​
Request Example

curl -X POST https://api.fossapay.com/v1/customers/kyc/bvn \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123456789",
    "bvn": "12345678901"
  }'

const response = await fetch('https://api.fossapay.com/v1/customers/kyc/bvn', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'cust_123456789',
    bvn: '12345678901'
  })
});

​
Response

{
  "success": true,
  "message": "BVN verification completed successfully"
}

​
Error Responses

​
Notes

  • The BVN must be exactly 11 digits
  • BVN verification connects to the Nigerian banking system for validation
  • This endpoint triggers KYC level upgrade for the customer upon successful verification
  • The verification process typically completes within 5-10 seconds