直连撤销交易请求参数-调用地址

拉卡拉2.0 6天前 ( 11-20 19:52 ) 12

撤销交易说明:

1)仅支持被扫交易的撤销。
2) 直连方式和间连方式的撤销交易的本质不一样。对于直连方式的撤销,主要是用于被扫交易未完成或者状态不明时,对交易进行人工结束的操作,账户端可能会发生资金变动,也可能未发生资金变动(视账户端当时交易的状态而定)。
对于间连方式的撤销,由于拉卡拉资金管控的原因,实际上是将该笔撤销视作一笔退款交易处理的。
3)对于直连方式,如果支付成功,不可做撤销处理。对于间连方式,只有支付成功的交易才能撤销,撤销后资金会退还给用户。
4)撤销交易只能撤销当天的交易,当天指按账户端认定的交易时间为当天的交易,不是以自然日零点分界的。


调用地址

使用HTTP协议,POST方式提交。

URL(测试环境):

URL(测试环境外网):https://test.wsmsd.cn/sit/api/v3/dcp/trans/cancel

URL(生产环境):https://s2.lakala.com/api/v3/dcp/trans/cancel


请求参数

字段名中文名称是否必填类型说明
merchant_no商户号MString(32)拉卡拉分配的商户号
term_no终端号MString(32)拉卡拉分配的商户号
out_trade_no商户交易流水号MString(32)商户系统唯一
origin_out_trade_no原商户交易流水号CString(64)下单时的商户请求流水号(撤销时origin_out_trade_no,origin_trade_no必送其一)
origin_trade_no原结算渠道方交易流水号CString(32)下单成功时,返回的拉卡拉交易流水。 origin_out_trade_no、origin_trade_no至少一个必填,同时存在时优先级顺序如下: origin_trade_no、origin_out_trade_no。
location_info地址位置信息MObject地址位置信息,风控要求必送

location_info字段说明


字段名中文名称是否必填类型说明
request_ip请求方IP地址CString(64)请求方的IP地址,格式如36.45.36.95
request_ip、base_station、location必须上送一个,建议优先送request_ip
base_station基站信息CString(128)客户端设备的基站信息(主扫时基站信息使用该字段)
location纬度经度CString(32)商户终端的地理位置,存在必填 格式:纬度,经度,+表示北纬、东经,-表示南纬、 西经,精度最长支持小数点后9位。举例:+37.123456789,-121.123456789


响应参数


字段名中文名称是否必填类型说明
out_trade_no商户交易流水号MString(32)请求中的商户请求流水号
trade_no平台交易流水号CString(32)平台交易流水号
acc_trade_no账户端交易流水号CString(32)账户端交易流水号(直连时tradeNo和accTradeNo一致)
account_type钱包类型
String(16)微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING 微企付:ENTPAY
total_amount交易金额MString(12)单位分,整数数字型字符串
trade_time交易完成时间MString(14)交易完成时间yyyyMMddHHmmss 以账户方返回为准
origin_out_trade_no原商户交易流水号CString(32)如果请求中携带,则返回
origin_trade_no原平台交易流水号CString(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"
    }
}


The End