退款状态查询
基本信息
Path: 接入方提供
Method: POST
使用说明
- 建议按以下实现,减少双方联调工作量
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | String | 是 | 用户账号 |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| token | string | 必须 | 收银台分配给旅仓的标识,能识别出是旅仓在请求即可 |
| random | string | 必须 | 随机数,唯一 |
| timestamp | string | 必须 | 10位时间戳。若请求发起时间与平台服务端接受请求的时间相差过大,平台将直接拒绝本次请求。 |
| param | string | 必须 | 请求体内容,请求参数JSON序列化后进行加密 |
请求体内容
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| refundTradeNo | string | 必须 | 退款交易号,申请退款时传入 |
| thirdOrderId | string | 必须 | 旅仓订单号(相对于合作方,旅仓为第三方) |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| status | integer | 非必须 | 状态码 0: 调用成功 其他值均为:调用失败 |
| msg | string | 非必须 | 失败时的错误描述 |
| data | object | 非必须 | 请求成功时的响应体,和具体业务有关(需解密),后文简称业务响应 |
| ├─ refundTradeNo | string | 必须 | 退款交易号,申请退款时传入 |
| ├─ thirdOrderId | string | 必须 | 旅仓订单号(相对于合作方,旅仓为第三方) |
| ├─ refundStatus | integer | 必须 | 退款状态 0-退款中 1-退款成功 2-退款失败 |
| ├─ refundTime | string | 非必须 | 退款完成时间 yyyy-MM-dd HH:mm:ss |
| ├─ refundAmount | string | 必须 | 退款金额 |
