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

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