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-Key header β€” 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 OK HTTP response does not mean the verification succeeded. Always check the status field.


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