API Reference

2.12 Errors

API error's are returned with the following schema.

{
    "code": "The error code",
    "message": "The error message"
}
CodeStatus CodeDescription
PaymentValidationError400On Submit Payment. There is an issue with the request payload. Details of the error will be available in the message field.
PaymentExpired400On Approve or Deny. The payment request has expired.
PaymentInvalidState400The payment is in an invalid state for the requested operation.
AuthenticationError401There was an authentication error with the given apiKey and signature combination. Details of the error will be available in the message field.
PaymentNotFound404The payment with the given id does not exist.
CollectionNotFoundError404The collection with the given id does not exist.
InvalidPhoneNumberFormat400Phone number in recipient / sender / source info not in international format (+234XXXXXXXXXX)
ResolveAccountError400There was an error resolving account number, no match for the provided bank account number on selected bank.
PermissionError403The Api Key doesn't have required permission to access the resource / endpoint.
InternalServerError500An unknown error occurred. Support should be contacted for investigation.