Bank Account Verification in Senegal
Verify a Senegalese mobile-money account and retrieve the account holder's name before initiating a transfer.
Senegal account verification routes through the mobile-money operator's network. Most accounts in the Senegalese market are held with Orange 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": "5000000001",
"country": "SN",
"bankCode": "ORANGE"
}'
Request body fields
| Field | Type | Required | Description |
|---|---|---|---|
accountNumber |
string | Yes | The mobile-money account number (wallet identifier) to verify. |
country |
string | Yes | Always SN. |
bankCode |
string | Yes | The mobile-money operator code. See the supported operators table below. |
Note:
mode: "async"is not supported for Senegal in v1. All SN verifications are synchronous.
Supported operators
bankCode |
Institution |
|---|---|
ORANGE |
Orange Money |
Read the result
Successful verification
{
"id": "a1b2c3d4-...-...-...-...",
"status": "success",
"verificationType": "ACCOUNT_NUMBER",
"identifier": "5000000001",
"country": "SN",
"verifiedAt": "2026-04-24T10:05:00.000Z",
"verified": true,
"accountNumber": "5000000001",
"accountName": "Sandbox Diop",
"bankCode": "ORANGE"
}
Failed verification
{
"id": "a1b2c3d4-...-...-...-...",
"status": "failed",
"verificationType": "ACCOUNT_NUMBER",
"identifier": "5000000001",
"country": "SN",
"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 Senegal β verify Senegalese mobile-money subscribers
- Bank Account Overview β general bank account verification guide
- Errors β complete error code reference
