虚拟商品兑换通知
支付完成后,淘来云会把相关支付结果及用户信息通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。 由开发者开发好接口后,可在淘来云供货商后台系统直接配置
特别提醒:
1、同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
2、商户系统对于结果通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成损失。
通知url必须为直接可访问的url,不能携带参数。示例:
虚拟商品兑换接口地址
http://example.com/pay
通知参数(GET请求)
参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
---|---|---|---|---|
phone | yes | string | 255 | 用户手机 |
uid | yes | string | 255 | 用户ID |
app_id | yes | string | 255 | 应用ID 应用的唯一标识 |
order_id | yes | string | 255 | 订单编号 |
pd_code | yes | string | 255 | 商品编码 |
pay_points | yes | float | 20 | 支付的积分 |
pay_price | yes | float | 20 | 支付的现金 |
corp_key | yes | string | 255 | sign值的生成规则参考签名规则 |
time_end | yes | string | 255 | 支付完成时间 |
sign | yes | string | 255 | 签名字符串 |
虚拟商品兑换接口地址示例
http://example.com/pay?phone=17335172533&uid=31115733698086017&app_id=10016&order_id=31115733698086017&pd_code=&pay_points=40.00&pay_price=0.00&corp_key=&time_end=1590473440&sign=7af78b79999a62daabd5020b7750e4f0rpkey
接口返回参数:(JSON格式)
参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
---|---|---|---|---|
status | yes | string | 255 | 订单通知接收状态,success或fail |
error_msg | no | string | 255 | 出错原因 |
签名验证工具
为方便开发同学理解签名规则,可以使用下面的淘来云签名工具页面进行验证签名。地址如下:https://www.taolai.com/api/devtools