API Codes
Learn about the API Codes returned by our APIs

Deposits Status Codes

These are the codes returned by the WEBSTATUS API.
Code
Status
Description
6
NA
The deposit was not found.
7
The deposit is created with all the information required and it is awaiting on customer's payment.
8
The deposit has been cancelled by the customer or it has been 7 days after the expiration.
9
The deposit has been completed and the money was credited to your account.
Use the Deposit Status Endpoint to retrieve the status of a deposit.

Refund Status Codes

These are the codes returned by the Refund Status API.
Code
Status
Description
0
The refund was created and it is being processed
1
The refund has been completed. Final status
2
The refund has been canceled manually or because of an error. Final status
3
The refund was rejected or failed to reach the beneficiary's account. Final status

Payment types

Code
Description
00
Online Bank Transfer (TEF)
01
Bank Deposit
02
Voucher
03
Debit or Credit Card

Error codes

Code
Description
Action
300
Invalid params + [param name]
Ask the user to re-enter the information related to that parameter
301
Empty params + [param name]
The parameter must be included in the request and must not be empty. If the parameter contains information filled by the user, ask the user to fill the information. If the parameter is filled automatically on the merchant's side (x_login, x_trans_key, x_invoice, x_iduser or control), there is an integration error. Please include this parameter in the request.
302
Invalid control string
Integration problem. Please see Control string instructions
401
Invalid credentials
Integration problem. Check in the merchant's panel which are the correct credentials. Staging and Production credentials are different
402
Unregistered IP address
Whitelist the IP in the merchant's panels by going to Settings -> API Access (Notice the IPs for Deposits and Cashouts are different)
409
Missing configuration for merchant account
Reach out to [email protected] and mention the error message shown
500
Generic error
Internal error, please contact support
502
User unauthorized
For further information go to section "Clients" option on the left menu
503
User blacklisted
The user is known for committing fraud. You can ask this for review, find the client on the "Clients" option on the left menu, select the user and click on the three dots on the top right, and "Flag for review"
504
User unauthorized due to cadastral situation
Check the user's cadastral situation
505
Country not found
Send a valid country ISO code. Click here to see the list of countries.
506
Payment method not found
The Payment Method Code sent on the x_bank field isn't correct, or the Payment Method isn't enabled for your Merchant account (Use the get_banks_by_country API to diagnose this)
508
The user limit has been exceeded: {TRANSACTION|DAILY|WEEKLY|MONTHLY}
Check the user's limit on the panel under the "Clients" option on the left menu
515
Invalid amount
The amount does not reach the minimum limit of USD 2
516
Invalid invoice
For functions: newInvoice and refund, it means the invoice already exists. For functions: payment status and refund status, it means the invoice was not found.
517
Invalid country
The country does not exists
518
Too many consecutive attempts for user (Velocity Check)
This happens when the user attempts to do many deposits in a short period of time, and isn't completing them
519
Missing confirmation url
Make sure you are sending the confirmation url in the request or that you have set a default one in the Panel (Settings -> API Access)
520
Insufficient funds (applies for refund function)
The refund could not be processed due to insufficient funds. Contact us to increase the balance