拉卡拉聚合扫码-退款交易
说明：正在使用本接口的商户，可继续正常使用；因当前接口不再做功能迭代，建议商户对接新退货接口：统一退货
调用地址
使用HTTP协议，POST方式提交
URL(测试环境)： https://test.wsmsd.cn/sit/api/v3/labs/relation/refund
URL(生产环境)：https://s2.lakala.com/api/v3/labs/relation/refund
退款交易
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的商户号 |
| out_trade_no | 商户交易流水号 | M | String(32) | 商户系统唯一 |
| refund_amount | 退款金额 | M | String(12) | 单位分，整数数字型字符 |
| refund_reason | 退款原因 | M | String(32) | 退款原因描述 |
| origin_out_trade_no | 原商户交易流水号 | C | String(32) | 下单时的商户请求流水号（退款时origin_out_trade_no，origin_trade_no，origin_log_no必送其一） |
| origin_trade_no | 原拉卡拉交易流水号 | C | String(32) | 下单成功时，返回的拉卡拉交易流水。 origin_out_trade_no、origin_log_no、origin_trade_no至少一个必填（调用收银台下单接口拉起交易后发起退款时至少要传两个），同时存在时优先级顺序如下： origin_trade_no、origin_log_no、origin_out_trade_no。 |
| origin_log_no | 原对账单流水号 | C | String(14) | 对账单中的交易流水。 origin_out_trade_no、origin_log_no、origin_trade_no至少一个必填（调用收银台下单接口拉起交易后发起退款时至少要传两个，同时存在时优先级顺序如下： origin_trade_no、origin_log_no、origin_out_trade_no。 |
| trade_req_date（待上线） | 交易请求日期 | O | String(8) | 送原商户交易流水号退款时必填 |
| location_info | 地址位置信息 | M | Object | 地址位置信息，风控要求必送 |
location_info字段说明
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| request_ip | 请求方IP地址 | M | String(64) | 请求方的IP地址，存在必填，格式如36.45.36.95 |
| base_station | 基站信息 | C | String(128) | 客户端设备的基站信息（主扫时基站信息使用该字段） |
| location | 维度,经度 | C | String(32) | 商户终端的地理位置，存在必填 格式：纬度,经度，+表示北纬、东经，-表示南纬、 西经，精度最长支持小数点后9位。举例:+37.123456789,-121.123456789 |
响应参数
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号（请求接口中商户号） |
| out_trade_no | 商户请求流水号 | M | String(32) | 请求中的商户请求流水号 |
| trade_no | 拉卡拉退款单号 | M | String(32) | 拉卡拉交易流水号 |
| log_no | 拉卡拉对账单流水号 | M | String(14) | 拉卡拉对账单流水号 |
| acc_trade_no | 账户端交易订单号 | C | String(48) | 账户端交易流水号 |
| account_type | 钱包类型 | C | String(32) | 微信：WECHAT 支付宝：ALIPAY 银联：UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING |
| total_amount | 交易金额 | M | String(12) | 单位分，整数数字型字符串 |
| refund_amount | 申请退款金额 | M | String(12) | 单位分，整数数字型字符串 |
| payer_amount | 实际退款金额 | M | String(12) | 单位分，整数数字型字符串 |
| trade_time | 退款时间 | C | String(14) | 实际退款时间。yyyyMMddHHmmss |
| origin_trade_no | 原拉卡拉订单号 | C | String(32) | 如果请求中携带，则返回 |
| origin_out_trade_no | 原商户请求流水号 | C | String(64) | 如果请求中携带，则返回 |
| up_iss_addn_data | 单品营销 附加数据 | C | String(8000) | 参与单品营销优惠时返回 |
| up_coupon_info | 银联优惠信息、出资方信息 | C | String(500) | 参与单品营销优惠时返回 |
| trade_info | 出资方信息 | C | String(512) | 数字货币中行返回示例说明：[{“fundchannel”:”BOC”,”amount”:”18”}] |
| fund_bill_list | 交易支付使用的资金渠道 | C | String(512) |
示例
请求报文
{
"req_time": "20210907173330",
"version": "3.0",
"out_org_code": "OP00000003",
"req_data": {
"merchant_no": "822290070111135",
"term_no": "29034705",
"out_trade_no": "wxy2021090700003",
"refund_amount": "1",
"refund_reason": "test测试退款",
"origin_out_trade_no": "wxy2021090700001",
"location_info": {
"request_ip": "10.176.1.192",
"location": "+37.123456789,-121.123456789"
}
}
}复制响应报文
{
"msg": "成功",
"resp_time": "20210907173417",
"code": "BBS00000",
"resp_data": {
"out_trade_no": "wxy2021090700003",
"trade_no": "2021090766160003670036",
"log_no": "66160003670036",
"acc_trade_no": "2021090722001449261431458662",
"account_type": "ALIPAY",
"total_amount": "1",
"refund_amount": "1",
"payer_amount": "1",
"trade_time": "20210907173417",
"origin_trade_no": "2021090766210003670031",
"origin_out_trade_no": "wxy2021090700001",
"up_iss_addn_data": "",
"up_coupon_info": "",
"trade_info": ""
}
}复制The End