通知接口 API 文档

优质
小牛编辑
142浏览
2023-12-01

通知接口API文档

接口地址:

https://activity.m.duiba.com.cn/confirm/confirm?

使用情景:

兑吧发起虚拟商品充值请求时,没有收到开发者响应或响应"process"时,则订单状态一直为处理中,等待开发者通知响应。

使用说明:

兑吧发起虚拟商品充值请求时,没有收到开发者响应时,兑吧一直等待开发者回调通知。
若超过5分钟未收到通知,则进入异常超时订单列表,供开发者人工处理。
通知响应成功,则订单成功,进入成功兑换流程,通知响应失败,则订单失败,则进入失败流程。
若开发者发出了回调通知,却没有收到兑吧ok响应时,开发者需重试5次,每次间隔10分钟。

接口参数说明

输入参数:

参数是否必须参数类型限制长度参数说明
appKeyyesstring255接口appKey,应用的唯一标识
orderNumyesstring255兑吧订单号
successyesstring255兑换成功(true)/失败(false)
errorMsgyesstring255本次兑换的失败原因,成功可不填
timestampyeslong201970-01-01开始的时间戳,毫秒。
signyesstring255签名

响应参数:

兑吧处理成功之后,将返回字符串 ok ,除了 ok 之外,其他返回值意味着处理失败或者未收到通知,需重复通知(建议重试5次,每次间隔10分钟)。

响应示例:

成功:ok
失败:{"success":false, "errorMessage":"错误信息"}