查詢訂單API(支持單品優(yōu)惠)
應(yīng)用場景
上傳參數(shù)version后支持單品營銷功能,同時將取消以下字段返回(轉(zhuǎn)移到新增參數(shù)promotion_detail中,以json方式展示),開發(fā)時請注意:
字段名稱 | 字段說明 |
---|---|
代金券使用數(shù)量(coupon_count) |
取消了該參數(shù)返回,我們將展示每張券的具體信息,商戶可以通過解析promotion_detail參數(shù)來確認(rèn)使用了幾張代金券。 |
總代金券金額(coupon_fee) |
取消了該參數(shù)返回,返回參數(shù)展示了每張券的金額(amount),商戶可以通過累加得出總代金券金額。 |
單個代金券支付金額(coupon_fee_$n) |
與amount對應(yīng) |
代金券類型(coupon_type) |
與type 對應(yīng),COUPON表示普通代金券(原值:CASH),DISCOUNT表示免充值券(原值:NO_CASH) |
代金券id(coupon_id) |
與 promotion_id 對應(yīng) |
應(yīng)結(jié)訂單金額(settlement_total_fee) |
取消了該參數(shù)返回,商戶可以通過現(xiàn)有返回參數(shù)計算出應(yīng)結(jié)訂單金額,應(yīng)結(jié)訂單金額(settlement_total_fee)=訂單總金額(total_fee)-優(yōu)惠類型(type)為免充值券(DISCOUNT)的優(yōu)惠券金額(amount) |
接口鏈接
https://api.mch.weixin.qq.com/pay/orderquery
https://api2.mch.weixin.qq.com/pay/orderquery(備用域名)見跨城冗災(zāi)方案
是否需要證書
不需要
請求參數(shù)
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
接口版本號 | version | 是 | String(32) | 1.0 | 接口版本號(新增字段),區(qū)分原接口,固定填寫1.0,查單接口上傳version后查詢結(jié)果才返回單品信息,不上傳不返回單品信息。 |
其他字段列表見 |
舉例如下:
<xml>
<version>1.0</version>
<appid>wx2421b1c4370ec43b</appid>
<mch_id>10000100</mch_id>
<nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
<transaction_id>1008450740201411110005820873</transaction_id>
<sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>
返回結(jié)果
以下字段在return_code 、result_code、trade_state都為SUCCESS時有返回 。
字段名 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
營銷詳情 | promotion_detail | 是 | String(6000) | 示例見下文 | 新增返回,營銷詳情列表,使返回值為Json格式 |
其他字段列表見 |
單品優(yōu)惠活動promotion_detail字段列表說明:
名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
券ID | promotion_id | 是 | String(32) | 109519 | 券或者立減優(yōu)惠id |
優(yōu)惠名稱 | name | 否 | String(64) | 單品惠-6 | 優(yōu)惠名稱 |
優(yōu)惠范圍 | scope | 否 | String(32) | SINGLE | GLOBAL- 全場代金券 SINGLE- 單品優(yōu)惠 |
優(yōu)惠類型 | type | 否 | String(32) | DISCOUNT | COUPON- 代金券,需要走結(jié)算資金的充值型代金券,(境外商戶券幣種與支付幣種一致) DISCOUNT- 優(yōu)惠券,不走結(jié)算資金的免充值型優(yōu)惠券,(境外商戶券幣種與標(biāo)價幣種一致 |
優(yōu)惠券面額 | amount | 否 | int | 5 | 用戶享受優(yōu)惠的金額(優(yōu)惠券面額=微信出資金額+商家出資金額+其他出資方金額 ) |
活動ID | activity_id | 是 | String(32) | 931386 | 在微信商戶后臺配置的批次ID |
微信出資 | wxpay_contribute | 否 | String(32) | 0 | 特指由微信支付商戶平臺創(chuàng)建的優(yōu)惠,出資金額等于本項優(yōu)惠總金額,單位為分 |
商戶出資 | merchant_contribute | 否 | String(32) | 0 | 特指商戶自己創(chuàng)建的優(yōu)惠,出資金額等于本項優(yōu)惠總金額,單位為分 |
其他出資 | other_contribute | 否 | String(32) | 5 | 其他出資方出資金額,單位為分 |
+商品列表 | goods_detail | 否 | String | 見下文 | 商品信息,使用Json數(shù)組格式提交,字段詳細(xì)說明請點(diǎn)擊行前的+展開 |
promotion_detail字段值舉例如下:
{
"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
}
]
}
]
}
返回數(shù)據(jù)舉例如下:
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx2421b1c4370ec43b]]></appid>
<mch_id><![CDATA[10000100]]></mch_id>
<device_info><![CDATA[1000]]></device_info>
<nonce_str><![CDATA[TN55wO9Pba5yENl8]]></nonce_str>
<sign><![CDATA[BDF0099C15FF7BC6B1585FBB110AB635]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid>
<is_subscribe><![CDATA[Y]]></is_subscribe>
<trade_type><![CDATA[MICROPAY]]></trade_type>
<bank_type><![CDATA[CCB_DEBIT]]></bank_type>
<total_fee>1</total_fee>
<fee_type><![CDATA[CNY]]></fee_type>
<transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
<out_trade_no><![CDATA[1415757673]]></out_trade_no>
<attach><![CDATA[訂單額外描述]]></attach>
<time_end><![CDATA[20141111170043]]></time_end>
<trade_state><![CDATA[SUCCESS]]></trade_state>
<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>
</xml>