直連撤銷交易請求參數-調用地址

拉卡拉2.0 3個月前 ( 11-20 ) 115

撤銷交易說明:

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