直連退貨-請求參數(shù)-調(diào)用地址

拉卡拉 3個(gè)月前 ( 11-20 ) 142

調(diào)用地址

使用HTTP協(xié)議,POST方式提交。

URL(測試環(huán)境):

URL(測試環(huán)境外網(wǎng)): https://test.wsmsd.cn/sit/api/v3/dcp/trans/refund

URL(生產(chǎn)環(huán)境):https://s2.lakala.com/api/v3/dcp/trans/refund


請求參數(shù)

字段名中文名稱是否必填類型說明
merchant_no商戶號(hào)MString(32)拉卡拉分配的商戶號(hào)
term_no終端號(hào)MString(32)拉卡拉分配的商戶號(hào)
out_trade_no商戶交易流水號(hào)MString(32)商戶系統(tǒng)唯一,不要重復(fù)
refund_amount退款金額MString(12)單位分,整數(shù)數(shù)字型字符
refund_reason退款原因CString(32)退款原因
origin_out_trade_no原商戶交易流水號(hào)CString(64)下單時(shí)的商戶請求流水號(hào)(退款時(shí)origin_out_trade_no,origin_trade_no必送其一)
origin_trade_no原交易流水號(hào)CString(32)下單成功時(shí),返回的平臺(tái)交易流水。 origin_out_trade_no、origin_trade_no至少一個(gè)必填,同時(shí)存在時(shí)優(yōu)先級(jí)順序如下: origin_trade_no、origin_out_trade_no。
location_info地址位置信息MObject地址位置信息,風(fēng)控要求必送

location_info字段說明


字段名中文名稱是否必填類型說明
request_ip請求方IP地址CString(64)請求方的IP地址,格式如36.45.36.95
request_ip、base_station、location必須上送一個(gè),建議優(yōu)先送request_ip
base_station基站信息CString(128)客戶端設(shè)備的基站信息(主掃時(shí)基站信息使用該字段)
location維度經(jīng)度CString(32)商戶終端的地理位置,存在必填 格式:緯度,經(jīng)度,+表示北緯、東經(jīng),-表示南緯、 西經(jīng),精度最長支持小數(shù)點(diǎn)后9位。舉例:+37.123456789,-121.123456789


響應(yīng)參數(shù)


字段名中文名稱是否必填類型說明
out_trade_no商戶請求流水號(hào)MString(32)請求中的商戶請求流水號(hào)
trade_no平臺(tái)交易流水號(hào)MString(32)平臺(tái)交易流水號(hào)
acc_trade_no賬戶端交易訂單號(hào)CString(32)賬戶端交易流水號(hào)
account_type錢包類型CString(32)微信:WECHAT 支付寶:ALIPAY 銀聯(lián):UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 微企付:ENTPAY
total_amount交易金額MString(12)單位分,整數(shù)數(shù)字型字符串
refund_amount申請退款金額MString(12)單位分,整數(shù)數(shù)字型字符串
payer_amount實(shí)際退款金額MString(12)單位分,整數(shù)數(shù)字型字符串
trade_time退款時(shí)間CString(14)實(shí)際退款時(shí)間。yyyyMMddHHmmss
origin_trade_no原平臺(tái)交易流水號(hào)CString(32)如果請求中攜帶,則返回
origin_out_trade_no原商戶請求流水號(hào)CString(32)如果請求中攜帶,則返回


請求報(bào)文

{
    "req_time":"20220207144026",
    "version":"3.0",
    "req_data":{
        "merchant_no":"822290070111135",
        "term_no":"29034705",
        "refund_amount":"1",
        "out_trade_no":"TEST20220215104",
        "refund_reason":"",
        "origin_trade_no":"2022021533210005360014",
        "origin_out_trade_no":"",
        "location_info":{
            "request_ip":"127.0.0.1",
            "base_station":"00 6361   58130",
            "location":"+37.123456789,-121.123456789"
        }
    }
}復(fù)制


響應(yīng)報(bào)文:

{
    "code": "DCP00000",
    "msg": "成功",
    "resp_time": "20220215154315",
    "resp_data": {
        "out_trade_no": "TEST20220215104",
        "trade_no": "2022021533160005370018",
        "acc_trade_no": "2022021522001492410502090259",
        "account_type": "ALIPAY",
        "total_amount": "1",
        "refund_amount": "1",
        "payer_amount": "1",
        "trade_time": "20220215154314",
        "origin_trade_no": "2022021533210005360014",
        "origin_out_trade_no": "TEST20220215103"
    }
}


The End