直连扫码交易查询请求参数-调用地址
说明:查询交易中,如果返回响应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
