回调通知接口
当订单支付成功后,会通过你发起付款接口填入的notify_url参数网址进行回调。
当你的服务器收到云端的回调请求后,只要返回"success"小写单词字符串(不包括引号),那么云端会认为通知成功,否则还会最多通知 6 次,分别间隔 0s/30s/1分钟/3分钟/5分钟/10分钟/15分钟,注意做好通知去重逻辑,你也可以在后台手动补单。历史回调日志可在后台查看,方便调试。
接口地址:你传入的 notify_url 参数
调用方法:POST
调用参数(注意需要手动urldecode):
字段名称 | 字段类型 | 是否必填 | 说明 |
---|---|---|---|
app_id | int(16) | Y | 应用ID。在后台系统设置页面查看 |
order_sn | string(32) | Y | 云端唯一订单编号 |
out_order_sn | string(32) | Y | 你调用接口时填入的商家订单编号 |
notify_count | int(16) | Y | 通知的次数(包括本次) |
pay_way | string(32) | Y | 支付方式,alipay/wechat/mipay,此值可能和你开始传入的值不同,有时候会使用第三方聚合支付方式 |
price | int(16) | Y | 订单价格(单位为分) |
qr_type | string(32) | Y | 二维码类型。返回值为fixed/business/no_fixed/original,分别为个人版固额二维码/商业版收款码/个人版非固额二维码/原价 |
qr_price | int(16) | Y | 返回的二维码的金额(单位为分)。如果为0或-1表示使用的是不固定金额二维码,具体金额需要用户输入,需要在付款时让用户自己输入 pay_price 的数值 |
pay_price | int(16) | Y | 用户最终应该支付的金额(单位为分),云端将会依靠此金额来区分是哪个用户在支付 |
created_at | string(32) | Y | 订单创建的时间 |
paid_at | string(32) | Y | 用户支付的时间 |
attach | string(255) | Y | 开发者自定义数据,原样返回 |
server_time | string(32) | Y | 服务器时间 |
sign | string(32) | Y | 签名, 将参数 app_id + order_sn + out_order_sn + notify_count + pay_way + price + qr_type + qr_price + pay_price + created_at + paid_at + attach + server_time + app_secret 顺序拼接后md5(32位小写)(纯 value 拼接,不包含 + 号)。注意最后一个参数是app_secret,可在云端系统后台设置页面查看 |