直連撤銷交易請(qǐng)求參數(shù)-調(diào)用地址
撤銷交易說明:
1)僅支持被掃交易的撤銷。 使用HTTP協(xié)議,POST方式提交。 URL(測(cè)試環(huán)境): URL(測(cè)試環(huán)境外網(wǎng)):https://test.wsmsd.cn/sit/api/v3/dcp/trans/cancel URL(生產(chǎn)環(huán)境):https://s2.lakala.com/api/v3/dcp/trans/cancel
2) 直連方式和間連方式的撤銷交易的本質(zhì)不一樣。對(duì)于直連方式的撤銷,主要是用于被掃交易未完成或者狀態(tài)不明時(shí),對(duì)交易進(jìn)行人工結(jié)束的操作,賬戶端可能會(huì)發(fā)生資金變動(dòng),也可能未發(fā)生資金變動(dòng)(視賬戶端當(dāng)時(shí)交易的狀態(tài)而定)。
對(duì)于間連方式的撤銷,由于拉卡拉資金管控的原因,實(shí)際上是將該筆撤銷視作一筆退款交易處理的。
3)對(duì)于直連方式,如果支付成功,不可做撤銷處理。對(duì)于間連方式,只有支付成功的交易才能撤銷,撤銷后資金會(huì)退還給用戶。
4)撤銷交易只能撤銷當(dāng)天的交易,當(dāng)天指按賬戶端認(rèn)定的交易時(shí)間為當(dāng)天的交易,不是以自然日零點(diǎn)分界的。調(diào)用地址
請(qǐng)求參數(shù)
字段名 中文名稱 是否必填 類型 說明 merchant_no 商戶號(hào) M String(32) 拉卡拉分配的商戶號(hào) term_no 終端號(hào) M String(32) 拉卡拉分配的商戶號(hào) out_trade_no 商戶交易流水號(hào) M String(32) 商戶系統(tǒng)唯一 origin_out_trade_no 原商戶交易流水號(hào) C String(64) 下單時(shí)的商戶請(qǐng)求流水號(hào)(撤銷時(shí)origin_out_trade_no,origin_trade_no必送其一) origin_trade_no 原結(jié)算渠道方交易流水號(hào) C String(32) 下單成功時(shí),返回的拉卡拉交易流水。 origin_out_trade_no、origin_trade_no至少一個(gè)必填,同時(shí)存在時(shí)優(yōu)先級(jí)順序如下: origin_trade_no、origin_out_trade_no。 location_info 地址位置信息 M Object 地址位置信息,風(fēng)控要求必送 location_info字段說明
字段名 中文名稱 是否必填 類型 說明 request_ip 請(qǐng)求方IP地址 C String(64) 請(qǐng)求方的IP地址,格式如36.45.36.95
request_ip、base_station、location必須上送一個(gè),建議優(yōu)先送request_ipbase_station 基站信息 C String(128) 客戶端設(shè)備的基站信息(主掃時(shí)基站信息使用該字段) location 緯度經(jīng)度 C String(32) 商戶終端的地理位置,存在必填 格式:緯度,經(jīng)度,+表示北緯、東經(jīng),-表示南緯、 西經(jīng),精度最長(zhǎng)支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789 響應(yīng)參數(shù)
字段名 中文名稱 是否必填 類型 說明 out_trade_no 商戶交易流水號(hào) M String(32) 請(qǐng)求中的商戶請(qǐng)求流水號(hào) trade_no 平臺(tái)交易流水號(hào) C String(32) 平臺(tái)交易流水號(hào) acc_trade_no 賬戶端交易流水號(hào) C String(32) 賬戶端交易流水號(hào)(直連時(shí)tradeNo和accTradeNo一致) account_type 錢包類型 String(16) 微信:WECHAT 支付寶:ALIPAY 銀聯(lián):UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 微企付:ENTPAY total_amount 交易金額 M String(12) 單位分,整數(shù)數(shù)字型字符串 trade_time 交易完成時(shí)間 M String(14) 交易完成時(shí)間yyyyMMddHHmmss 以賬戶方返回為準(zhǔn) origin_out_trade_no 原商戶交易流水號(hào) C String(32) 如果請(qǐng)求中攜帶,則返回 origin_trade_no 原平臺(tái)交易流水號(hào) C String(32) 原平臺(tái)交易流水號(hào) 請(qǐng)求報(bào)文:
{
"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"
}
}
}復(fù)制響應(yīng)報(bào)文:
{
"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"
}
}
