售后通知接口

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

使用场景

针对兑吧后台,开发者自有加钱购商品的售后处理处理操作之后的结果状态通知(仅支持开发者自有商品)。售后完成之后,兑吧通过该接口将售后的结果通知给开发者,开发者跟进售后通知的结果处理判定是否给用户返还积分

接口说明

请求方式 (get请求)

接口地址由开发者提供,当有售后完成订单时兑吧通过接口请求开发者,开发者通过接口接收请求数据并处理请求。

请求参数

参数参数类型是否必须参数说明
appKeystring接口appKey,应用的唯一标识
uidstring用户唯一性标识,对应唯一一个用户且不可变
timestampstring1970-01-01开始的时间戳,毫秒为单位。
orderNumstring兑吧订单号
bizIdstring开发订单号
totalAmountInteger订单总金额
freightAmountInteger订单运费金额,若无则为0(单位分)
totalCreditslong订单总积分,若无则为0
realPayAmountInteger用户实付金额,包含运费用户实付金额,包含运费(单位分)
realPayCreditslong用户实付积分,若无则为0
signstring签名(详见兑吧签名规则【签名规则】
refundAmountInteger实际退款金额(单位分)

接口响应

开发者服务器端收到通知并处理完成后,请返回纯文本的ok字符串,两边不带空格, 忽略大小写,兑吧在验证到响应为ok后会标记通知成功。

接口处理和重试机制

为了防止因为网络或者接口原因导致开发者没有收到的情况,兑吧会在未收到响应或者响应非 ok 的情况下进行重试,重试的机制是:兑吧会在24小时内最多重试8次通知。通知时间间隔为:2m、10m、10m、1h、2h、6h、15h。