直连扫码交易查询请求参数-调用地址

拉卡拉2.0 6天前 ( 11-20 19:53 ) 15

说明:查询交易中,如果返回响应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