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 integration@d24.com 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 |
Last updated