Errors

The error object
Key
Value
Description
code
string
A code representing the error (see available values below).
key
string
A key representing the error (see available values below).
message
string
Translated message.
Example
{
    "error": {
        "code": "200",
        "key": "recipient_not_found",
        "message": "Recipient not found"
    }
}
Error codes
Code
Key
Translated error
Reason
100
merchant_not_found
Merchant account not found
The token sent in the Basic Auth header is incorrect.
101
merchant_account_locked
Merchant account inactive
This merchant account is inactive.
102
merchant_signature_incorrect
Incorrect signature
The data sent to the API was incorrectly signed.
200
recipient_not_found
Recipient not found
No user was found for the phone number of username sent with the payment request.
201
merchant_cannot_be_recipient
Merchant cannot be recipient
A merchant account cannot receive a payment request.
300
payment_not_found
Payment request not found
A payment request with this ID cannot be found.
301
payment_exceeds_limits
Payment request exeeds limits
The payment request is not allowed since it exeeds the allowed limit.
400
invalid_data
Invalid data
The JSON data sent to the API is either corrupt or malformed.
500
system_error
System error - Try again later
Something went wrong on the server side.

Authentication

Payment Requests

Last updated 9 months ago

Key	Value	Description
code	string	A code representing the error (see available values below).
key	string	A key representing the error (see available values below).
message	string	Translated message.

Code	Key	Translated error	Reason
100	merchant_not_found	Merchant account not found	The token sent in the Basic Auth header is incorrect.
101	merchant_account_locked	Merchant account inactive	This merchant account is inactive.
102	merchant_signature_incorrect	Incorrect signature	The data sent to the API was incorrectly signed.
200	recipient_not_found	Recipient not found	No user was found for the phone number of username sent with the payment request.
201	merchant_cannot_be_recipient	Merchant cannot be recipient	A merchant account cannot receive a payment request.
300	payment_not_found	Payment request not found	A payment request with this ID cannot be found.
301	payment_exceeds_limits	Payment request exeeds limits	The payment request is not allowed since it exeeds the allowed limit.
400	invalid_data	Invalid data	The JSON data sent to the API is either corrupt or malformed.
500	system_error	System error - Try again later	Something went wrong on the server side.