Errors

Explore our error messages for different scenarios. See the full list of messages here.

When working with our API, you'll encounter five main kinds of errors: authorization errors, validation errors, server errors, Flutterwave errors, and provider errors. Each type of error comes with an appropriate HTTP status code.

All errors share the same basic response format: a status key set to "error", and a message describing the error. There may also be a data object containing more details, for example:

{
    "status": "error",
    "message": "merchant secret key required",
    "data": null
}

Payment errors

Payment errors usually arise when your transaction request doesn't pass compliance checks or encounters processing issues. Explore our error messages:

Validation errors

Validation errors are returned when your request fails one or more validation rules. Examples include not passing required parameters. They come with a 400 Bad Request status code:

{
    "status": "error",
    "message": "Cardno is required",
    "data": null
}

Authorization errors

You'll get authorization errors when you don't provide your secret key to authorize an API call, or when the key provided isn't correct. They come with a 401 Unauthorized status code:

{
    "status": "error",
    "message": "Authorization required",
    "data": null
}

Server errors

Server errors occur when something goes wrong on our end. In such a case, you should retry after a while, or reach out to our support. They come with a 500 Internal Server Error status code.

{
  "error_id": "ERRNO796977608T1620310828419",
  "message": "Application error. Please contact support",
  "code": "app_error"
}

Next steps

Error handling is a recommended best practice for enhancing user experience in your application. Explore other best practices here.

Loading...