Skip to main content
WEBHOOK
verificationNotification
{
  "businessCode": "<string>",
  "reference": "<string>",
  "type": "<string>",
  "businessCharge": 123,
  "statusCode": "<string>",
  "statusMessage": "<string>"
}

Authorizations

​
X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json

The data of a VERIFICATION_NOTIFICATION (a verification settled out of Pending).

​
businessCode
string
​
reference
string

Verification reference, e.g. VER-YYYYMMDD-xxxx.

​
type
string

Verification type code, e.g. BVN, NIN, CAC_ADVANCED.

​
status
enum<string>
Available options:
Completed,
Failed
​
businessCharge
number | null

Amount charged to you (naira); null if not charged.

​
statusCode
string | null
​
statusMessage
string | null

Response

200

Acknowledge receipt with 2xx.