❗Errors

All the messages listed below are returned in responses with the field code: 400

Payment system data is not valid

The data in the data parameter is invalid, or the field is missing. Our client either does not send the data parameter in the request or sends incorrect data in this parameter.

How can you resolve it by yourself? Using the deposit creation as an example:

Link -> Data -> one of PS, for example, M-Pesa.

You must send for the mpesa payment system a cell phone number

If you do send a number, please note that it must be a 12-digit number. This is specified in string [12..12]

Example

Your request for deposit creation

{
  "amount": 10,
  "currency": "INR",
  "payment_system": "mpesa",
  "custom_transaction_id": "custom123",
  "custom_user_id": "user123",
  "data": {
  }
}

Right request

{
  "amount": 10,
  "currency": "INR",
  "payment_system": "mpesa",
  "custom_transaction_id": "custom123",
  "custom_user_id": "user123",
  "data": {
    "phone_number": "254712345678"
  }
}

Note that the number must be a 12-digit number.

If the payment system is different, the data will be different.

Required field missing

The required fields are missing. Our client missed a mandatory field in the request (such fields are marked as required in the documentation).

How can you resolve it by yourself? Using the deposit creation as an example:

Link -> See which fields are mandatory in the request

Example

Your request:

{
  "amount": 10,
  "payment_system": "mpesa",
  "custom_transaction_id": "custom123",
  "custom_user_id": "user123",
  "data": {
    "phone_number": "254712345678"
  }
}

Right request:

{
  "amount": 10,
  "currency": "INR",
  "payment_system": "mpesa",
  "custom_transaction_id": "custom123",
  "custom_user_id": "user123",
  "data": {
    "phone_number": "254712345678"
  }
}

Our client forgot to specify the currency of deposit creation in the request.

No payment system found with such params or payment system is disabled

The error tells us that:

1. The data in the request is not valid

2. The specified PS is not connected or enabled for the project

3. The PS does not support the specified currency

4. The request is beyond the limits of the payment system

How can you resolve it by yourself?

1. You should look at the request and compare the currency in the request with the data in our documentation

2. Check the payment system and its limits by this method.

3. If your payment system is enabled and the amount is within limits, but the error still persists, contact us via your client chat.

Amount of deposit is out of limits

The error tells us that the requested amount exceeded the limits of the payment system

How can you resolve it by yourself?

Check the payment system and its limits with this method.

Amount of withdrawal is more than balance sum

The amount of withdrawal is more than there is on the balance. This error occurs only when creating a withdrawal request.

In this case, our client needs to top up the account and write to our financier

Transaction failed

Contact our support team via your client chat to resolve this issue

There are no active end accounts

Contact our support team via your client chat to resolve this issue

If you don't find the error here, send the full request body and error text to your customer chat, and our support will help you out ASAP.