API Codes

Learn about the API Codes returned by our APIs

Deposits Status Codes

The status of the deposits are separated into different and very specific categories for you to better handle and know the behavior of your customers.

Status

Description

​

The deposit is created but the customer hasn't opened the link yet.

​

The deposit is created and the customer has opened the link but he/she didn't complete the payment flow (select payment method, complete personal details, confirm details) or the provider was unable to process the request.

​

The deposit is created with all the information required and it is awaiting on customer's payment. It has been marked by you to release it earlier. Please note that the customer hasn't paid yet and the money won't be credited to your balance until the customer's payment is detected.

​

The deposit is created with all the information required and it is awaiting on customer's payment.

​

The deposit didn't pass our anti-fraud systems and will be retained until manual review.

​

The deposit has reached its expiration time and the user didn't pay.

​

The deposit has been cancelled by the customer or it has been 7 days after the expiration.

​

The deposit was paid by the customer but it still hasn't arrived the payer's crypto wallet. Only used for crypto payments.

​

The deposit has been completed and the money was credited to your account or to the payer's crypto wallet.

Use the Deposit Status Endpoint to retrieve the status of a refund.

​

Refunds Status Codes

Status

Description

​

The refund is created and is pending to be processed. It can still be cancelled.

​

The refund is pending for you to provide more information. It can still be cancelled.

​

The refund has been sent to the bank for processing. It can't be cancelled anymore.

​

The refund has been manually cancelled. Final status.

​

The refund has been rejected by the bank. Final status.

​

The refund has been completed. Final status.

Use the Refund Status Endpoint to retrieve the status of a refund.

​

API Error Codes

Categories

We group the error codes into different categories for better understanding.

  • 1xx - Header errors

  • 2xx - Merchant/request validations errors

  • 3xx - User errors

  • 4xx - Create deposit errors

  • 5xx - Other errors

  • 8xx - Refund errors​

  • 9xx - Credit Card errors​

​

Codes

API Code

HTTP Code

Type

Message

Description

100

401

INVALID_CREDENTIALS

Invalid Credentials

The X-Login you sent is incorrect or it is not yet active

101

400

MISSING_REQUIRED_HEADER

Missing or invalid format for required header {headerName}

Make sure all the headers are correct. Click here for details​

102

400

INVALID_SIGNATURE

Invalid signature

Invalid Authorization signature. Click here for instructions​

103

400

INVALID_DATE_RANGE

X-Date header value out of valid range

The X-Date value you sent in the header is outside the allowed time-frame. Click here for details​

104

400

IDEMPOTENCY_KEY_ALREADY_USED

Idempotency key {key} has been already used

The X-Idempotency-Key you sent has already been used

105

400

EMPTY_HEADER_VALUE

Optional header {headerName} must not be blank

If an optional header is sent, it can't be blank

200

405

METHOD_NOT_ALLOWED

Method not allowed

The request method used is not allowed. Click here for endpoints instructions

201

400

BEAN_VALIDATION_ERROR

Field validation error. Check details

One or more fields sent were incorrect

202

401

INVALID_IP

Unregistered IP address

You must whitelist your IP Address. Click here for instructions​

203

429

VELOCITY_CHECK

Too many consecutive attempts for user (Velocity Check)

The user has created many deposits in a short period of time

204

400

INVALID_MEDIA_TYPE

Invalid media type

The payload format is in an unsupported format. Make sure the header Content-Type is application/json

205

400

MISSING_REQUEST_PARAMETER

Missing request parameter

The request is missing an important parameter

206

400

MISSING_PATH_VARIABLE

Missing path variable

The request is missing an important path variable

207

400

INVALID_REQUEST_PARAMETER_TYPE

Invalid request parameter type

A parameter type sent was incorrect

208

404

RESOURCE_NOT_FOUND

Resource not found

The deposit_id being used doesn't exist

209

400

INVALID_REQUEST_BODY

Invalid request body: {details}

There is a syntax error in the JSON payload

217

403

FORBIDDEN_MERCHANT

Merchant has no authorization to use this API

Your Merchant Account is not enabled to use this API. Contact your Account Manager for more information

218

400

CRYPTO_NOT_ALLOWED_FOR_MERCHANT

Wrong merchant routing type for crypto payments

Your Merchant Account is not enabled to use the Crypto functionality. Contact your Account Manager for more information

300

400

USER_BLACKLISTED

User blacklisted

The user is known for committing fraud

301

400

USER_GREYLISTED

User greylisted

The user is banned because we detected suspicious behavior

302

