當轉帳完成(成功或失敗)時,支付網關會向商家系統發起回呼通知。若商家系統未正確返回,支付網關將再次延遲通知。
商家系統處理完畢後應同步返回支付網關。傳回字串success表示成功。返回fail表示處理失敗。
注意: 只有因爲網絡問題問題才會重發回調通知請求,如果請求被正常返回,則不會重試。
(通知頻率為0/30/60/90/120/150,單位:秒)
請求URL:此連結由透過轉帳API提交的參數notifyUrl設定。如果無法存取該鏈接,商家系統將無法接收來自支付網關的通知。
請求方式: POST
請求類型: application/x-www-form-urlencoded
application/x-www-form-urlencoded
參數 | 描述 | 範例 |
---|---|---|
mchNo | 必填。商家號碼 | M1621873433953 |
appId | 必填。應用程式 ID | 60cc09bce4b0f1c0b83761c9 |
mchOrderNo | 必填。商家產生的轉帳訂單編號 | 20160427210604000490 |
transferId | 必填。支付中心產生的轉帳單號 | T20160427210604000490 |
amount | 必填。轉帳金額,單位分 | 100 |
currency | 必填。三位數貨幣代碼,人民幣:cny | cny |
ifCode | 必填 wxpay:微信官方接口 alipay:支付寶官方接口 | wxpay |
entryType | 必填。入帳方式: WX_CASH:微信找零 ALIPAY_CASH:支付寶轉帳 BANK_CARD:銀行卡 | 20160427210604000490 |
state | 必填。傳輸狀態 0:訂單生成 1:轉帳正在進行中 2:轉帳成功 3:轉帳失敗 4:轉帳關閉 | 2 |
accountNo | 必填 wxpay:openID alipay:登入帳號 | o6BcIwvTvIqf1zXZohc61biryWik |
accountName | 如果填寫,姓名就會被驗證,否則不會被驗證。 | 張三 |
bankName | 目前僅供記錄 | 中國工商銀行 |
transferDesc | 轉帳備註資訊 | 測試 |
channelOrderNo | 對應通道的轉帳單號,比如支付宝的订单号 | 20160427210604000490 |
errCode | 通道返回錯誤碼 | 1002 |
errMsg | 通道回傳錯誤描述 | 134586944573118714 |
extraParam | 商家擴充參數,回呼時原樣返回 | 134586944573118714 |
createdAt | 必填。訂單建立時間,13位時間戳 | 1622016572190 |
successTime | 轉帳成功時間,13位時間戳 | 1622016572190 |
reqTime | 必填。请求发送時間,13位時間戳 | 1622016572133 |
sign | 必填。回调消息签名 | C380BEC2BFD727A4B6845133519F3AD6 |
範例:
{
"accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
"amount": 1,
"appId": "6113805e42020495c62bd4cb",
"createdAt": 1628818820011,
"currency": "CNY",
"entryType": "WX_CASH",
"errCode": "OPENID_ERROR",
"errMsg": "openid mismatch with appid",
"ifCode": "wxpay",
"mchNo": "M1623997351",
"mchOrderNo": "1628818820",
"state": 3,
"transferDesc": "test",
"transferId": "T202108130940200100001",
"reqTime": 1628818820011,
"sign": "C380BEC2BFD727A4B6845133519F3AD6"
}