說明：查詢交易中，如果返回響應CODE為BBS00000，僅表示查到了這筆交易。交易本身的成功與否狀態(tài)，要查看響應報文中的trade_state這個值。
調(diào)用地址
使用HTTP協(xié)議，POST方式提交。
測試環(huán)境：https://test.wsmsd.cn/sit/api/v3/labs/query/tradequery
生產(chǎn)環(huán)境：https://s2.lakala.com/api/v3/labs/query/tradequery
請求參數(shù)
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的終端號 |
| out_trade_no | 商戶交易流水號 | C | String(32) | 下單時的商戶請求流水號 說明：out_trade_no、trade_no、必有其一。如果存在多個字段上送，優(yōu)先級順序如下： trade_no、 out_trade_no |
| trade_no | 拉卡拉交易流水號 | C | String(32) | 拉卡拉交易流水號 |
響應參數(shù)
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| 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) | 只有涉及合單交易時會出現(xiàn)：M-主單，S-子單 |
| split_info | 拆單信息 | C | List<> | 如果查詢訂單是主單，則返回。見splitInfo字段說明。拆單信息見split_info域說明 |
| acc_trade_no | 賬戶端交易訂單號 | M | String(32) | 賬戶端交易流水號 |
| account_type | 錢包類型 | M | String(32) | 微信：WECHAT 支付寶：ALIPAY 銀聯(lián)：UQRCODEPAY 翼支付: BESTPAY 蘇寧易付寶: SUNING |
| trade_state | 交易狀態(tài) | M | String(16) | INIT-初始化 CREATE-下單成功 SUCCESS-交易成功 FAIL-交易失敗 DEAL-交易處理中 UNKNOWN-未知狀態(tài) CLOSE-訂單關閉 PART_REFUND-部分退款 REFUND-全部退款(或訂單被撤銷） |
| trade_state_desc | 交易狀態(tài)描述 | C | String(256) | 交易狀態(tài)描述 |
| total_amount | 訂單金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符 |
| payer_amount | 付款人實付金額 | C | String(12) | 付款人實付金額，單位分 |
| acc_settle_amount | 賬戶端結算金額 | C | String(12) | 賬戶端應結訂單金額，單位分 |
| acc_mdiscount_amount | 商戶側優(yōu)惠金額（賬戶端） | C | String(12) | 商戶優(yōu)惠金額，單位分 |
| acc_discount_amount | 賬戶端優(yōu)惠金額 | C | String(12) | 拉卡拉優(yōu)惠金額，單位分 |
| acc_other_discount_amount | 賬戶端其它優(yōu)惠金額 | C | String(12) | 賬戶端返回賬戶端其它優(yōu)惠金額，單位分 |
| 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 銀聯(lián)user_id |
| bank_type | 付款銀行 | C | String(128) | 付款銀行 |
| card_type | 銀行卡類型 | C | String(16) | 00：借記 01：貸記 02：微信零錢 03：支付寶花唄 04：支付寶其他 05：數(shù)字貨幣 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) | 拉卡拉分配的業(yè)務終端號 |
| amount | 金額 | M | String(12) | 單位分，整數(shù)型字符 |
refund_split_info字段說明
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| out_sub_trade_no | 外部子退款交易流水號 | M | String(32) | 商戶子交易流水號，商戶號下唯一 |
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的業(yè)務終端號 |
| refund_amount | 申請退款金額 | M | String(12) | 單位分，整數(shù)型字符 |
| sub_trade_no | 拉卡拉子交易流水號 | C | String(32) |
|
| sub_log_no | 對賬單子流水號 | C | String(14) | sub_trade_no后14位 |
| trade_state | 子交易狀態(tài) | C | String(16) | SUCCESS-交易成功 FAIL-交易失敗 |
| result_code | 處理結果碼 | C | String(32) |
|
| result_msg | 處理描述 | C | String(128) |
|
支付寶二維碼場景下返回acc_resp_fields域內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| 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 | 所有優(yōu)惠券信息 | C | String(4096) |
|
| hb_fq_pay_info（未上線） | 花唄分期支付信息 | C | Object |
|
| sub_mch_id | 子商戶號
| C | String(20) | 賬戶端子商戶號 |
花唄分期支付信息hb_fq_pay_info內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| fq_amount | 分期金額 | M | String(12) | 單位分，整數(shù)數(shù)字型字符 |
| user_install_num | 分期期數(shù) | M | String(12) | 分期期數(shù)，整數(shù)數(shù)字型字符 |
微信二維碼場景下返回acc_resp_fields域內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| open_id | 用戶標識 | M | String(64) | 用戶在商戶appid下的唯一標識 |
| user_id | 用戶子標識 | C | String(64) | sub_open_id |
| acc_activity_id | 活動 ID | C | String(32) | 在賬戶端商戶后臺配置的批次 ID |
| promotion_detail | 優(yōu)惠功能信息 | C | String(4096) |
|
| sub_mch_id | 子商戶號
| C | String(20) | 賬戶端子商戶號 |
銀聯(lián)二維碼場景下返回acc_resp_fields域內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| user_id | 用戶id | M | String(64) |
|
| up_iss_addn_data | 銀聯(lián)單品營銷 附加數(shù)據(jù) | C | String(8000) | 參與單品營銷優(yōu)惠時返回 |
| up_coupon_info | 銀聯(lián)優(yōu)惠信息/出資方信息 | C | String(500) | 參與單品營銷優(yōu)惠時返回 |
數(shù)幣場景下返回acc_resp_fields域內(nèi)容
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|
| trade_info | 出資方信息 | C | String(512) | 數(shù)字貨幣中行返回示例說明：[{“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": ""
}
}復制
