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 [e-mail] 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
530	User greylisted	The user is banned because we detected suspicious activities. 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"
601	Currency not allowed for this country	Send a valid currency. Click here to see the available currencies per country.
700	Could not register user	Internal error, please contact support
701	Could not make the deposit	Internal error, please contact support