查询订单API(支持单品优惠)

更新时间：2024.11.18

应用场景

上传参数version后支持单品营销功能，同时将取消以下字段返回（转移到新增参数promotion_detail中，以json方式展示），开发时请注意：

字段名称	字段说明
代金券使用数量（coupon_count）	取消了该参数返回，我们将展示每张券的具体信息，商户可以通过解析promotion_detail参数来确认使用了几张代金券。
总代金券金额（coupon_fee）	取消了该参数返回，返回参数展示了每张券的金额（amount），商户可以通过累加得出总代金券金额。
单个代金券支付金额（coupon_fee_$n）	与amount对应
代金券类型（coupon_type）	与type 对应，COUPON表示普通代金券（原值：CASH），DISCOUNT表示免充值券（原值：NO_CASH）
代金券id（coupon_id）	与 promotion_id 对应
应结订单金额（settlement_total_fee）	取消了该参数返回，商户可以通过现有返回参数计算出应结订单金额，应结订单金额（settlement_total_fee）=订单总金额（total_fee）-优惠类型（type）为免充值券（DISCOUNT）的优惠券金额（amount）

接口链接

https://api.mch.weixin.qq.com/pay/orderquery

https://api2.mch.weixin.qq.com/pay/orderquery(备用域名)见跨城冗灾方案

是否需要证书

不需要

请求参数

字段名	变量名	必填	类型	示例值	描述
接口版本号	version	是	String(32)	1.0	接口版本号（新增字段），区分原接口，固定填写1.0，查单接口上传version后查询结果才返回单品信息，不上传不返回单品信息。
其他字段列表见查询订单API（普通商户）查询订单API（服务商）

字段名

变量名

必填

类型

示例值

描述

接口版本号

version

是

String(32)

1.0

接口版本号（新增字段），区分原接口，固定填写1.0，查单接口上传version后查询结果才返回单品信息，不上传不返回单品信息。

其他字段列表见

查询订单API（普通商户）

查询订单API（服务商）

举例如下：

1<xml>
2   <version>1.0</version>
3   <appid>wx2421b1c4370ec43b</appid>
4   <mch_id>10000100</mch_id>
5   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
6   <transaction_id>1008450740201411110005820873</transaction_id>
7   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
8</xml>

返回结果

以下字段在return_code 、result_code、trade_state都为SUCCESS时有返回。

字段名	变量名	必填	类型	示例值	描述
营销详情	promotion_detail	是	String(6000)	示例见下文	新增返回，营销详情列表，使返回值为Json格式
其他字段列表见查询订单API（普通商户）查询订单API（服务商）

字段名

变量名

必填

类型

示例值

描述

营销详情

promotion_detail

是

String(6000)

示例见下文

新增返回，营销详情列表，使返回值为Json格式

其他字段列表见

查询订单API（普通商户）

查询订单API（服务商）

单品优惠活动promotion_detail字段列表说明：

名称

变量名

必填

类型

示例值

描述

券ID

promotion_id

是

String(32)

109519

券或者立减优惠id

优惠名称

name

否

String(64)

单品惠-6

优惠名称

优惠范围

scope

否

String(32)

SINGLE

GLOBAL- 全场代金券

SINGLE- 单品优惠

优惠类型

type

否

String(32)

DISCOUNT

COUPON- 代金券，需要走结算资金的充值型代金券,（境外商户券币种与支付币种一致）

DISCOUNT- 优惠券，不走结算资金的免充值型优惠券，（境外商户券币种与标价币种一致

优惠券面额

amount

否

int

用户享受优惠的金额（优惠券面额=微信出资金额+商家出资金额+其他出资方金额）

活动ID

activity_id

是

String(32)

931386

在微信商户后台配置的批次ID

微信出资

wxpay_contribute

否

String(32)

特指由微信支付商户平台创建的优惠，出资金额等于本项优惠总金额，单位为分

商户出资

merchant_contribute

否

String(32)

特指商户自己创建的优惠，出资金额等于本项优惠总金额，单位为分

其他出资

other_contribute

否

String(32)

其他出资方出资金额，单位为分

商品列表

goods_detail

否

String

见下文

商品信息，使用Json数组格式提交,字段详细说明请点击行前的+展开

商品列表

promotion_detail字段值举例如下：

1{
2    "promotion_detail":[
3        {
4            "promotion_id":"109519",
5            "name":"单品惠-6",
6            "scope":"SINGLE",
7            "type":"DISCOUNT",
8            "amount":5,
9            "activity_id":"931386",
10            "wxpay_contribute":0,
11            "merchant_contribute":0,
12            "other_contribute":5,
13            "goods_detail":[
14                {
15                    "goods_id":"a_goods1",
16                    "goods_remark":"商品备注",
17                    "quantity":7,
18                    "price":1,
19                    "discount_amount":4
20                },
21                {
22                    "goods_id":"a_goods2",
23                    "goods_remark":"商品备注",
24                    "quantity":1,
25                    "price":2,
26                    "discount_amount":1
27                }
28            ]
29        }
30    ]
31}

返回数据举例如下：

1<xml>
2   <return_code><![CDATA[SUCCESS]]></return_code>
3   <return_msg><![CDATA[OK]]></return_msg>
4   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
5   <mch_id><![CDATA[10000100]]></mch_id>
6   <device_info><![CDATA[1000]]></device_info>
7   <nonce_str><![CDATA[TN55wO9Pba5yENl8]]></nonce_str>
8   <sign><![CDATA[BDF0099C15FF7BC6B1585FBB110AB635]]></sign>
9   <result_code><![CDATA[SUCCESS]]></result_code>
10   <openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid>
11   <is_subscribe><![CDATA[Y]]></is_subscribe>
12   <trade_type><![CDATA[MICROPAY]]></trade_type>
13   <bank_type><![CDATA[CCB_DEBIT]]></bank_type>
14   <total_fee>1</total_fee>
15   <fee_type><![CDATA[CNY]]></fee_type>
16   <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
17   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
18   <attach><![CDATA[订单额外描述]]></attach>
19   <time_end><![CDATA[20141111170043]]></time_end>
20   <trade_state><![CDATA[SUCCESS]]></trade_state>
21   <promotion_detail><![CDATA[{"promotion_detail":[{"promotion_id":"109519","name":"单品惠-6","scope":"SINGLE","type":"DISCOUNT","amount":5,"activity_id":"931386","wxpay_contribute":0,"merchant_contribute":0,"other_contribute":5,"goods_detail":[{"goods_id":"a_goods1","goods_remark":"商品备注","quantity":7,"price":1,"discount_amount":4},{"goods_id":"a_goods2","goods_remark":"商品备注","quantity":1,"price":2,"discount_amount":1}]}]}]]></promotion_detail>
22
23</xml>

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服