API Codes
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.
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.
API Error Codes
Categories
We group the error codes into different categories for better understanding.
1xx- Header errors2xx- Merchant/request validations errors3xx- User errors4xx- Create deposit errors5xx- Other errors7xx- Internal errors8xx- Refund errors9xx- Credit Card errors
Deposit API Error Codes
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.
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
212
400
DEPOSIT_REJECTED_FRAUD_CHECK
Rejected after fraud check
Transaction has been flagged as potential fraud
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_REJECTED_KYC_CHECK
User rejected after KYC check
Check the user's 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
305
400
PAYMENT_METHOD_RESTRICTED
Restricted payment method type
The payment type is disallowed for the payer
306
400
FINANCIAL_CAPACITY
The transaction cannot be processed as the user has reached their financial capacity, please provide proof of funds.
The transaction cannot be processed as the user has reached their financial capacity, please provide proof of funds.
400
400
INVALID_AMOUNT
Invalid amount. The minimum is USD 2 or equivalent in local currency
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.
414
400
MISSING_REPORTED_INFO
Missing reportedInfo attribute
There are missing values for the reported_info object
415
400
INVALID_REPORTED_INFO_BANK_BRANCH
Invalid reportedInfo.bankBranch value
The value sent in the field reported_info.bankBranch is invalid.
416
400
INVALID_REPORTED_INFO_BANK_ACCOUNT_NUMBER
Invalid reportedInfo.bankAccountNumber value
The value sent in the field reported_info.bankAccountNumber is invalid.
417
400
INVALID_REPORTED_INFO_ACCOUNT_TYPE
Invalid reportedInfo.bankAccountType value
The value sent in the field reported_info.bankAccountType is invalid.
418
400
MISSING_REQUIRED_FIELDS
Missing required fields in order to generate Deposit
The request is missing a required field. Please check the required fields for that payment method.
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
511
400
NO_PAYMENT_METHODS_AVAILABLE
No payment methods available
Please contact your AM regarding payment methods’ availability
720
400
MISSING_CONFIGURATION
Missing configuration for merchant account
Please contact your AM/TAM
Credit cards deposit API error codes
421
400
INSTALLMENTS_NOT_ENABLED
Merchant {MID} does not support installments for country {iso}.
Your merchant account is not allowed to create deposits with installments in that country.
422
400
INSTALLMENTS_QUANTITY_INVALID
Merchant {MID} installments quantity is invalid for country {iso code}. Requested {number}, allowed [{quantity of installments allowed}].
The amount of installments requested is not allowed for your merchant account in that country. Please check the allowed quantity.
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
Fraud Reason Codes for KYC Errors
101
400
Transaction related to blacklisted user.
The transaction was rejected because one of its attributes was related to a blacklisted user
102
400
Email risk
High risk detected by our fraud prevention engine related to the user's email address
103
400
Credit card risk
High risk detected by our fraud prevention engine related to the credit card used
104
400
User rejected after KYC check
User rejected by our KYC controls
105
400
Underage user detected
User does not meet the minimum age requirement
106
400
Mismatch between user name and document name
The user's name does not match the name associated with the document provided
107
400
Document status is not OK
Some irregularities have been detected while validating the document information
108
400
PEP user detected
The user is a Politically Exposed Person (PEP)
109
400
High risk detected
High risk detected by our fraud prevention engine
110
400
Failed biometric check
Something went wrong while performing the biometric check on the user
111
400
Failed OTP verification
Something went wrong while performing the OTP check on the user
112
400
3DS Authentication failed
Transaction rejected due to failed 3DS
113
400
Document does not exist
Invalid Document
114
400
User rejected after CNPJ validations
Invalid/Irregular CNPJ (Brasil Only)
115
400
Invalid document format
Document format rejections
116
400
Sportsman User
Sportsman User
117
400
Related to Sportsman User
Related to Sportsman User
118
400
National Sanction Lists
User has been identified on national sanction lists
119
400
International Sanction Lists
User has been identified on international sanction lists
120
400
Regulatory reasons
Rejected due to regulatory reasons
121
400
Velocity check
Rejected due to velocity check
Last updated
Was this helpful?