當訂單完成後,PassToPay會向商家系統發起回調通知。若商家系統未正確返回,支付網關將再次延遲通知。

請求URL:此鏈接通過 【創建支付訂單接口】提交的參數notifyUrl設定。 如果該參數未傳值將不會發送回調通知。

請求方式:POST

請求類型: application/x-www-form-urlencoded

觸發場景:

  • 客戶完成支付,訂單狀態為 付款成功
  • 支付訂單在指定時間內未完成支付,訂單狀態為 訂單已關閉
  • 支付失敗並且無法繼續支付,訂單狀態為 付款失敗
參數描述範例
payOrderId必填。返回PassToPay生成的唯一訂單編號P12021022311124442600
mchNo必填。商家號碼M1621873433953
appId必填。應用 ID60cc09bce4b0f1c0b83761c9
mchOrderNo必填。返回商家傳入的訂單編號20160427210604000490
wayCode必填。付款方式,如:CHANNEL_CASHIERCHANNEL_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,單位:秒)