拉卡拉聚合扫码-交易查询API

卡拉合伙人 6天前 ( 11-13 13:24 ) 41

说明:查询交易中,如果返回响应CODE为BBS00000,仅表示查到了这笔交易。交易本身的成功与否状态,要查看响应报文中的trade_state这个值。

调用地址

使用HTTP协议,POST方式提交。

测试环境:https://test.wsmsd.cn/sit/api/v3/labs/query/tradequery

生产环境:https://s2.lakala.com/api/v3/labs/query/tradequery

请求参数

字段名中文名称是否必填类型说明
merchant_no商户号MString(32)拉卡拉分配的商户号
term_no终端号MString(32)拉卡拉分配的终端号
out_trade_no商户交易流水号CString(32)下单时的商户请求流水号 说明:out_trade_no、trade_no、必有其一。如果存在多个字段上送,优先级顺序如下: trade_no、 out_trade_no
trade_no拉卡拉交易流水号CString(32)拉卡拉交易流水号

响应参数

字段名中文名称是否必填类型说明
merchant_no商户号MString(32)拉卡拉分配的商户号(请求接口中商户号)
out_trade_no商户请求流水号MString(32)请求中的商户请求流水号
trade_no拉卡拉商户订单号MString(32)拉卡拉生成的交易流水
log_no拉卡拉对账单流水号MString(14)trade_no的后14位
trade_main_type交易大类CString(32)PREORDER-主扫,MICROPAY-被扫,REFUND-退款,CANCEL-撤销,无-其它类型
split_attr拆单属性CString(1)只有涉及合单交易时会出现:M-主单,S-子单
split_info拆单信息CList<>如果查询订单是主单,则返回。见splitInfo字段说明。拆单信息见split_info域说明
acc_trade_no账户端交易订单号MString(32)账户端交易流水号
account_type钱包类型MString(32)微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING
trade_state交易状态MString(16)INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款(或订单被撤销)
trade_state_desc交易状态描述CString(256)交易状态描述
total_amount订单金额MString(12)单位分,整数数字型字符
payer_amount付款人实付金额CString(12)付款人实付金额,单位分
acc_settle_amount账户端结算金额CString(12)账户端应结订单金额,单位分
acc_mdiscount_amount商户侧优惠金额(账户端)CString(12)商户优惠金额,单位分
acc_discount_amount账户端优惠金额CString(12)拉卡拉优惠金额,单位分
acc_other_discount_amount账户端其它优惠金额CString(12)账户端返回账户端其它优惠金额,单位分
trade_time交易完成时间CString(14)实际支付时间。yyyyMMddHHmmss
user_id1用户标识1CString(128)微信sub_open_id 支付宝buyer_logon_id(买家支付宝账号)
user_id2用户标识2CString(128)微信openId支 付宝buyer_user_id 银联user_id
bank_type付款银行CString(128)付款银行
card_type银行卡类型CString(16)00:借记 01:贷记 02:微信零钱 03:支付宝花呗 04:支付宝其他 05:数字货币 06:拉卡拉支付账户 99:未知
acc_activity_id活动 IDCString(32)在账户端商户后台配置的批次 ID
trade_req_date交易请求日期MString(8)
acc_resp_fields账户端返回信息域CObject账户端返回信息域
refund_split_info合单退款拆单信息CList<>如果查询订单是退款主单,则返回。见refundSplitInfo字段说明。拆单信息见refund_split_info域说明

split_info域信息

字段名中文名称是否必填类型说明
sub_trade_no子单交易流水号MString(32)子单交易流水号
sub_log_no子单对账单流水号MString(14)子单对账单流水号
out_sub_trade_no外部子交易流水号MString(32)商户子交易流水号,商户号下唯一
merchant_no商户号MString(32)拉卡拉分配的商户号
merchant_name商户名称MString(64)商户名称
term_no终端号MString(32)拉卡拉分配的业务终端号
amount金额MString(12)单位分,整数型字符

refund_split_info字段说明

字段名中文名称是否必填类型说明
out_sub_trade_no外部子退款交易流水号MString(32)商户子交易流水号,商户号下唯一
merchant_no商户号MString(32)拉卡拉分配的商户号
term_no终端号MString(32)拉卡拉分配的业务终端号
refund_amount申请退款金额MString(12)单位分,整数型字符
sub_trade_no拉卡拉子交易流水号CString(32)
sub_log_no对账单子流水号CString(14)sub_trade_no后14位
trade_state子交易状态CString(16)SUCCESS-交易成功 FAIL-交易失败
result_code处理结果码CString(32)
result_msg处理描述CString(128)

支付宝二维码场景下返回acc_resp_fields域内容