400

USER_UNAUTHORIZED

User unauthorized

The user is blocked. For further information go to the "Clients" section on the Merchant Panel

303

400

USER_UNAUTHORIZED_REG_STATUS

User unauthorized due to cadastral situation

Check the user's cadastral situation

304

400

USER_LIMIT_EXCEEDED

The user limit has been exceeded: {TRANSACTION|DAILY|WEEKLY|MONTHLY}

Check the user's limit on the Merchant Panel under the "Clients" section

400

400

INVALID_AMOUNT

Invalid amount

The amount does not reach the minimum limit of USD 2

401

400

PAYMENT_METHOD_NOT_FOUND

Payment method not found

The payment_method_code sent isn't correct, or the Payment Method isn't enabled for your Merchant account. Use the payment_methods API to diagnose this error

402

400

INVOICE_ALREADY_USED

Invoice already used

The invoice_id sent has already been used

403

400

INVALID_BANK_CODE

Invalid bank code: {code}

The bank_code sent is invalid

404

400

ERROR_CREATING_PAYMENT

Payment method provider unavailable

Our provider is temporarily unavailable. Use a different payment method or try again

406

400

INVALID_ADDRESS

Invalid address

The address sent is invalid

407

400

INVALID_CITY

Invalid city

The city sent is invalid

408

400

PAYMENT_METHOD_LIMIT_EXCEEDED

Payment method limit exceeded

The amount sent exceeds the provider's payment method limit. Try with a smaller amount

410

400

PAYMENT_METHOD_MINIMUM_REQUIRED

Payment method minimum required

The amount sent is smaller than the provider's payment method minimum limit. Try with a bigger amount

411

400

INVALID_USER_DOCUMENT

Invalid user document ID

The document_id specified was rejected by the provider itself. Check it is valid

412

400

PAYMENT_METHOD_UNAVAILABLE

Payment Method Unavailable

The payment method is temporarily unavailable, please try again later

413

400

INVALID_REPORTED_INFO_BANK_BENEFICIARY

Invalid reportedInfo.bankBeneficiary value

The value sent in the field reported_info.bank_beneficiary is invalid. Check validations​

414

400

MISSING_REPORTED_INFO

Missing reportedInfo attribute

There are missing values for the reported_info object. Check requirements​

415

400

INVALID_REPORTED_INFO_BANK_BRANCH

Invalid reportedInfo.bankBranch value

The value sent in the field reported_info.bankBranch is invalid. Check validations​

416

400

INVALID_REPORTED_INFO_BANK_ACCOUNT_NUMBER

Invalid reportedInfo.bankAccountNumber value

The value sent in the field reported_info.bankAccountNumber is invalid. Check validations​

417

400

INVALID_REPORTED_INFO_ACCOUNT_TYPE

Invalid reportedInfo.bankAccountType value

The value sent in the field reported_info.bankAccountType is invalid. Check validations​

418

400

MISSING_REQUIRED_FIELDS

Missing required fields in order to generate Deposit

The request is missing a required field. Please check here.

419

400

MISSING_PAYER_ID_OR_DOCUMENT

payer.id or payer.document field is missing

The request is missing the payer.id or payer.document field and at least one of them is mandatory to create the deposit

500

500

GENERIC_ERROR

Oh no! Something has gone wrong. Please contact a system administrator

Internal error, please contact support

​

Refunds Error codes

API Code

HTTP Code

Type

Message

Description

800

400

REFUND_NOT_ENABLED

Refund is not enabled

Your Merchant account doesn't have the refund capability enabled. Check with your Account Manager

801

400

DEPOSIT_NOT_COMPLETED

Refund cannot be applied since deposit is not in status completed

The refunds can only be applied over COMPLETED deposits

802

400

INVALID_AMOUNT_TO_REFUND

Amount to refund not valid

The amount to refund is not valid. Check if the amount is negative or bigger than the deposit itself.

803

400

INSUFFICIENT_FUNDS

Insufficient funds

Your Merchant account doesn't have enough funds to cover for the refund amount

804

400

MISSING_BANK_ACCOUNT

Missing bank account information

The bank account information is missing

805

400

ERROR_IN_REFUND

Error, the refund was not processed. {details}

The refund could not be completed. Flag it for review on our Merchant Panel for further information

​

PCI Deposits Endpoint Specific Error codes

API Code

HTTP Code

Type

Message

Description

900

400

CREDIT_CARD_BIN_NOT_FOUND

Invalid credit card bin

We were unable to find a valid issuer with the first 6 digits of the card

​