直连退货-请求参数-调用地址

拉卡拉 6天前 ( 11-20 19:51 ) 16

调用地址

使用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商户号MString(32)拉卡拉分配的商户号
term_no终端号MString(32)拉卡拉分配的商户号
out_trade_no商户交易流水号MString(32)商户系统唯一,不要重复
refund_amount退款金额MString(12)单位分,整数数字型字符
refund_reason退款原因CString(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平台交易流水号MString(32)平台交易流水号
acc_trade_no账户端交易订单号CString(32)账户端交易流水号
account_type钱包类型CString(32)微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING 微企付:ENTPAY
total_amount交易金额MString(12)单位分,整数数字型字符串
refund_amount申请退款金额MString(12)单位分,整数数字型字符串
payer_amount实际退款金额MString(12)单位分,整数数字型字符串
trade_time退款时间CString(14)实际退款时间。yyyyMMddHHmmss
origin_trade_no原平台交易流水号CString(32)如果请求中携带,则返回
origin_out_trade_no原商户请求流水号CString(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"
    }
}


The End