事中-風(fēng)險(xiǎn)交易通知接口
應(yīng)用場(chǎng)景
推送涉及高風(fēng)險(xiǎn)詐騙(尤其是來(lái)源訂單/客服電話投訴)的風(fēng)險(xiǎn)訂單給銀行.
接口規(guī)則
URL路徑 | 事件通知,url由商戶通過(guò)接口(設(shè)置風(fēng)險(xiǎn)通知回調(diào)鏈接)提供 |
是否需要證書(shū) | 否 |
通知參數(shù)
名稱 |
變量名 |
必填 |
類(lèi)型 |
示例值 |
描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 |
return_code |
是 |
String(16) |
SUCCESS |
SUCCESS/FAIL |
返回信息 |
return_msg |
否 |
String(128) |
返回信息,如非空,為錯(cuò)誤原因 |
以下字段在return_code為SUCCESS的時(shí)候有返回
名稱 |
變量名 |
必填 |
類(lèi)型 |
示例值 |
描述 |
---|---|---|---|---|---|
有風(fēng)險(xiǎn)交易的服務(wù)商號(hào) |
mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的服務(wù)商號(hào) |
有風(fēng)險(xiǎn)交易的商戶號(hào) |
sub_mch_id |
是 |
String(32) |
1900000109 |
微信支付分配的商戶號(hào) |
風(fēng)險(xiǎn)交易的微信訂單號(hào)列表 |
transaction_id_list |
否 |
String(512) |
{"data": ["42000xxx01","42000xxxx02"]} |
Json對(duì)象格式, data里存放風(fēng)險(xiǎn)交易的微信訂單列表。每次最多推送10個(gè)訂單 |
事件單號(hào) |
event_code |
是 |
String(32) |
123456123 |
標(biāo)識(shí)本次回調(diào)事件的單號(hào),接口4同步處理結(jié)果時(shí)需要傳過(guò)來(lái) |
風(fēng)險(xiǎn)級(jí)別 |
risk_level |
是 |
String(32) |
LOW |
LOW:低風(fēng)險(xiǎn) |
風(fēng)險(xiǎn)描述 |
risk_level_desc |
是 |
String(1024) |
低風(fēng)險(xiǎn) |
風(fēng)險(xiǎn)交易相關(guān)的投訴信息 |
隨機(jī)字符串 |
nonce_str |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
隨機(jī)字符串,不長(zhǎng)于32位。 |
簽名 |
sign |
是 |
String(32) |
5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
通過(guò)簽名算法計(jì)算得出的簽名值,詳見(jiàn)簽名生成算法 |
簽名類(lèi)型 |
sign_type |
是 |
String(32) |
HMAC-SHA256 |
簽名類(lèi)型,目前支持HMAC-SHA256 ,該字段需要參與簽名sign計(jì)算。 |
返回參數(shù)
商戶處理后同步返回給微信參數(shù):
字段名 | 變量名 | 必填 | 類(lèi)型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回狀態(tài)碼 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL SUCCESS表示商戶接收通知成功并校驗(yàn)成功 |
返回信息 | return_msg | 否 | String(128) | OK | 返回信息,如非空,為錯(cuò)誤原因: 簽名失敗 參數(shù)格式校驗(yàn)錯(cuò)誤 |
舉例如下:
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
</xml>