當訂單完成後,PassToPay會向商家系統發起回調通知。若商家系統未正確返回,支付網關將再次延遲通知。
請求URL:此鏈接通過 【創建支付訂單接口】提交的參數notifyUrl設定。 如果該參數未傳值將不會發送回調通知。
請求方式:POST
請求類型: application/x-www-form-urlencoded
觸發場景:
- 客戶完成支付,訂單狀態為 付款成功
- 支付訂單在指定時間內未完成支付,訂單狀態為 訂單已關閉
- 支付失敗並且無法繼續支付,訂單狀態為 付款失敗
參數 | 描述 | 範例 |
---|---|---|
payOrderId | 必填。返回PassToPay生成的唯一訂單編號 | P12021022311124442600 |
mchNo | 必填。商家號碼 | M1621873433953 |
appId | 必填。應用 ID | 60cc09bce4b0f1c0b83761c9 |
mchOrderNo | 必填。返回商家傳入的訂單編號 | 20160427210604000490 |
wayCode | 必填。付款方式,如:CHANNEL_CASHIER | CHANNEL_CASHIER |
amount | 必填。付款金額,两位小数位,*100取整 | 10000 |
currency | 必填。客户支付的貨幣代碼 | cny |
state | 必填。付款訂單狀態 0-訂單已產生 1-付款中 2-付款成功 3-付款失敗 4-已取消 5-已退款 6 訂單已關閉 | 2 |
clientIp | 用戶端 IPV4 位址 | 210.73.10.148 |
subject | 必填。產品標題 | PassToPay product title test |
body | 必填。產品說明 | PassToPay Product Description Test |
channelOrderNo | 對應通道的訂單編號 | 20160427210604000490 |
errCode | 通道訂單回傳錯誤碼 | 1002 |
errMsg | 通道訂單回傳錯誤說明 | 134586944573118714 |
extParam | 商家擴充參數 | 134586944573118714 |
successTime | 訂單支付成功時間,13位時間戳 | 1622016572190 |
createdAt | 必填。訂單建立時間,13位時間戳 | 1622016572190 |
reqTime | 必填。通知請求時間,13位時間戳 | 1622016572190 |
sign | 必填。簽名值,詳見簽名演算法 | C380BEC2BFD727A4B6845133519F3AD6 |
範例:
{
"amount": 5,
"body": "Product body",
"clientIp": "192.166.1.132",
"createdAt": "1622016572190",
"currency": "cny",
"extParam": "",
"ifCode": "wxpay",
"mchNo": "M1621873433953",
"appId": "60cc09bce4b0f1c0b83761c9",
"mchOrderNo": "mho1621934803068",
"payOrderId": "20210525172643357010",
"state": 3,
"subject": "Product subject",
"wayCode": "WX_BAR",
"sign": "C380BEC2BFD727A4B6845133519F3AD6"
}
處理完畢後,業務系統同步返回PassToPay字符串“success”表示成功。不返回或返回其他字符串表示處理失敗。
注意: 只有因爲網絡問題問題才會重發回調通知請求,如果請求被正常返回,則不會重試。
(通知頻率為0/30/60/90/120/150,單位:秒)