Payment Engine
Payment Engine Error Codes
Error-code reference and recommended handling for Payment Engine API.
Payment Engine Error Codes
Scope
This page applies only to Payment Engine API. Team API uses a different authentication method and error-code system; do not mix them.
Success code is 00000. All other codes indicate exceptions.
| Code | Message | Meaning | Recommended Action |
|---|---|---|---|
| Axxxx | Param Error | Invalid request parameters | Contact Cregis support if the issue persists after request validation. |
| A0400 | order_amount must be a number in a string format that is greater than 0 and less than or equal to 100,000,000. | order_amount must be a number in string format, greater than 0 and less than or equal to 100,000,000. | Please ensure order_amount is a valid number in string format, greater than 0 and less than or equal to 100,000,000 |
| A0400 | {{parameter_name}} cannot exceed {{limit}} characters. | The string parameter is larger than the character limit set in the data table. | Please reduce the length of parameter {{parameter_name}} to {{limit}} characters or fewer. |
| A0400 | order_id, order_amount, order_currency, payer_id, success_url and cancel_url are required | One or all of the following (order_id, order_amount, order_currency, payer_id, success_url, or cancel_url) were not submitted. | Please ensure all of the following parameters are submitted: order_id, order_amount, order_currency, payer_id, success_url, and cancel_url. |
| A0400 | {{parameter_name}} must be submitted as a JSON string. | If order_details, sub_merchant or tokens submitted, but one of those cannot be decoded into JSON. | The submitted parameter {{parameter_name}} is not a valid JSON string. Please ensure the parameter is properly JSON-encoded. |
| B0001 | Signature Error | Signature verification failed | Recheck signature algorithm, canonicalization, and required fields. |
| T0062 | Please expand the number of API addresses or upgrade the subscription version first | API address quota is insufficient | Expand API address quota or upgrade your subscription plan. |
| E0001 | The IP is not added to the whitelist list | Caller IP is not authorized | Add your server IP to the project IP whitelist in Cregis App. |
| E0002 | Alias or remark must be a combination of {} characters or less | Alias/remark format or length is invalid | Check alias and remark format and length limits. |
| E0003 | pid does not exist | Payment Engine project does not exist | Verify that pid is correct. |
| E0004 | Unsupported interface type | Interface type is not enabled for this project | Enable the required interface type in project settings. |
| E0005 | Unsupported coin | Coin/network is not supported | Verify coin/network support before calling the API. |
| E0006 | The withdrawal amount must be greater than 0 | Withdrawal amount must be > 0 | Check amount; it cannot be empty or zero. |
| E0007 | Incorrect accuracy of the withdrawal amount | Withdrawal amount precision is invalid | Adjust amount precision to the supported decimal scale. |
| E0008 | Address is invalid | Address format is invalid | Check address format and network compatibility. |
| E0009 | Duplicate business number | Duplicate third-party business ID | Ensure third_party_id is unique per business transaction. |
| E0010 | Wallet does not exist | Wallet not found | Verify wallet ID in project developer settings. |
| E0016 | Amount error | Amount is invalid | Recheck amount format and value range. |
| E0018 | Order number must be unique | Duplicate order number | Ensure your order number is unique. |
| E0019 | Order number exceeds 128 characters | Order number too long | Keep order number length within 128 characters. |
| E0021 | Order remark exceeds 256 characters | Order remark too long | Keep order remark within 256 characters. |
| E0022 | Order amount must be greater than 0 | Order amount must be > 0 | Provide a valid order amount greater than zero. |
| E0023 | Order amount precision error | Order amount precision is invalid | Adjust precision according to product/currency rules. |
| E0024 | cregis_id does not exist. | Cregis order ID does not exist | Verify that cregis_id is correct. |
| E0025 | Incorrect payer information | Payer information is invalid | Validate payer name, payer ID, and email format/length. |
| E0026 | Please input in minutes. Minimum is {} minutes, maximum {} minutes | Timeout value is out of allowed range | Set timeout within the allowed min/max minute range. |
| E0027 | Number of addresses set incorrectly | Batch address count exceeds limits | Batch-create at most 100 addresses per request. |
| E0028 | Unsupported address status value | Unsupported address status value | Use valid status values only (0 enabled, 1 disabled). |
| E0029 | At least one modification required | No update field was provided | Update at least one of callback_url, alias, or status. |
| E0030 | Address does not belong to this project | Address does not belong to current project | Verify that pid and address match the same project. |
| E0031 | Failed to create the checkout counter | Failed to create checkout | Retry later or contact Cregis support. |
| E0031 | order_currency is invalid. See valid currencies at https://developers.cregis.com/en/payment-engine-supported-currencies/ | order_currency is invalid | Please ensure order_currency is one of the supported currencies listed at https://developers.cregis.com/en/payment-engine-supported-currencies/ |
| E0031 | {{incorrect_token_name}} in the tokens array is not a valid name. See supported list at https://developers.cregis.com/en/payment-engine-supported-currencies/ | tokens contain the incorrect currency . | Please verify the token name is correct and is one of the supported currencies at https://developers.cregis.com/en/payment-engine-supported-currencies/ |
| E0031 | {{incorrect_token_name}} in the tokens array has not been configured in the Cregis portal. Please add this token and set the settlement information. | tokens contain a currency that the merchant has not configured. | The token name is valid but has not been configured in the Cregis portal. Please add this token as an accepted payment currency in the portal. |
| E0032 | Memo content only supports numeric characters and must be less than 4294967295 | Memo format is invalid | Use numeric memo only, and keep it below 4294967295. |
| E0033 | Please expand the number of API addresses or upgrade the subscription version first | Sub-address quota is insufficient | Upgrade sub-address package or subscription plan. |
| E0034 | The number of available withdrawals is insufficient | API payout count is insufficient | Upgrade subscription plan for more payout capacity. |
| E0035 | payer_email is required when accept_partial_payment = "false" or accept_over_payment = "false" | Payer email is required when partial or overpayment is not accepted | Provide payer_email when accept_partial_payment or accept_over_payment is false. |
| E0036 | underpaid_tolerance must be greater than or equal to 0 and less than 10,000,000 | underpaid_tolerance is outside the allowed range | Set underpaid_tolerance to a value greater than or equal to 0 and less than 10,000,000. |
| E0036 | overpaid_tolerance must be greater than or equal to 0 and less than 10,000,000 | overpaid_tolerance is outside the allowed range | Set overpaid_tolerance to a value greater than or equal to 0 and less than 10,000,000. |
| E0037 | Please set the default payout wallet | Payout wallet does not match project configuration | Use the payout wallet configured for the project. |
| E0038 | The collectible balance is 0 | Address collectible balance is zero | No collection is needed for this address. |
| E0039 | The subscription has expired. Please renew | Sub-address subscription expired | Renew sub-address subscription to continue service. |
| E0040 | The receiving address must be a wallet address from the current project. | Collection destination is restricted | Use a receiving address belonging to the current WaaS project. |
| E0041 | Address is in the team blacklist. | Address is blacklisted by team policy | This recipient address is blocked and cannot be transacted. |
| E0042 | The token has not been added to the current wallet | The token has not been added to the current wallet | Please add it in Cregis > Wallet > Settings > Token Management |