API Status Codes
This comprehensive reference covers all BIEASES API status codes, their meanings, and recommended solutions. Understanding these codes is essential for effective error handling and debugging.
Success Codes
| Code | Message | Description |
|---|---|---|
| 20000 | Success | Request completed successfully |
Authentication & Security Errors
| Code | Message | Solution |
|---|---|---|
| 44000 | Merchant Certificate not found | Contact BIEASES operations to generate certificate |
| 44001 | The signature verification failed | Verify signature parameters and algorithm requirements |
| 44004 | Data encrypt failed | Check encryption parameters and algorithm requirements |
| 44005 | Merchant not found | Verify merchant ID is correct |
Request Format Errors
| Code | Message | Solution |
|---|---|---|
| 40000 | Params error: [field error] | Check parameters in the specified field |
| 44003 | Body decrypt failed | Verify encryption parameters and decryption method |
Business Logic Errors
Create Payment
| code | msg | solution |
|---|---|---|
| 40000 | Params error: [field error] | Check params with returned field |
| 44000 | Merchant Certificate not found | Contact BIEASES operations staff to generate certificate |
| 44001 | The signature verification failed | Please check whether the signature parameters and methods meet the signature algorithm requirements |
| 44004 | Data encrypt failed | Please check whether the encryption parameters and methods meet the encryption algorithm requirements |
| 44005 | Merchant not found | Please check whether the merchant number is correct |
| 44007 | Currency does not support | Please check whether the transaction currency is consistent with the currency held by the merchant |
| 44008 | Invalid amount value | Please check whether the transaction amount is consistent with the order amount and sum of the product amount |
| 44009 | Duplicated orders | Please verify whether the merchant order number has been submitted repeatedly |
| 99999 | Other errors | Please contact BIEASES tech support team |
Query Payment Order
| code | msg | solution |
|---|---|---|
| 20000 | Success | - |
| 40000 | Params error: [field error] | Check params with returned field |
| 44000 | Merchant Certificate not found | Contact BIEASES operations staff to generate certificate |
| 44001 | The signature verification failed | Please check whether the signature parameters and methods meet the signature algorithm requirements |
| 44003 | Body decrypt failed | Please check whether the encryption parameters and methods meet the encryption algorithm requirements |
| 44006 | Order not found | Please check whether the order has initiated a transaction |
| 99999 | Other errors | Please contact BIEASES tech support team |
Cancel Payment Order
| code | msg | solution |
|---|---|---|
| 20000 | Success | - |
| 40000 | Params error: [field error] | Check params with returned field |
| 44000 | Merchant Certificate not found | Contact BIEASES operations staff to generate certificate |
| 44001 | The signature verification failed | Please check whether the signature parameters and methods meet the signature algorithm requirements |
| 44003 | Body decrypt failed | Please check whether the encryption parameters and methods meet the encryption algorithm requirements |
| 44006 | Order not found | Please check whether the order has initiated a transaction |
| 41012 | Order is paying | Order is being processed, cancel failed |
| 99999 | Other errors | Please contact BIEASES tech support team |
Refund Payment Order
| code | msg | solution |
|---|---|---|
| 20000 | Success | - |
| 40000 | Params error: [field error] | Check params with returned field |
| 44000 | Merchant Certificate not found | Contact BIEASES operations staff to generate certificate |
| 44001 | The signature verification failed | Please check whether the signature parameters and methods meet the signature algorithm requirements |
| 44003 | Body decrypt failed | Please check whether the encryption parameters and methods meet the encryption algorithm requirements |
| 44006 | Order not found | Please check whether the order has initiated a transaction |
| 44007 | Currency does not support | Please check whether the transaction currency is consistent with the currency held by the merchant |
| 44008 | Invalid amount value | Please check whether the transaction amount is consistent with the order amount and sum of the product amount |
| 44010 | Payment order status not paid | Please check whether the order has been paid. Unpaid orders cannot be refunded |
| 44011 | Transaction order not found | Please check whether the order number is correct |
| 44012 | Transaction order status is not paid | Please check whether the order is correct, it has no transaction order |
| 44014 | Transaction Refund order create failed | Refund order creation failed, please try again |
| 44015 | Duplicated Refund | Please verify whether the refund order has been submitted repeatedly |
| 41010 | Insufficient Balance | Insufficient balance, unable to process transaction |
| 41012 | Order is paying | Order is being processed, refund failed |
| 99999 | Other errors | Please contact BIEASES tech support team |
Query Refunded Payment Order
| code | msg | solution |
|---|---|---|
| 20000 | Success | - |
| 40000 | Params error: [field error] | Check params with returned field |
| 44000 | Merchant Certificate not found | Contact BIEASES operations staff to generate certificate |
| 44001 | The signature verification failed | Please check whether the signature parameters and methods meet the signature algorithm requirements |
| 44003 | Body decrypt failed | Please check whether the encryption parameters and methods meet the encryption algorithm requirements |
| 44013 | Refund order not found | Please check whether the refund order number is incorrect and whether the order status is correct (e.g., unpaid, paid but not refunded) |
| 99999 | Other errors | Please contact BIEASES tech support team |