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.