说明
该接口提供打款结果通知功能。
考虑到大多数打款均能完成,目前仅提供失败通知,且通知仅,若当天打款失败商户数量达到两200个,网商银行将启动应急预案,主动通知合作方,并线下提供失败清单。
打款日当天的上午11点,下午3点,下午6点网商银行向合作方发起打款结果异步通知。基于业务评估和ISV处理能力考虑,只通知打款失败交易,每批次只通知商户最多200笔。
本接口已上线,暂时只对打款失败的交易进行通知,最多只通知200笔。
请求地址
| 环境 | 请求地址 |
|---|---|
| 测试环境 | https://m.umxnt.com/api/mybank/notifyPayResult |
| 正式环境 | https://xy.umxnt.com/api/mybank/notifyPayResult |
请求参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| token | string | 是 | 令牌 | |
| store_id | string | 否 | 门店id |
返回值示例 成功请求示例:
{ "status": 1, "data": { } }
| 参数名 | 参数描述 | 数据类型 | 长度 | 出现要求 | 示例 |
|---|---|---|---|---|---|
| MerchId | 网商商户号 | String | 64 | M | |
| OrderNo | 网商银行内部打款单号 | String | 64 | M | |
| Amount | 打款金额,单位分 | Long | ME | ||
| Ccy | 币种。仅支持156(人民币) | String | 3 | M | 156 |
| PayTime | 打款时间 | Date | |||
| FailedReason | 打款失败原因 | String | 512 | C | |
| Status | 状态。可选值及对照关系:INIT:初始化PROCESSING:发起打款SUCCESS:打款成功FAIL:打款失败CANCEL:取消打款" | String | 20 | M | |
| BizNo | 业务单号 | String | 64 | C | 一般为结算单号 |
失败请求示例
{ "msg":"无效参数", "status":0 }