Error Messages
The API reports failures as human-readable messages. There are no numeric or string error codes to branch on, so match on the message text.
Every message the /api/v6/external/payin and /api/v6/external/payout endpoints can return is
listed below, reproduced exactly as it is delivered. Some arrive wrapped in square brackets —
[ERROR: ...] — some start with Error:, and some arrive bare. Every form is kept as it is sent, so
a message copied out of your logs matches what is on this page. The messages are grouped by
endpoint: payin only, payout only, and both.
Reading the list
The messages carry the notation the API uses:
{fieldName}is the name of the field the message is about, written as the API writes it.X,N,{X}and<uuid>stand for a name or value the API fills in when it sends the message.
Payin
| Message |
|---|
[ERROR: {amount} may not be null.] |
IP Address is empty or null |
Country value is empty |
Currency value is empty |
Callback url is empty |
Return url is empty |
Method could not be null |
[ERROR: There are no available Mids found for the Bank code {X} Please contact your Account Manager.] |
MID Setup Incomplete. Contact Customer Support |
Invalid Channel & MID Settings. Contact Support |
Current bank disabled for this mid |
Payout
| Message |
|---|
[ERROR: Hash value is incorrect] |
[ERROR: {country} may not be be null or empty.] |
[ERROR: {amount} may not be null or empty.] |
[Error: {midId} parameter must be a valid midId] |
[ERROR: {ipAddress} may not be null or empty.] |
[ERROR: {currency} may not be null or empty.] |
[ERROR: {account} may not be be null or empty.] |
[ERROR: MidId or Payment method must be specified.] |
[ERROR: Suitable Mid not found] |
Payout was already created under the same transaction ID: X |
Payout has already been created under the same external transaction ID |
Error: Customer email is empty |
Error: Customer is blacklisted. Please contact our customer support. |
Current bank disabled for payouts |
Insufficient Payout Balance |
Min amount is X |
Max amount is X |
[ERROR: {data.name} must be 1-150 characters and may not be null or empty] |
[ERROR: {data.lastname} must be 1-150 characters and may not be null or empty] |
[ERROR: {data.accountnumber} must be 9-19 characters and may not be null or empty.] |
[ERROR: {data.accountname} must not be null or empty.] |
[ERROR: {data.bankname} must not be null or empty.] |
[ERROR: {data.bankaddress} must not be null or empty.] |
[ERROR: {data.ifsc} must be 11 characters and may not be null or empty.] |
[ERROR: {data.bankcode} must be 4 length and may not be null or empty.] |
[ERROR: {data.mobile} must be 8-15 length and may not be null or empty.] |
[ERROR: invalid {mobile} format.] |
[ERROR: invalid {ifsc} format.] |
[ERROR: {data.bsb} must be 6 characters and may not be null or empty.] |
Payin and Payout
| Message |
|---|
Error: The IP not whitelisted |
[Error: {X} parameter must be valid]. Please request a X from your account manager. |
Unexpected error occurred: <uuid>. Please contact support team. |
Order ID is empty |
[ERROR: {orderId} must be 1-50 characters.] |
[ERROR: invalid {email} format.] |
Error: Fraud User Detected. Contact Support. |
[ERROR: Attempt blocked due to too many failed attempts from this user or IP. Please contact Administrator] |
[ERROR: {amount} must be a positive value.] |
[ERROR: No MID with given ID found, ID: N] |
[ERROR: Cascading for payment method X is missing. Please contact your Account Manager.] |
[ERROR: Cascading for country X is missing] |
[ERROR: No MID found for target country X] |
[ERROR: All mids are currently down for country X. Please contact our CS Team immediately] |
[ERROR: There are no available Mids found for the requested amount. Please contact your Account Manager.] |
Inconsistency between Mid Currency and requested Currency. Please contact Support |
Mid not found! |
Payment not supported |