商家通過此API查詢訂單，支付網關將傳回最新的訂單信息。
請求路徑 : api/pay/query
請求方式 : POST
請求類型 : application/json or application/x-www-form-urlencoded
請求參數
| 參數名稱 | 描述 | 範例 |
|---|---|---|
| mchNo | 必填。商家號碼 | M1621873433953 |
| appId | 必填。應用程式 ID | 60cc09bce4b0f1c0b83761c9 |
| reqTime | 必填。請求API時間，13位元時間戳 | 1622016572190 |
| version | 必填。版本號，固定：1.0 | 1.0 |
| signType | 必填。簽名類型，目前僅支援MD5方式 | MD5 |
| sign | 必填。簽名值，詳見請求簽名 | C380BEC2BFD727A4B6845133519F3AD6 |
| mchOrderNo | 商家唯一訂單編號。mchOrderNo、payOrderId不可同時為空。 | 20160427210604000490 |
| payOrderId | 支付網關產生的訂單號碼。mchOrderNo、payOrderId不可同時為空。 | P20160427210604000490 |
範例:
{
"payOrderId": "P202106181104177050002",
"appId": "60cc09bce4b0f1c0b83761c9",
"sign": "46940C58B2F3AE426B77A297ABF4D31E",
"signType": "MD5",
"reqTime": "1624006009",
"mchNo": "M1623984572",
"version": "1.0"
}
回應:
| 參數 | 描述 | 範例 |
|---|---|---|
| code | 必填。0-處理成功，其他-處理錯誤，具體參見錯誤碼 | 0 |
| msg | 必填。具體錯誤原因，如：簽名失敗、參數格式驗證錯誤 | Signing failure |
| sign | 必填。對data中的資料進行簽名。如果資料為空，則不會傳回。 | CCD9083A6DAD9A2DA9F668C3D4517A84 |
| data | 必填。返回訂單數據，json格式數據 | {} |
Data Parameter:
| Parameter | Description | Sample value |
|---|---|---|
| payOrderId | 必填。返回付款系統訂單編號 | P12021022311124442600 |
| mchNo | 必填。商家號碼 | M1621873433953 |
| appId | 必填。應用程式 ID | 60cc09bce4b0f1c0b83761c9 |
| mchOrderNo | 必填。返回商家傳入的訂單編號 | 20160427210604000490 |
| wayCode | 必填。付款方式，如CHANNEL_CASHIER | CHANNEL_CASHIER |
| amount | 必填。付款金額，單位分 | 1000 |
| currency | 必填。三位數貨幣代碼，人民幣：cny | cny |
| state | 必填。付款訂單狀態 0：訂單生成 1：付款中 2：支付成功 3：支付失敗 4：取消 5：退款 6：訂單關閉 | 2 |
| clientIp | 用戶端 IPV4 位址 | 210.73.10.148 |
| subject | 產品標題 | 標題測試 |
| body | 產品說明 | 描述測試 |
| payUrl | 支付url。當前只有收銀台訂單才會返回。 | |
| channelOrderNo | 對應通道的訂單編號 | 20160427210604000490 |
| errCode | 通道訂單回傳錯誤碼 | 1002 |
| errMsg | 通道訂單回傳錯誤說明 | 134586944573118714 |
| extParam | 商家擴充參數，回呼時原樣返回 | 134586944573118714 |
| createdAt | 訂單建立時間，13位時間戳 | 1622016572190 |
| successTime | 訂單支付成功時間，13位時間戳 | 1622016572190 |