直連退貨-請求參數-調用地址
調用地址
使用HTTP協議,POST方式提交。 URL(測試環境): URL(測試環境外網): https://test.wsmsd.cn/sit/api/v3/dcp/trans/refund URL(生產環境):https://s2.lakala.com/api/v3/dcp/trans/refund請求參數
字段名 中文名稱 是否必填 類型 說明 merchant_no 商戶號 M String(32) 拉卡拉分配的商戶號 term_no 終端號 M String(32) 拉卡拉分配的商戶號 out_trade_no 商戶交易流水號 M String(32) 商戶系統唯一,不要重復 refund_amount 退款金額 M String(12) 單位分,整數數字型字符 refund_reason 退款原因 C 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 平臺交易流水號 M String(32) 平臺交易流水號 acc_trade_no 賬戶端交易訂單號 C String(32) 賬戶端交易流水號 account_type 錢包類型 C String(32) 微信:WECHAT 支付寶:ALIPAY 銀聯:UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING 微企付:ENTPAY total_amount 交易金額 M String(12) 單位分,整數數字型字符串 refund_amount 申請退款金額 M String(12) 單位分,整數數字型字符串 payer_amount 實際退款金額 M String(12) 單位分,整數數字型字符串 trade_time 退款時間 C String(14) 實際退款時間。yyyyMMddHHmmss origin_trade_no 原平臺交易流水號 C String(32) 如果請求中攜帶,則返回 origin_out_trade_no 原商戶請求流水號 C String(32) 如果請求中攜帶,則返回 請求報文:
{
"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"
}
}
}復制響應報文:
{
"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"
}
}
