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.
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​
​
Deposit API Error 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
​
Refund API 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 Deposit API 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
​