Skip to content

Identity

Validate and resolve identity information — IBANs, phone numbers and account ownership.

POSThttps://api.wajub.com/identity/validate

The Identity API lets you validate bank identifiers (IBAN) and resolve phone numbers to their operator before processing a payment or transfer.

private key required

Identity endpoints require a private key (sk.…). Public keys do not have access.

Key endpoints

MethodEndpointDescription
POST/identity/validateValidate an IBAN (ISO 13616 mod-97 check)
POST/identity/resolveResolve a mobile number to its operator (sandbox)

Validate an IBAN

POSThttps://api.wajub.com/identity/validate
Request
curl https://api.wajub.com/identity/validate \
-H "Authorization: sk.xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
  "iban": "FR1420041010050500013M02606"
}'
Response · 200 OK
Response
{
"status": "OK",
"code": 200,
"valid": true,
"details": {
  "country": "FR",
  "bank_code": "20041",
  "account_number": "0500013M026"
}
}

Resolve a phone number (sandbox)

POSThttps://api.wajub.com/identity/resolve
Request
curl https://api.wajub.com/identity/resolve \
-H "Authorization: sk.xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
  "phone": "+237670000000"
}'
Response · 200 OK
Response
{
"status": "OK",
"code": 200,
"country": "CM",
"operator": "mtn"
}

Was this page helpful?