申请退款接口
更新时间：2021-10-15
申请退款接口
一、背景说明：
1、正常情况下，车机端小程序调用车机端宿主，宿主调用车机端支付SDK，支付SDK调用车联网中台，车联网中台调用收银台。
2、支付成功后，百度收银台给百度车联网中台回调，中台给开发者回调
3、可以退款的开发者应用则需要开发者请求车联网中台申请退款给开发者提供的，非给车机提供
二、共同说明api说明
注意：如果外部人员看不到，需要导出上连接文档
Api共同接口说明V2
三、接口地址
iovpay/v2/opf/applyrefund四、Headers
无五、请求参数
| 参数名 | 类型 | 是否必填 | 最大长度 | 描述 | 实例值 |
|---|---|---|---|---|---|
| refund_type | int | 是 | 1 | 退款类型：1：用户发起退款；2：业务方客服退款；3：业务方服务异常退款 | |
| opf_appid | Int | 是 | - | 开发者在开放平台看到dealId或opf_appid | 1514917884 |
| sign | String | 是 | - | 商户请求参数的签名串，详见签名 | 详见签名与验签 |
| version | String | 是 | 版本 | 1.0 | |
| out_trade_no | String | 是 | 64 | 开发者的订单id | 1069227442364 |
| timestamp | Int | 是 | - | 时间戳 | 123456 |
| apply_refund_money | int | 是 | - | 申请退款的金额，单位为分，1块就是100 | |
| resource_refund_batchid | int | 是 | - | 退款的批次id | |
| sign | String | 是 | RSA签名字符串，该字符串的私钥是开发者自己保存的，公钥提供给车联网开放平台保存，调用此接口时验证签名 |
六、返回结果
整体是json字符串
接口返回固定为下面的结构| 名称 | 类型 | 是否必须 | 最大长度 | 描述 | 实例 |
|---|---|---|---|---|---|
| errno | int | 是 | 返回码 | 0 | |
| errmsg | string | 是 | 返回信息 | ||
| data | object | 是 | 返回数据 | {} | |
| date | string | 否 | 时间 | 2020-09-09 19:38:38 | |
| baidurd | string | 否 | 百度用户后续定位问题字符串 | ||
| 百度内部人员才需要关注 |
errno 返回0表示成功，其他值为失败
data 的值只有成功的时候才会有可能返回，值可为空
baidurd 部分模块没有返回，属于正常
当errno为0时，data里字段如下：| 参数名 | 类型 | 是否必填 | 最大长度 | 描述 | 实例值 |
|---|---|---|---|---|---|
| refundBatchId | String | 是 | - | 退款批次号 | - |
| refundPayMoney | String | 是 | - | 申请退款金额 | - |