通知接口 API 文档
优质
小牛编辑
142浏览
2023-12-01
通知接口API文档
接口地址:
https://activity.m.duiba.com.cn/confirm/confirm?
使用情景:
兑吧发起虚拟商品充值请求时,没有收到开发者响应或响应"process"时,则订单状态一直为处理中,等待开发者通知响应。
使用说明:
兑吧发起虚拟商品充值请求时,没有收到开发者响应时,兑吧一直等待开发者回调通知。
若超过5分钟
未收到通知,则进入异常超时订单列表,供开发者人工处理。
通知响应成功,则订单成功,进入成功兑换流程,通知响应失败,则订单失败,则进入失败流程。
若开发者发出了回调通知,却没有收到兑吧ok
响应时,开发者需重试5次,每次间隔10分钟。
接口参数说明
输入参数:
参数 | 是否必须 | 参数类型 | 限制长度 | 参数说明 |
---|---|---|---|---|
appKey | yes | string | 255 | 接口appKey,应用的唯一标识 |
orderNum | yes | string | 255 | 兑吧订单号 |
success | yes | string | 255 | 兑换成功(true)/失败(false) |
errorMsg | yes | string | 255 | 本次兑换的失败原因,成功可不填 |
timestamp | yes | long | 20 | 1970-01-01开始的时间戳,毫秒。 |
sign | yes | string | 255 | 签名 |
响应参数:
兑吧处理成功之后,将返回字符串 ok
,除了 ok
之外,其他返回值意味着处理失败或者未收到通知,需重复通知(建议重试5次,每次间隔10分钟)。
响应示例:
成功:ok
失败:{"success":false, "errorMessage":"错误信息"}