Bank Account Verification in Cameroon
Verify a Cameroonian mobile-money account and retrieve the account holder's name before initiating a transfer.
Cameroon account verification routes through the mobile-money operator's network. Most accounts in the Cameroonian market are held with MTN Mobile Money.
Prerequisites
You'll need an API key. See Quickstart or Authentication if you don't have one yet.
Note: Verification endpoints use an API key in the
X-API-Keyheader β not a Bearer token.
Make the verification request
curl -X POST https://api.lira.com/api/v1/verify/account \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"accountNumber": "6000000001",
"country": "CM",
"bankCode": "MTN"
}'
Request body fields
| Field | Type | Required | Description |
|---|---|---|---|
accountNumber |
string | Yes | The mobile-money account number (wallet identifier) to verify. |
country |
string | Yes | Always CM. |
bankCode |
string | Yes | The mobile-money operator code. See the supported operators table below. |
Note:
mode: "async"is not supported for Cameroon in v1. All CM verifications are synchronous.
Supported operators
bankCode |
Institution |
|---|---|
MTN |
MTN Mobile Money |
Read the result
Successful verification
{
"id": "a1b2c3d4-...-...-...-...",
"status": "success",
"verificationType": "ACCOUNT_NUMBER",
"identifier": "6000000001",
"country": "CM",
"verifiedAt": "2026-04-24T10:05:00.000Z",
"verified": true,
"accountNumber": "6000000001",
"accountName": "Test Nkomo",
"bankCode": "MTN"
}
Failed verification
{
"id": "a1b2c3d4-...-...-...-...",
"status": "failed",
"verificationType": "ACCOUNT_NUMBER",
"identifier": "6000000001",
"country": "CM",
"verifiedAt": "2026-04-24T10:05:00.000Z",
"verified": false,
"error": {
"code": "ACCOUNT_NOT_FOUND",
"message": "No account found for the provided details"
}
}
Note: A
200 OKHTTP response does not mean the verification succeeded. Always check thestatusfield.
Error handling
error.code |
Cause | Action |
|---|---|---|
ACCOUNT_NOT_FOUND |
Account number not found at the specified operator | Ask the user to check their wallet number and operator |
INVALID_BANK_CODE |
Operator code not recognised | Check the bankCode against the supported operators table |
INVALID_ACCOUNT_NUMBER |
Account number format is invalid | Validate format before submitting |
PROVIDER_ERROR |
Upstream system returned an error | Retry with exponential backoff |
PROVIDER_TIMEOUT |
Upstream system timed out | Retry β transient error |
For the full error code reference, see Errors.
Next steps
- Phone Number in Cameroon β verify Cameroonian mobile-money subscribers
- Bank Account Overview β general bank account verification guide
- Errors β complete error code reference
