response_code is 01, the response_text field contains a sub-code in the form Echec (CodeXX). This sub-code is specific to the endpoint you called. This page lists every possible sub-code for each endpoint.
createInvoice
Endpoint:POST /pay/v01/redirect/checkout-invoice/create and POST /pay/v01/straight/checkout-invoice/create
Wiki: https://client.ligdicash.com/wiki/createInvoice
| Sub-code | Description | Recommended action |
|---|---|---|
Echec (Code00) | Authentification failure | Check Apikey and Authorization: Bearer |
Echec (Code01) | Merchant Payin not activated | Contact LigdiCash support to enable payin |
Echec (Code02) | Wrong amount (must be between 9 and 2,000,000) | Fix the amount — integer between 9 and 2,000,000 CFA francs |
Echec (Code03) | IP Denied | The server’s IP is not whitelisted — contact technical support to whitelist your IP |
Echec (Code04) | An error occurred while processing request | Internal LigdiCash error — retry |
Echec (Code05) | An error occurred while sending request | Error sending to the operator — retry |
Echec (Code06) | An error occurred while sending request | Error sending to the operator — retry |
Echec (Code07) | No network access configured | The matching operator is not configured for this project — contact LigdiCash |
Echec (Code08) | Data Input error | Malformed payload — check all required fields |
Echec (Code09) | Api error | Internal API error — contact support |
Echec (Code10) | No hash provided | Hash missing from the request — check header construction |
Echec (Code11) | Invalid hash | Invalid hash — check request signature |
Echec (Code12) | Invalid method | Wrong HTTP method |
Echec (Code13) | Unauthorized method | Method not allowed for this project |
Echec (Code14) | Wrong Wallet Credentials | Wrong wallet credentials |
Echec (Code15) | Wrong OTP | Wrong OTP — ask the customer to regenerate and re-enter it |
Echec (Code16) | Expired OTP | Expired OTP — create a new transaction and restart the OTP flow |
Echec (Code17) | Wrong OTP Amount | OTP amount does not match the transaction amount |
Echec (Code18) | Wallet low balance | LigdiCash wallet balance is too low |
confirmInvoice
Endpoint:GET /pay/v01/redirect/checkout-invoice/confirm and POST /pay/v01/withdrawal/confirm
Wiki: https://client.ligdicash.com/wiki/confirmInvoice
| Sub-code | Description | Recommended action |
|---|---|---|
Echec (Code00) | Authentification failure | Check Apikey and Authorization: Bearer |
Echec (Code01) | Merchant Payin not activated | Contact LigdiCash support |
Echec (Code02) | Invoice not found | The token passed is invalid or belongs to a different project — use the token stored at creation, not the one from the callback |
Echec (Code03) | An error occurred while processing request | Internal error — retry |
Echec (Code04) | Data Input error | Missing or malformed parameter in the confirm request |
createWithdrawal
Endpoint:POST /pay/v01/withdrawal/create (payout to LigdiCash wallet)
Wiki: https://client.ligdicash.com/wiki/createWithdrawal
| Sub-code | Description | Recommended action |
|---|---|---|
Echec (Code00) | Authentification failure | Check Apikey and Authorization: Bearer |
Echec (Code01) | Merchant Payout not activated | Contact LigdiCash support to enable payout |
Echec (Code02) | Customer not registered on the platform | The customer (phone number) does not have a LigdiCash account |
Echec (Code03) | No merchant account on the specified network | No merchant account configured for this operator |
Echec (Code03a) | Pending/Processed payout within the last 24 hours | A payout to this customer was already initiated in the last 24 hours |
Echec (Code03b) | No deposit within the last 3 months | The customer has not made a deposit in the last 3 months |
Echec (Code04) | Merchant balance low | Merchant account balance too low — top it up |
Echec (Code05) | Request amount out of range [9;2,000,000] | Fix the amount |
Echec (Code06) | IP denied | IP not whitelisted — contact technical support to whitelist your IP |
Echec (Code07) | Transaction_id already exists | This transaction_id has already been used — generate a new unique identifier |
Echec (Code08) | An error occurred while processing | Internal error — retry |
Echec (Code09) | Data Input error | Malformed payload — check all fields |
Echec (Code10) | Api error | Internal API error — contact support |
Echec (Code11) | No hash provided | Hash missing |
Echec (Code12) | Invalid hash | Invalid hash |
Echec (Code13) | App Marah/Agrivoucher not identified | Partner application Marah/Agrivoucher not identified |
Echec (Code07) — Transaction_id already exists confirms the importance of the transaction_id pattern: every call must carry a unique identifier, including retries. See transaction_id pattern.createStraightWithdrawal
Endpoint:POST /pay/v01/straight/payout (direct payout to mobile money)
Wiki: https://client.ligdicash.com/wiki/createStraightWithdrawal
| Sub-code | Description | Recommended action |
|---|---|---|
Echec (Code00) | Token Authentification error | Check the Bearer authorization token |
Echec (Code01) | Application Authentification error | Check the project’s Apikey |
Echec (Code02) | Request amount out of range [9;2,000,000] | Fix the amount |
Echec (Code05) | Recipient operator not identified | The recipient’s operator could not be identified from the phone number |
Echec (Code06) | Merchant operator account not identified | No merchant account found for this operator |
Echec (Code07) | Merchant operator account not identified | No merchant account found for this operator |
Echec (Code08) | Merchant operator account low balance | Merchant operator account balance too low |
Echec (Code09) | An error occurred while processing request | Internal error — retry |
Echec (Code10) | Api error | Internal API error — contact support |
Echec (Code11) | No hash provided | Hash missing |
Echec (Code12) | Invalid hash | Invalid hash |
Echec (Code13) | Unauthorized currency conversion | Currency conversion not allowed |
Echec (Code14) | IP denied | IP not whitelisted — contact technical support to whitelist your IP |
Echec (Code15) | App Marah/Agrivoucher not identified | Partner application Marah/Agrivoucher not identified |
Related pages
- The wiki field — read sub-codes dynamically from the API response
- Common errors — causes and solutions by error type
- Overview — the two error levels