字段名中文名称是否必填类型说明
user_id买家在支付宝的用户idMString(64)buyer_user_id
store_id商户门店编号CString(32)支付宝收单上送
alipay_store_id(不再使用)支付宝店铺编号CString(32)支付宝已不再使用该字段
fund_bill_list交易支付使用的资金渠道CString(512)
voucher_detail_list所有优惠券信息CString(4096)
hb_fq_pay_info(未上线)花呗分期支付信息CObject
sub_mch_id子商户号
CString(20)账户端子商户号

花呗分期支付信息hb_fq_pay_info内容

字段名中文名称是否必填类型说明
fq_amount分期金额MString(12)单位分,整数数字型字符
user_install_num分期期数MString(12)分期期数,整数数字型字符

微信二维码场景下返回acc_resp_fields域内容

字段名中文名称是否必填类型说明
open_id用户标识MString(64)用户在商户appid下的唯一标识
user_id用户子标识CString(64)sub_open_id
acc_activity_id活动 IDCString(32)在账户端商户后台配置的批次 ID
promotion_detail优惠功能信息CString(4096)
sub_mch_id子商户号
CString(20)账户端子商户号

银联二维码场景下返回acc_resp_fields域内容

字段名中文名称是否必填类型说明
user_id用户idMString(64)
up_iss_addn_data银联单品营销 附加数据CString(8000)参与单品营销优惠时返回
up_coupon_info银联优惠信息/出资方信息CString(500)参与单品营销优惠时返回

数币场景下返回acc_resp_fields域内容

字段名中文名称是否必填类型说明
trade_info出资方信息CString(512)数字货币中行返回示例说明:[{“fundchannel”:”BOC”,”amount”:”18”}]

示例

请求报文1:

{
    "req_time": "20210907160308",
    "version": "3.0",
    "out_org_code": "OP00000003",
    "req_data": {
        "merchant_no": "822290070111135",
        "term_no": "29034705",
        "out_trade_no": "FD660E1FAA3A4470933CDEDAE1EC1D8E"
    }
}复制

响应报文1:

{
    "msg": "成功",
    "resp_time": "20210907160309",
    "code": "BBS00000",
    "resp_data": {
        "out_trade_no": "FD660E1FAA3A4470933CDEDAE1EC1D8E",
        "trade_no": "2021090766210003630077",
        "log_no": "66210003630077",
        "acc_trade_no": "4200001212202109078945008028",
        "account_type": "WECHAT",
        "settle_term_no": "",
        "trade_state": "SUCCESS",
        "trade_state_desc": "交易成功",
        "total_amount": "123",
        "payer_amount": "123",
        "acc_settle_amount": "123",
        "acc_mdiscount_amount": "0",
        "acc_discount_amount": "",
        "trade_time": "20210907150327",
        "user_id1": "olpr-0kUcyJIbVhYmAsBvoZuB4TI",
        "user_id2": "oUpF8uE150tsN4W00ieTusZcK70s",
        "bank_type": "CMB_CREDIT",
        "acc_activity_id": "",
        "up_coupon_info": "",
        "trade_info": ""
    }
}复制

请求报文2(含合单信息):

{
    "req_time": "20211213173330",
    "version": "3.0",
    "out_org_code": "OP00000003",
    "req_data": {
        "merchant_no": "822290070111135",
        "term_no": "29034705",
        "trade_no": "2021121366210004980005"
    }
}复制

响应报文2:

{
    "msg": "成功",
    "resp_time": "20211213135824",
    "code": "BBS00000",
    "resp_data": {
        "out_trade_no": "1639365213",
        "trade_no": "2021121366210004980005",
        "log_no": "66210004980005",
        "split_attr": "M",
        "split_info": [
            {
                "sub_trade_no": "2021121366210004980003",
                "sub_log_no": "66210004980003",
                "out_sub_trade_no": "20211213000007",
                "merchant_no": "822126090640003",
                "term_no": "47781282",
                "amount": "2"
            },
            {
                "sub_trade_no": "2021121366210004980004",
                "sub_log_no": "66210004980004",
                "out_sub_trade_no": "20211213000008",
                "merchant_no": "822290070111135",
                "term_no": "29034705",
                "amount": "3"
            }
        ],
        "acc_trade_no": "4200001131202112131171130221",
        "account_type": "",
        "settle_merchant_no": "",
        "settle_term_no": "",
        "trade_state": "SUCCESS",
        "trade_state_desc": "交易成功",
        "total_amount": "5",
        "payer_amount": "5",
        "acc_settle_amount": "5",
        "acc_mdiscount_amount": "0",
        "acc_discount_amount": "",
        "trade_time": "20211213111340",
        "user_id1": "olpr-0kQczFJtOMFTvhrpYmQgQ-Q",
        "user_id2": "oUpF8uLvcg9HJ1J588Buj9OZHWYM",
        "bank_type": "OTHERS",
        "acc_activity_id": "",
        "up_coupon_info": "",
        "trade_info": ""
    }
}复制



The End