# 异步支付结果通知
支付成功后,系统会对notifyUrl发出通知,收到通知后,商户业务系统可以更新内部订单状态和其它业务相关的操作。
# 接口链接
该链接是通过统一下单接口提交的参数notifyUrl设置,如果无法访问链接,业务系统将无法接收到支付中心的通知。
# 通知参数
字段名 | 变量名 | 类型 | 示例值 | 描述 |
---|---|---|---|---|
支付订单号 | payOrderId | String(30) | P20160427210604000490 | 支付中心生成的订单号 |
商户ID | mchId | String(30) | 20001222 | 支付中心分配的商户号 |
商户订单号 | mchOrderNo | String(30) | 20160427210604000490 | 商户生成的订单号 |
渠道ID | channelId | String(24) | WX_JSAPI | 见支付渠道参数 |
币种 | currency | String(3) | CAD | 三位货币代码,加币:CAD |
支付金额 | amount | int | 100 | 支付金额,单位分 |
状态 | status | int | 2 | 支付状态, 目前只有一个status:2-支付成功 |
客户端IP | clientIp | String(32) | 210.73.10.148 | 客户端IP地址 |
设备 | device | String(64) | WEB | 终端设备号(门店号或收银设备ID),注意:PC网页或公众号内支付请传”WEB |
商品主题 | subject | String(64) | 测试商品 | 商品主题 |
商品描述信息 | body | String(256) | 测试商品描述 | 商品描述信息 |
渠道订单号 | channelOrderNo | String(64) | wx2016081611532915ae15beab0167893571 | 三方支付渠道订单号 |
扩展参数1 | param1 | String(64) | 支付中心回调时会原样返回(若为微信公众号内部支付,会被替换为"mchOrderId") | |
扩展参数2 | param2 | String(64) | 支付中心回调时会原样返回 | |
支付成功时间 | paySuccTime | long | 精确到毫秒 | |
通知类型 | backType | int | 1 | 通知类型,1-前台通知,2-后台通知 |
签名 | sign | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
# 返回结果
业务系统处理后同步返回给支付中心,返回字符串success
则表示成功,返回非success
则表示处理失败,支付中心会再次通知业务系统。*(通知次数最多4次)
# 主动轮询订单状态
对于没有后台的商家,例如从pos机软件来集成,无法提供notifyUrl来接收订单状态,可以采用主动轮询的方式来查询订单交易是否成功。
查看订单查询接口这里
# 双保险获取订单状态
商家可以选择同时使用notifyUrl和轮询机制来确保能够获取订单交易状态
← 查询订单接口 获取clientIP →