退款结果通知
更新时间:2021-10-15
退款结果通知
一、功能描述
退款完成后,车联网会把相关结果发送给交互方,交互方需要接收处理,并返回应答。 当返回中errno为0才被认为通知成功; 如果车联网收到交互方的应答不是成功或超时,车联网认为通知失败,会通过一定的策略定期重新发起通知,尽可能提高通知的成功率 (通知频率为 5/15/30/180/1800/3600,单位:秒)
二、使用说明
API接口说明
三、接口地址
由交互方提供回调地址,建议https
四、请求参数
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 示例 |
---|---|---|---|---|---|
uid | bigint | 是 | - | 百度用户id | 149235070 |
app_id | int | 是 | 应用ID 详见参数说明 | ||
18343001 | |||||
resource_id | int | 否 | 车联网分配资源合作方的开发id,资源合作方必填 | 18343002 | |
timestamp | string | 是 | 10 | 发送请求时间戳 | 1514917884 |
sign | string | 是 | 请求参数的签名串,详见签名 | ||
order_id | string | 否 | 64 | 车联网订单id | 1069227442364 |
out_trade_no | string | 否 | 64 | 商户订单号,64个字符以内、只能包含字母、数字、下划线;需保证在应用内不重复 | |
order_id和out_trade_no必须存在一个 | 900020199 | ||||
refund_time | int | 是 | 退款时间,时间戳到秒 | ||
refund_ret | int | 是 | - | 退款结果: | |
1:退款成功,2:退款失败 | 1 | ||||
refund_batchid | string | 是 | - | 退款批次号 | 149235070 |
refund_amount | int | 是 | - | 实际退款金额,以分为单位 | 1000 |
resource_refund_batchid | string | 是 | 32 | 资源方退款批次号 |
五、响应参数
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 实例 |
---|---|---|---|---|---|
errno | int | 是 | - | 返回码 | 0 |
errmsg | string | 是 | 64 | 返回信息 | success |
data | string | 是 | - | 返回数据,json格式,此处为空 |
六、请求示例
todo
七、响应示例
todo
八、注意事项
1.该接口的sign值需要交互方用分配车联网平台的公钥进行校验;