🔴 Errors & Support
Errors & Support
Complete error code reference and support contacts for NDAPI integration help.
Error Codes
All errors return a consistent JSON structure with an error field describing what went wrong.
Error Response Structure
{
"error": "Insufficient balance. Available: ₦45,000 | Required: ₦50,050"
}
HTTP Status Codes
| Status | Meaning | Common Causes |
|---|---|---|
| 400 | Bad Request | Missing required parameters, invalid values, insufficient balance. |
| 401 | Unauthorized | Missing or invalid API key, suspended account. |
| 404 | Not Found | Endpoint URL is incorrect. |
| 409 | Conflict | Duplicate reference — this request was already processed. |
| 500 | Server Error | Internal error. Retry after a few seconds. Contact support if persistent. |
Common Error Messages
| Error Message | Resolution |
|---|---|
| Invalid API key | Check your key is correct and starts with NDAPI-TEST- or NDAPI-LIVE- |
| Insufficient balance | Top up your operator balance before initiating the transfer |
| Duplicate reference | Use a unique reference for each transfer request |
| amount_ngn, account_number, bank_code, reference required | All four fields are mandatory for transfer requests |
| Operator account suspended | Contact ndapi.admin@nolubz.com immediately |