收银台退款

基本信息

Path： 接入方提供

Method： POST

使用说明

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

请求参数

Headers

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

Body

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

请求体内容

名称	类型	是否必须	备注
tradeNo	string	必须	唯一标示一次请求
thirdOrderId	string	必须	旅仓订单号（相对于合作方，旅仓为第三方）
refundTradeNo	string	必须	退款交易号，唯一标识一次退款。
refundAmount	number	必须	退款金额，单位元，两位小数。订单可以多次发起退款，但总金额必须小于支付金额。
tradeTime	string	必须	交易时间，格式yyyy-MM-dd hh:mm:ss
notifyUrl	string	必须	通知旅仓退款结果的地址

返回数据

名称	类型	是否必须	备注
status	integer	非必须	状态码 0: 调用成功 其他值均为：调用失败
msg	string	非必须	失败时的错误描述
data	object	非必须	请求成功时的响应体，和具体业务有关（需解密），后文简称业务响应
├─ refundOrderId	string	非必须	同请求中的refundTradeNo。返回此单号，表示接入方平台受理退款成功。