售后通知接口
优质
小牛编辑
129浏览
2023-12-01
使用场景
针对兑吧后台,开发者自有加钱购商品的售后处理处理操作之后的结果状态通知(仅支持开发者自有商品)。售后完成之后,兑吧通过该接口将售后的结果通知给开发者,开发者跟进售后通知的结果处理判定是否给用户返还积分
接口说明
请求方式 (get请求)
接口地址由开发者提供,当有售后完成订单时兑吧通过接口请求开发者,开发者通过接口接收请求数据并处理请求。
请求参数
参数 | 参数类型 | 是否必须 | 参数说明 |
---|---|---|---|
appKey | string | 是 | 接口appKey,应用的唯一标识 |
uid | string | 是 | 用户唯一性标识,对应唯一一个用户且不可变 |
timestamp | string | 是 | 1970-01-01开始的时间戳,毫秒为单位。 |
orderNum | string | 是 | 兑吧订单号 |
bizId | string | 否 | 开发订单号 |
totalAmount | Integer | 是 | 订单总金额 |
freightAmount | Integer | 是 | 订单运费金额,若无则为0(单位分) |
totalCredits | long | 是 | 订单总积分,若无则为0 |
realPayAmount | Integer | 是 | 用户实付金额,包含运费用户实付金额,包含运费(单位分) |
realPayCredits | long | 是 | 用户实付积分,若无则为0 |
sign | string | 是 | 签名(详见兑吧签名规则【签名规则】 |
refundAmount | Integer | 是 | 实际退款金额(单位分) |
接口响应
开发者服务器端收到通知并处理完成后,请返回纯文本的ok字符串,两边不带空格, 忽略大小写,兑吧在验证到响应为ok后会标记通知成功。
接口处理和重试机制
为了防止因为网络或者接口原因导致开发者没有收到的情况,兑吧会在未收到响应或者响应非 ok 的情况下进行重试,重试的机制是:兑吧会在24小时内最多重试8次通知。通知时间间隔为:2m、10m、10m、1h、2h、6h、15h。