直連掃碼交易查詢請求參數-調用地址
說明:查詢交易中,如果返回響應CODE為DCP00000,僅表示查到了這筆交易。交易本身的成功與否狀態,要查看響應報文中的trade_state這個值。
調用地址
使用HTTP協議,POST方式提交。
URL(測試環境):
URL(測試環境外網):https://test.wsmsd.cn/sit/api/v3/dcp/trans/query
URL(生產環境):https://s2.lakala.com/api/v3/dcp/trans/query
請求參數
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| merchant_no | 商戶號 | M | String(32) | 拉卡拉分配的商戶號 |
| term_no | 終端號 | M | String(32) | 拉卡拉分配的商戶號 |
| out_trade_no | 商戶交易流水號 | C | String(64) | 下單時的商戶請求流水號 |
| trade_no | 平臺交易流水號 | C | String(32) | 平臺交易流水號 說明:out_trade_no、trade_no至少一個必填,同時存在時優先級順序如下: trade_no、out_trade_no。 |
響應參數
| 字段名 | 中文名稱 | 是否必填 | 類型 | 說明 |
|---|---|---|---|---|
| out_trade_no | 商戶交易流水號 | M | String(32) | 請求中的商戶請求流水號 |
| trade_no | 平臺交易流水號 | M | String(32) | 平臺交易流水號 |
| acc_merchant_trade_no | 賬戶端商戶交易流水號 | M | String(32) | 賬戶端商戶交易流水號 |
| acc_trade_no | 賬戶端交易訂單號 | M | String(32) | 賬戶端交易流水號 |
| account_type | 錢包類型 | M | String(32) | 微信:WECHAT 支付寶:ALIPAY 銀聯:UQRCODEPAY 微企付:ENTPAY |
| trade_type | 交易類型 | M | String(16) | PREORDER-主掃 MICROPAY-被掃 REFUND-退款 CANCEL-撤銷 |
| trade_state | 交易狀態 | M | String(16) | INIT-初始化 CREATE-下單成功 SUCCESS-交易成功 FAIL-交易失敗 DEAL-交易處理中 UNKNOWN-未知狀態 CLOSE-訂單關閉 PART_REFUND-部分退款 REFUND-全部退款 REVOKED-訂單撤銷 |
| 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) | 拉卡拉優惠金額,單位分 |
| 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 |
| acc_resp_fields | 賬戶端返回信息域 | C | Object | 賬戶端返回信息域 |
支付寶返回的accRespFields域
| 字段名 | 說明 | 必選 | 備注 | |
|---|---|---|---|---|
| user_id | 買家在支付寶的用戶id | M | String(64) | buyer_user_id |
| alipay_store_id | 商戶的店鋪編號 | C | String(32) | |
| fund_bill_list | 交易支付使用的資金渠道 | C | String(4096) | |
| discount_goods_detail | 單品券優惠的商品優惠信息 | C | String(4096) | |
| voucher_detail_list | 本交易支付時使用的所有優惠券信息 | C | String(4096) | |
| enterprise_pay_info | 企業支付信息 | C | String(1024) |
微信返回的accRespFields域
| 字段名 | 說明 | 必選 | 備注 | |
|---|---|---|---|---|
| openid | openid | M | String(64) | |
| sub_openid | sub_openid | C | String(64) | |
| promotion_detail | 優惠功能信息 | C | String(4096) |
銀聯二維碼返回的accRespFields域
| 字段名 | 說明 | 必選 | 備注 | |
|---|---|---|---|---|
| user_id | 用戶id | C | String(64) | |
| up_iss_addn_data | 銀聯單品營銷 附加數據 | C | String(8000) | 參與單品營銷優惠時返回 |
| up_coupon_info | 銀聯優惠信息/出資方信息 | C | String(500) | 參與單品營銷優惠時返回 |
微企付返回的accRespFields域
| 字段名 | 說明 | 必選 | 備注 | |
|---|---|---|---|---|
| payer | 微企付付款方信息 | C | string | |
| memo | 附言 | C | string(1, 128) | |
| attachment | 訂單附加信息 | C | string(1,255) |
微企付payer字段說明(該字段類型為String,非object,值為json字符串,需要加轉義)
| 字段名 | 說明 | 必選 | 備注 | |
|---|---|---|---|---|
| payer_id | 微企付openId | C | string(1,128) | |
| payer_bank_sname | 付款銀行簡稱 | C | string(1,64) | |
| payer_acct_last4 | 付款方付款銀行后四位 | M | string(4,4) | |
| payer_acct_type | 付款賬戶類型 | C | enum | ENTERPRISE 企業賬戶 INDIVIDUAL 個人賬戶 |
| payer_bank_type | 付款銀行 | C | string(1,64) |
示例
請求報文:
{
"req_time": "20220207143934",
"version": "3.0",
"req_data": {
"merchant_no": "82229005812059B",
"term_no": "A0104508",
"trade_no": "2022020733210004680039",
"out_trade_no": ""
}
}復制響應報文:
{
"code": "DCP00000",
"msg": "成功",
"resp_time": "20220207143938",
"resp_data": {
"out_trade_no": "KFPT20220207143713584583062",
"trade_no": "2022020733210004680039",
"acc_merchant_trade_no": "2022020733210004680039",
"acc_trade_no": "4200001403202202075269807491",
"account_type": "WECHAT",
"trade_state": "SUCCESS",
"trade_state_desc": "交易成功",
"total_amount": "1",
"payer_amount": "1",
"acc_settle_amount": "null",
"acc_mdiscount_amount": "null",
"acc_discount_amount": "null",
"trade_time": "20220207143822",
"user_id1": "olpr-0sYaDrxaT5GmLUnVcDPo",
"user_id2": "oDQJ6hvhXS7De-zmprai7k",
"bank_type": null,
"acc_resp_fields": {
"user_id": null,
"alipay_store_id": null,
"fund_bill_list": null,
"discount_goods_detail": null,
"voucher_detail_list": null,
"promotion_detail": null,
"up_iss_addn_data": null,
"up_coupon_info": null
}
}
}復制The End
