General rules for paying on behalf of others
General rules for paying on behalf of others
This page summarizes the general rules for PayCools Local Payments (Pay on Behalf).Currently contains failed transactions Error code with the interface's API response code In the future, more general rules such as logic, parameters and definitions will continue to settle on this page.
Error code
When the transaction fails, the interface returns and the asynchronous notification will pass failedCode And failedMessage Give the reason for the failure:
| failedCode | message | Introduction |
|---|---|---|
| -10000 | Transaction Service Error | Trading service exception |
| -10001 | Transaction Exceed Limit | Transaction amount exceeds limit |
| -10002 | Transaction Params Error | Incorrect transaction parameters |
| -10003 | Transaction Insufficient Balance | Merchant has insufficient funds |
| -10004 | Transaction Channel Rejected | Channel Rejection (Channel Side Not Accepted) |
| -10005 | Transaction Destination Account Error | Incorrect payout account information |
| -10006 | Transaction Network Reject | Network Exception |
| -10007 | Transaction Channel Temporarily Close | Channel temporarily closed |
| -10008 | Merchant Unavailable Error | Merchant Unavailable |
| -10009 | Recipient Account Blocked | Payout account frozen or restricted |
| -10010 | Channel Refund Failed | Channel Refund Failed |
Failure code returned by the card verification interface:
| failedCode | message | Introduction |
|---|---|---|
| -20001 | Invalid parameters | Invalid parameter |
| -20002 | Account abnormal | Account Exception |
| -20003 | Balance Insufficient | Insufficient funds |
| -20004 | Channel error | Channel Exception |
| -20005 | System error | System Exception |
| -20006 | Unknown error | Unknown error |
The error code only describes the reason for the failure; for the corresponding troubleshooting direction and handling suggestions, please refer to the Business introduction · Risk control and failure handling.
API response code
Returned by the interface in real time code And message to identify the outcome of this request. The following is the common interface response code, and the payment interface is also applicable:
| code | message | Introduction |
|---|---|---|
| 10000 | Success | Request succeeded |
| 21000 | Server error, Please try again later. | Service exception, please try again later |
| 21001 | Request sign error | Failed to request signature verification |
| 21002 | Request param error | Wrong request parameters |
| 21003 | Request appId error | appId error |
| 21004 | Merchant is unavailable | Merchant Unavailable |
| 21005 | Merchant channel is unavailable | Merchant channel not available |
| 21006 | Merchant transaction not found | Merchant transaction does not exist |
| 21007 | Duplicate merchant order id | Merchant order number duplicate |
| 21008 | Request timestamp error | Request timestamp error |
| 21009 | Request timestamp error | Request timestamp error |
| 21010 | The amount exceeds the limit | Amount exceeds limit |
| 21011 | Network error | Network Exception |
| 21012 | Request bank code error | Incorrect bank code |
| 21013 | Request wallet code error | Wallet code error |
| 21014 | Merchant balance insufficient | Merchant has insufficient funds |
| 21015 | Duplicate idempotencyId | Idempotent Repeat |
| 21016 | Merchant ip forbidden | Merchant IP is not whitelisted |
| 21017 | Merchant has not opened this national service | Merchant is not available in this country |
| 21018 | Request transfer code error | transferCode error |
| 21019 | Request pay method code error | payMethodCode Error |
| 21020 | Too many requests, please retry later. | Too many requests, please try again later |
| 21021 | Transaction Amount Invalid | Invalid transaction amount |
| 21022 | Transaction Volume Limit | Number of transactions exceeded |
| 21023 | Transaction create failed | Transaction creation failed |
| 21024 | Invalid access token | Invalid access token |
| 21025 | Not allowed to cancel | Cancel not allowed |
| 21026 | Customer Balance not enough | Insufficient user balance |
| 21027 | Transaction creation exceeds limit | Transaction creation exceeds limit |
| 21028 | Transaction already paid or closed | Transaction paid or closed |
| 21050 | Business unit not found | Business unit does not exist |
| 21051 | Business unit does not belong to this merchant | Business unit does not belong to this merchant |
| 21056 | Cross region business is not allowed for this merchant | This merchant does not allow cross-regional business |
For full prompts and instructions, refer to the API Generic Prompt.