Errors
Error format and what to do about each status code.
Errors return a JSON body with a type and a message you can show to your team (and usually to your customer).
json
{
"type": "order_error",
"message": "Enter a valid 11-digit Nigerian phone number"
}| Status | When | What to do |
|---|---|---|
400 | A field is missing or invalid. | Fix the request. Don't retry unchanged. |
401 | Missing or wrong API key. | Check the Authorization header. |
404 | The order or reference doesn't exist. | Check the ID or reference. |
409 | Receipt requested before delivery. | Wait until status is delivered. |
422 | Verification failed at the provider. | Ask the customer to check the number. |
502 | Temporary problem reaching a provider. | Retry with the same Idempotency-Key. |
503 | Purchases are paused for a few minutes. | Retry later with the same Idempotency-Key. |

