说明:查询交易中,如果返回响应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 | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的终端号 |
| out_trade_no | 商户交易流水号 | C | String(32) | 下单时的商户请求流水号 说明:out_trade_no、trade_no、必有其一。如果存在多个字段上送,优先级顺序如下: trade_no、 out_trade_no |
| trade_no | 拉卡拉交易流水号 | C | String(32) | 拉卡拉交易流水号 |
响应参数
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号(请求接口中商户号) |
| out_trade_no | 商户请求流水号 | M | String(32) | 请求中的商户请求流水号 |
| trade_no | 拉卡拉商户订单号 | M | String(32) | 拉卡拉生成的交易流水 |
| log_no | 拉卡拉对账单流水号 | M | String(14) | trade_no的后14位 |
| trade_main_type | 交易大类 | C | String(32) | PREORDER-主扫,MICROPAY-被扫,REFUND-退款,CANCEL-撤销,无-其它类型 |
| split_attr | 拆单属性 | C | String(1) | 只有涉及合单交易时会出现:M-主单,S-子单 |
| split_info | 拆单信息 | C | List<> | 如果查询订单是主单,则返回。见splitInfo字段说明。拆单信息见split_info域说明 |
| acc_trade_no | 账户端交易订单号 | M | String(32) | 账户端交易流水号 |
| account_type | 钱包类型 | M | String(32) | 微信:WECHAT 支付宝:ALIPAY 银联:UQRCODEPAY 翼支付: BESTPAY 苏宁易付宝: SUNING |
| trade_state | 交易状态 | M | String(16) | INIT-初始化 CREATE-下单成功 SUCCESS-交易成功 FAIL-交易失败 DEAL-交易处理中 UNKNOWN-未知状态 CLOSE-订单关闭 PART_REFUND-部分退款 REFUND-全部退款(或订单被撤销) |
| trade_state_desc | 交易状态描述 | C | String(256) | 交易状态描述 |
| total_amount | 订单金额 | M | String(12) | 单位分,整数数字型字符 |
| payer_amount | 付款人实付金额 | C | String(12) | 付款人实付金额,单位分 |
| acc_settle_amount | 账户端结算金额 | C | String(12) | 账户端应结订单金额,单位分 |
| acc_mdiscount_amount | 商户侧优惠金额(账户端) | C | String(12) | 商户优惠金额,单位分 |
| acc_discount_amount | 账户端优惠金额 | C | String(12) | 拉卡拉优惠金额,单位分 |
| acc_other_discount_amount | 账户端其它优惠金额 | C | String(12) | 账户端返回账户端其它优惠金额,单位分 |
| trade_time | 交易完成时间 | C | String(14) | 实际支付时间。yyyyMMddHHmmss |
| user_id1 | 用户标识1 | C | String(128) | 微信sub_open_id 支付宝buyer_logon_id(买家支付宝账号) |
| user_id2 | 用户标识2 | C | String(128) | 微信openId支 付宝buyer_user_id 银联user_id |
| bank_type | 付款银行 | C | String(128) | 付款银行 |
| card_type | 银行卡类型 | C | String(16) | 00:借记 01:贷记 02:微信零钱 03:支付宝花呗 04:支付宝其他 05:数字货币 06:拉卡拉支付账户 99:未知 |
| acc_activity_id | 活动 ID | C | String(32) | 在账户端商户后台配置的批次 ID |
| trade_req_date | 交易请求日期 | M | String(8) |
|
| acc_resp_fields | 账户端返回信息域 | C | Object | 账户端返回信息域 |
| refund_split_info | 合单退款拆单信息 | C | List<> | 如果查询订单是退款主单,则返回。见refundSplitInfo字段说明。拆单信息见refund_split_info域说明 |
split_info域信息
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| sub_trade_no | 子单交易流水号 | M | String(32) | 子单交易流水号 |
| sub_log_no | 子单对账单流水号 | M | String(14) | 子单对账单流水号 |
| out_sub_trade_no | 外部子交易流水号 | M | String(32) | 商户子交易流水号,商户号下唯一 |
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| merchant_name | 商户名称 | M | String(64) | 商户名称 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的业务终端号 |
| amount | 金额 | M | String(12) | 单位分,整数型字符 |
refund_split_info字段说明
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| out_sub_trade_no | 外部子退款交易流水号 | M | String(32) | 商户子交易流水号,商户号下唯一 |
| merchant_no | 商户号 | M | String(32) | 拉卡拉分配的商户号 |
| term_no | 终端号 | M | String(32) | 拉卡拉分配的业务终端号 |
| refund_amount | 申请退款金额 | M | String(12) | 单位分,整数型字符 |
| sub_trade_no | 拉卡拉子交易流水号 | C | String(32) |
|
| sub_log_no | 对账单子流水号 | C | String(14) | sub_trade_no后14位 |
| trade_state | 子交易状态 | C | String(16) | SUCCESS-交易成功 FAIL-交易失败 |
| result_code | 处理结果码 | C | String(32) |
|
| result_msg | 处理描述 | C | String(128) |
|
支付宝二维码场景下返回acc_resp_fields域内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| user_id | 买家在支付宝的用户id | M | String(64) | buyer_user_id |
| store_id | 商户门店编号 | C | String(32) | 支付宝收单上送 |
| alipay_store_id(不再使用) | 支付宝店铺编号 | C | String(32) | 支付宝已不再使用该字段 |
| fund_bill_list | 交易支付使用的资金渠道 | C | String(512) |
|
| voucher_detail_list | 所有优惠券信息 | C | String(4096) |
|
| hb_fq_pay_info(未上线) | 花呗分期支付信息 | C | Object |
|
| sub_mch_id | 子商户号
| C | String(20) | 账户端子商户号 |
花呗分期支付信息hb_fq_pay_info内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| fq_amount | 分期金额 | M | String(12) | 单位分,整数数字型字符 |
| user_install_num | 分期期数 | M | String(12) | 分期期数,整数数字型字符 |
微信二维码场景下返回acc_resp_fields域内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| open_id | 用户标识 | M | String(64) | 用户在商户appid下的唯一标识 |
| user_id | 用户子标识 | C | String(64) | sub_open_id |
| acc_activity_id | 活动 ID | C | String(32) | 在账户端商户后台配置的批次 ID |
| promotion_detail | 优惠功能信息 | C | String(4096) |
|
| sub_mch_id | 子商户号
| C | String(20) | 账户端子商户号 |
银联二维码场景下返回acc_resp_fields域内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| user_id | 用户id | M | String(64) |
|
| up_iss_addn_data | 银联单品营销 附加数据 | C | String(8000) | 参与单品营销优惠时返回 |
| up_coupon_info | 银联优惠信息/出资方信息 | C | String(500) | 参与单品营销优惠时返回 |
数币场景下返回acc_resp_fields域内容
| 字段名 | 中文名称 | 是否必填 | 类型 | 说明 |
|---|
| trade_info | 出资方信息 | C | String(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": ""
}
}复制