直连撤销交易请求参数-调用地址
撤销交易说明:
1)仅支持被扫交易的撤销。 使用HTTP协议,POST方式提交。 URL(测试环境): URL(测试环境外网):https://test.wsmsd.cn/sit/api/v3/dcp/trans/cancel URL(生产环境):https://s2.lakala.com/api/v3/dcp/trans/cancel
2) 直连方式和间连方式的撤销交易的本质不一样。对于直连方式的撤销,主要是用于被扫交易未完成或者状态不明时,对交易进行人工结束的操作,账户端可能会发生资金变动,也可能未发生资金变动(视账户端当时交易的状态而定)。
对于间连方式的撤销,由于拉卡拉资金管控的原因,实际上是将该笔撤销视作一笔退款交易处理的。
3)对于直连方式,如果支付成功,不可做撤销处理。对于间连方式,只有支付成功的交易才能撤销,撤销后资金会退还给用户。
4)撤销交易只能撤销当天的交易,当天指按账户端认定的交易时间为当天的交易,不是以自然日零点分界的。调用地址
请求参数
字段名 中文名称 是否必填 类型 说明 merchant_no 商户号 M String(32) 拉卡拉分配的商户号 term_no 终端号 M String(32) 拉卡拉分配的商户号 out_trade_no 商户交易流水号 M String(32) 商户系统唯一 origin_out_trade_no 原商户交易流水号 C String(64) 下单时的商户请求流水号(撤销时origin_out_trade_no,origin_trade_no必送其一) origin_trade_no 原结算渠道方交易流水号 C String(32) 下单成功时,返回的拉卡拉交易流水。 origin_out_trade_no、origin_trade_no至少一个必填,同时存在时优先级顺序如下: origin_trade_no、origin_out_trade_no。 location_info 地址位置信息 M Object 地址位置信息,风控要求必送 location_info字段说明
字段名 中文名称 是否必填 类型 说明 request_ip 请求方IP地址 C String(64) 请求方的IP地址,格式如36.45.36.95
request_ip、base_station、location必须上送一个,建议优先送request_ipbase_station 基站信息 C String(128) 客户端设备的基站信息(主扫时基站信息使用该字段) location 纬度经度 C String(32) 商户终端的地理位置,存在必填 格式:纬度,经度,+表示北纬、东经,-表示南纬、 西经,精度最长支持小数点后9位。举例:+37.123456789,-121.123456789 响应参数
字段名 中文名称 是否必填 类型 说明 out_trade_no 商户交易流水号 M String(32) 请求中的商户请求流水号 trade_no 平台交易流水号 C String(32) 平台交易流水号 acc_trade_no 账户端交易流水号 C String(32) 账户端交易流水号(直连时tradeNo和accTradeNo一致) account_type 钱包类型 String(16) 微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING 微企付:ENTPAY total_amount 交易金额 M String(12) 单位分,整数数字型字符串 trade_time 交易完成时间 M String(14) 交易完成时间yyyyMMddHHmmss 以账户方返回为准 origin_out_trade_no 原商户交易流水号 C String(32) 如果请求中携带,则返回 origin_trade_no 原平台交易流水号 C String(32) 原平台交易流水号 请求报文:
{
"req_time":"20220207142359",
"version":"3.0",
"req_data":{
"merchant_no":"822290070111135",
"term_no":"29034705",
"out_trade_no":"TEST20220215102",
"origin_out_trade_no":"",
"origin_trade_no":"2022021533210005360011",
"location_info":{
"request_ip":"12.34.56.78",
"base_station":"00 6361 58130",
"location":"+37.123456789,-121.123456789"
}
}
}复制响应报文:
{
"code": "DCP00000",
"msg": "成功",
"resp_time": "20220215153829",
"resp_data": {
"out_trade_no": "TEST20220215102",
"trade_no": "2022021533160005370016",
"acc_trade_no": "2022021522001492410502090724",
"account_type": "ALIPAY",
"total_amount": "1",
"trade_time": "20220215153829",
"origin_out_trade_no": "TEST20220215101",
"origin_trade_no": "2022021533210005360011"
}
}
