Payment Submit API
Tips
- All requests are
Postrequests, and the data format isjson
Brief Description
- H2H: Requires the payment API and the current API to work together.
- After completing the payment, the user needs to submit the transaction ID on the checkout page.
Request URL
/v1/paypro/payinSubmit
Request Method
- POST
Header
| Header | Required | Type | Description |
|---|---|---|---|
| merchantNo | Yes | string | None |
Body
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| sign | Yes | string | Except for sign, the remaining fields should be sorted by the first letter to form key1=value1key2=value2, and then use the app secret as salt to perform MD5 encryption. The final sign should be in lowercase. |
| timestamp | Yes | long | Timestamp (e.g., 1715941383720) |
| platFormTradeNo | Yes | string | Unique platform order number |
| trxId | Yes | string | Transaction ID |
Example of Request Parameters
{
"sign": "0be92a962072b1786a01a2cab4891a1d",
"timestamp": "1728609257212",
"platFormTradeNo": "test_00000008",
"trxId": "11111111"
}
Response Result
Tips
You can use the code parameter to determine the status:
- code = 0000: The submission was successful. Await a subsequent callback or query for the final result.
- For any other code value: The order is being processed. Await a subsequent callback or query for the final result.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| msg | Yes | string | Request result (when returning "success", it only indicates that this request was successful; it should not be used for merchant-side logic judgment) |
| code | Yes | string | Request response code (when returning "0000", it only indicates that this request was successful; it should not be used for merchant-side logic judgment). |
| timestamp | Yes | string | Transaction time |
| success | Yes | Boolean | Transaction result |
| data | Yes | Boolean | Submit Results |
Example of Successful Return
{
"msg": "success",
"code": "0000",
"timestamp": 1728609277476,
"success": true,
"data": true
}
Example of failure return
{
"msg": "Order not exists",
"code": "8000",
"timestamp": 1728609277476,
"success": false,
"data": null
}
