直連掃碼交易查詢請求參數-調用地址

拉卡拉2.0 3個月前 ( 11-20 ) 141

說明:查詢交易中,如果返回響應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商戶號MString(32)拉卡拉分配的商戶號
term_no終端號MString(32)拉卡拉分配的商戶號
out_trade_no商戶交易流水號CString(64)下單時的商戶請求流水號
trade_no平臺交易流水號CString(32)平臺交易流水號 說明:out_trade_no、trade_no至少一個必填,同時存在時優先級順序如下: trade_no、out_trade_no。


響應參數

字段名中文名稱是否必填類型說明
out_trade_no商戶交易流水號MString(32)請求中的商戶請求流水號
trade_no平臺交易流水號MString(32)平臺交易流水號
acc_merchant_trade_no賬戶端商戶交易流水號MString(32)賬戶端商戶交易流水號
acc_trade_no賬戶端交易訂單號MString(32)賬戶端交易流水號
account_type錢包類型MString(32)微信:WECHAT 支付寶:ALIPAY 銀聯:UQRCODEPAY 微企付:ENTPAY
trade_type交易類型MString(16)PREORDER-主掃 MICROPAY-被掃 REFUND-退款 CANCEL-撤銷
trade_state交易狀態MString(16)INIT-初始化 CREATE-下單成功 SUCCESS-交易成功 FAIL-交易失敗 DEAL-交易處理中 UNKNOWN-未知狀態 CLOSE-訂單關閉 PART_REFUND-部分退款 REFUND-全部退款 REVOKED-訂單撤銷
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)拉卡拉優惠金額,單位分
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
acc_resp_fields賬戶端返回信息域CObject賬戶端返回信息域


支付寶返回的accRespFields域

字段名說明必選
備注
user_id買家在支付寶的用戶idMString(64)buyer_user_id
alipay_store_id商戶的店鋪編號CString(32)
fund_bill_list交易支付使用的資金渠道CString(4096)
discount_goods_detail單品券優惠的商品優惠信息CString(4096)
voucher_detail_list本交易支付時使用的所有優惠券信息CString(4096)
enterprise_pay_info企業支付信息CString(1024)


微信返回的accRespFields域


字段名說明必選
備注
openidopenidMString(64)
sub_openidsub_openidCString(64)
promotion_detail優惠功能信息CString(4096)

銀聯二維碼返回的accRespFields域

字段名說明必選
備注
user_id用戶idCString(64)
up_iss_addn_data銀聯單品營銷 附加數據CString(8000)參與單品營銷優惠時返回
up_coupon_info銀聯優惠信息/出資方信息CString(500)參與單品營銷優惠時返回



微企付返回的accRespFields域

字段名說明必選
備注
payer微企付付款方信息Cstring
memo附言Cstring(1, 128)
attachment訂單附加信息Cstring(1,255)

微企付payer字段說明(該字段類型為String,非object,值為json字符串,需要加轉義)

字段名說明必選
備注
payer_id微企付openIdCstring(1,128)
payer_bank_sname付款銀行簡稱Cstring(1,64)
payer_acct_last4付款方付款銀行后四位Mstring(4,4)
payer_acct_type付款賬戶類型CenumENTERPRISE 企業賬戶 INDIVIDUAL 個人賬戶
payer_bank_type付款銀行Cstring(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