Skip to content

退款状态查询

基本信息

Path: 接入方提供

Method: POST

使用说明

  • 建议按以下实现,减少双方联调工作量

请求参数

Headers

参数名称参数值是否必须示例备注
Content-Typeapplication/json
x-lvcang-api-accountString用户账号

Body

名称类型是否必须备注
tokenstring必须收银台分配给旅仓的标识,能识别出是旅仓在请求即可
randomstring必须随机数,唯一
timestampstring必须10位时间戳。若请求发起时间与平台服务端接受请求的时间相差过大,平台将直接拒绝本次请求。
paramstring必须请求体内容,请求参数JSON序列化后进行加密

请求体内容

名称类型是否必须备注
refundTradeNostring必须退款交易号,申请退款时传入
thirdOrderIdstring必须旅仓订单号(相对于合作方,旅仓为第三方)

返回数据

名称类型是否必须备注
statusinteger非必须状态码 0: 调用成功 其他值均为:调用失败
msgstring非必须失败时的错误描述
dataobject非必须请求成功时的响应体,和具体业务有关(需解密),后文简称业务响应
├─ refundTradeNostring必须退款交易号,申请退款时传入
├─ thirdOrderIdstring必须旅仓订单号(相对于合作方,旅仓为第三方)
├─ refundStatusinteger必须退款状态 0-退款中 1-退款成功 2-退款失败
├─ refundTimestring非必须退款完成时间 yyyy-MM-dd HH:mm:ss
├─ refundAmountstring必须退款金额