拉卡拉聚合扫码关单交易只能对主扫支付场景下,未完成的支付交易进行关单
说明:关单交易只能对主扫支付场景下,未完成的支付交易进行关单。
调用地址
使用HTTP协议,POST方式提交。
测试环境:https://test.wsmsd.cn/sit/api/v3/labs/relation/close
生产环境:https://s2.lakala.com/api/v3/labs/relation/close
请求参数
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的商户号 |
| origin_out_trade_no | 原商户交易流水号 | C | String(32) | 下单时商户请求流水号 origin_out_trade_no、origin_trade_no、origin_out_order_source+origin_out_order_no必有其一, 前两者为交易关单,后者为商户订单关单 |
| origin_trade_no | 原交易拉卡拉交易流水号 | C | String(32) | 下单成功时,返回的SAAS生成的交易流水 |
| 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 |
响应参数
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|---|---|---|---|
| origin_trade_no | 原拉卡拉订单号 | M | String(32) | |
| origin_out_trade_no | 原商户请求流水号 | M | String(32) | |
| origin_out_order_source | 原订单外部订单来源 | C | String(16) | |
| origin_out_order_no | 原订单外部商户订单号 | C | String(32) | |
| trade_time | 交易时间 | M | String(14) | 账户端交易时间yyyyMMddHHmmss |
示例
请求报文
{
"req_time": "20210907173330",
"version": "3.0",
"out_org_code": "OP00000003",
"req_data": {
"merchant_no": "822290070111135",
"term_no": "29034705",
"origin_out_trade_no": "order-202307120002",
"origin_trade_no": "",
"location_info": {
"request_ip": "10.176.1.192",
"location": "+37.123456789,-121.123456789"
}
}
}复制响应报文
{
"code": "BBS00000",
"msg": "成功",
"resp_time": "20230712151747",
"resp_data": {
"origin_trade_no": "2023071266210309030625",
"origin_out_trade_no": "order-202307120002",
"origin_out_order_source": "",
"origin_out_order_no": "",
"trade_time": "20230712151747"
}
}复制The End
