Interface Error Codes
| Error Code | Type | Error Reason | Error Description | Solution |
|---|---|---|---|---|
| 40000 | number | Invalid request parameters | Signature verification of the interface parameters failed | Ensure that the signature private key matches the RSA public key uploaded on the merchant platform. |
| 40001 | number | Invalid request parameters | AES key decryption failed | The public key used to encrypt the AES key should be the payment platform’s RSA public key. Merchants should log into the merchant platform to view and download it on the “Applications” page. |
| 40002 | number | Invalid request parameters | Invalid APPID | Check if the APPID is correct. |
| 40003 | number | Invalid request parameters | Missing required parameter | Verify that all parameters are included. |
| 40004 | number | Invalid request parameters | Unsupported document type | Check if the document type is correct. Currently supported types: ID for identity card and PASSPORT for passport. |
| 40005 | number | Invalid request parameters | Phone number format not supported | Check if the phone number format is correct. |
| 40006 | number | Invalid request parameters | Incomplete document information provided | Check if the document type and document number are complete. |
| 40007 | number | Invalid request parameters | APPID does not belong to this merchant | Log into the merchant platform and check the APPID on the “Applications” page. |
| 40008 | number | Invalid request parameters | Merchant number does not exist | Verify that the merchant number is correct. |
| 40009 | number | Invalid request parameters | Parameter error | Ensure that the parameter values match the types outlined in the online interface documentation. |
| 40010 | number | Invalid request parameters | User account opening not supported in this region | Consult Spark’s official support staff about future support plans for your region. |
| 40011 | number | Invalid request parameters | Application call limit exceeded | Reduce the request frequency and try again later. |
| 40012 | number | Invalid request parameters | Email format not supported | Check if the email format is correct. |
| 40013 | number | Invalid request parameters | Unauthorized | Authorization credentials must be included in the "Authorization" field of the HTTP Header for the request. For details, please refer to the interface documentation (check the authorization information interface based on the authorization token). |
| 40014 | number | Invalid request parameters | Account already exists | The specified phone number/email already has an account in SPARK. To retrieve the user’s SPARK account information, call the SPARK user authorization-related interface to obtain user information through user authorization. |
| 40015 | number | Invalid request parameters | User information retrieval exception | The user is registered under another merchant’s application; call the SPARK user authorization-related interface to obtain user information through user authorization. |
| 40016 | number | Invalid request parameters | Country or region is not within the merchant’s operational area, account opening not possible | Merchants need to support user regions as operational areas. |
| 40017 | number | Invalid request parameters | Country code and phone number do not match | Please use the country code corresponding to the phone number; see the country code table. |
| 40018 | number | Invalid request parameters | Invalid country code | Check if the country code format is correct; see the country code table. |
| 41000 | number | Invalid request parameters | Callback notification URL does not comply with rules | Check if the URL format is correct. |
| 41001 | number | Invalid request parameters | Asynchronous notification URL does not comply with rules | Check if the URL format is correct. |
| 41002 | number | Invalid request parameters | Merchant not activated | Contact Spark’s official support personnel for assistance in activation. |
| 41003 | number | Invalid request parameters | Payer has not opened an account | The payer must be an active account. |
| 41005 | number | Invalid request parameters | Split type not supported | Check if the split type is correct; currently supported types are: 1 for merchant number, 2 for wallet user. |
| 41006 | number | Invalid request parameters | Split purpose not supported | Check if the split purpose is correct; currently supported types are: 1 for main transaction amount, 2 for merchant service fee, 3 for other fees. |
| 41007 | number | Invalid request parameters | Merchant split amount must be greater than platform service fee | Verify the split amount; it must be greater than the minimum service fee on any network (platform service fee = order amount * service fee rate; if calculated amount ≤ minimum service fee, use minimum service fee). |
| 41008 | number | Invalid request parameters | Split order amount does not match the total order amount | Check if the split amount is correct. |
| 41009 | number | Invalid request parameters | Payment currency not supported | Check if the order currency is correct; currently supported currency is USDT. |
| 41010 | number | Invalid request parameters | Split account has not been opened | The split account must be an active account. |
| 41011 | number | Invalid request parameters | Split account has not been activated | The split account must be an activated account. |
| 41012 | number | Invalid request parameters | Merchant order has expired | Verify that the order payment deadline is correct. |
| 41013 | number | Invalid request parameters | Total amount of merchant order does not comply with rules | Check if the total order amount is correct. |
| 41014 | number | Invalid request parameters | Split amount does not comply with rules | Check if the split amount is correct. |
| 41015 | number | Invalid request parameters | Split order missing main recipient | Check if the main recipient of the split order is provided. |
| 41016 | number | Invalid request parameters | Split order does not support multiple main recipients | Check if there is only one unique main recipient for the split order. |
| 41017 | number | Invalid request parameters | Service fee merchant and ordering merchant customer numbers do not match | Verify that the service fee merchant or ordering merchant customer numbers are correct. |
| 41018 | number | Invalid request parameters | Total order amount exceeds maximum precision | Verify that the total order amount is correct. |
| 41019 | number | Invalid request parameters | Split amount exceeds maximum precision | Verify that the split order amount is correct. |
| 41021 | number | Invalid request parameters | Timeout must be greater than order time | Verify that the order timeout is set correctly. |
| 41022 | number | Invalid request parameters | Payer and payee cannot be the same | Verify that the recipient of the order is correct. |
| 41023 | number | Invalid request parameters | Request number does not comply with rules | Check if the request number is correct. |
| 41025 | number | Invalid request parameters | Split type and split purpose do not match | Verify that the split type and split purpose are correct; the current rule is that the wallet user split purpose is the main transaction amount, while the merchant split purpose is for service fees or other costs. |
| 41026 | number | Invalid request parameters | Split order missing merchant | Check if the merchant recipient is provided in the split order. |
| 41027 | number | Invalid request parameters | Order payment network not supported | Check if the order payment network is correct. |
| 41028 | number | Invalid request parameters | Payment order amount must be greater than the minimum platform service fee | Verify that the order amount is correct; it must be greater than the minimum platform service fee on any network. |
| 41029 | number | Invalid request parameters | Splitter information error | Check for duplicate splitters. |
| 41030 | number | Invalid request parameters | Ordering merchant payment not supported | Verify if the payer is correct. |
| 41031 | number | Invalid request parameters | Payment network does not support this currency. | |
| 41032 | number | Invalid request parameters | Split payment address is incorrect. | |
| 41033 | number | Invalid request parameters | Duplicate split payment address exists. | |
| 41034 | number | Invalid request parameters | The split payment address cannot be the merchant CA address. | Check each split payment address; the payment address cannot be the merchant CA address. |
| 41035 | number | Invalid request parameters | No external wallet configured for the current network, please configure one first. | Log in to the merchant system and set an external wallet in the receive payment network. |
| 41036 | number | Invalid Parameter | Duplicate currency found in the available receiving networks. | Check the parameter available_payment_currency_networks to ensure no duplicate currencies within the same network. |
| 41037 | number | Invalid Parameter | Duplicate network found in the available receiving networks. | Check the parameter available_payment_currency_networks to ensure no duplicate networks. |
| 41038 | number | Invalid Parameter | None of the available receiving networks meet the minimum service fee. | Try setting a higher pricing amount or seller amount. |
| 41039 | number | Invalid Parameter | Online payment not enabled. | Please contact Spark support staff to enable online payment services. |
| 43000 | number | Invalid request parameters | Merchant balance insufficient | Merchant balance is insufficient; please recharge. |
| 43005 | number | Invalid request parameters | Payment order does not exist | Check if the payment order number is correct. |
| 43006 | number | Invalid request parameters | This order cannot be closed | The order cannot be closed due to status or system constraints. |
| 43007 | number | Invalid request parameters | This order has been closed | The order has been closed; no further action is required. |
| 43008 | number | Invalid request parameters | This customer has not opened an account | Customers in the interface parameters must have an active account. |
| 43011 | number | Invalid request parameters | Exceeded the maximum number of splits per order | Adjust the number of splits in the order and try again. |
| 44000 | number | Invalid request parameters | Authorization code invalid | The authorization code has expired; user authorization needs to be reinitiated. |
| 44001 | number | Invalid request parameters | Callback address for successful authorization does not match authorization code | Check if the parameters redirect_url and code correspond; the code should match the callback address receiving the authorization code during merchant application registration. |
| 44002 | number | Invalid request parameters | Invalid identification information | Check if the parameter client_id is correct. |
| 44003 | number | Invalid request parameters | Invalid authorization type | Check if the authorization type is correct; currently supported types are: refresh_token for refresh token and authorization_code for obtaining authorization token. |
| 44004 | number | Invalid request parameters | Refresh token invalid | The refresh_token returned by the authorization token interface has expired; user authorization needs to be reinitiated. |
| 50000 | number | System exception | Internal system error | System exception; please retry with the same parameters. |
Modified at 2025-04-14 03:45:42