統(tǒng)一下單API(支持單品優(yōu)惠)
應(yīng)用場景
統(tǒng)一下單API接入流程、方式和協(xié)議與原統(tǒng)一下單文檔一致,本節(jié)單獨(dú)針對接入單品優(yōu)惠字段作詳細(xì)介紹。
享受了單品優(yōu)惠的訂單將不能使用原退款接口進(jìn)行部分退款,只能整單退款,或者通過單品優(yōu)惠退款接口進(jìn)行部分退款。詳細(xì)內(nèi)容請見“注意事項”。
接口地址
URL地址:https://api.mch.weixin.qq.com/pay/unifiedorder
URL地址:https://api2.mch.weixin.qq.com/pay/unifiedorder(備用域名)見跨城冗災(zāi)方案
是否需要證書
不需要。
輸入?yún)?shù)
名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
接口版本號 | version | 否 | String(32) | 1.0 | 新增字段,接口版本號,區(qū)分原接口,默認(rèn)填寫1.0。 單品優(yōu)惠:必填,上傳version字段,返回參數(shù)會有差異,詳情參考:《注意事項》 |
商品標(biāo)記 | goods_tag | 否 | String(32) | 訂單優(yōu)惠標(biāo)記,用于區(qū)分訂單是否可以享受優(yōu)惠,字段內(nèi)容在微信后臺配置券時進(jìn)行設(shè)置,說明詳見代金券或立減優(yōu)惠 | |
商品詳情 | detail | 是 | String(6000) | 示例見下文 | 新增字段,單品優(yōu)惠活動該字段必傳,且必須按照規(guī)范上傳,JSON格式,詳見下文【單品優(yōu)惠活動字段說明】 |
其他字段列表見 |
單品優(yōu)惠活動detail字段列表說明:
名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
訂單原價 | cost_price | 否 | int | 608800 | 1.商戶側(cè)一張小票訂單可能被分多次支付,訂單原價用于記錄整張小票的交易金額。 2.當(dāng)訂單原價與支付金額不相等,則不享受優(yōu)惠。 3.該字段主要用于防止同一張小票分多次支付,以享受多次優(yōu)惠的情況,正常支付訂單不必上傳此參數(shù)。 |
商品小票ID | receipt_id | 否 | String(32) | wx123 | 商家小票ID |
單品列表 | goods_detail | 是 | String | 示例見下文 | 單品信息,使用Json數(shù)組格式提交 |
單品優(yōu)惠活動goods_detail字段說明:
名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
商品編碼 | goods_id | 是 | String(32) | 1246464644 | 由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成 |
微信支付商品編碼 | wxpay_goods_id | 否 | String(32) | 1001 | 微信支付定義的統(tǒng)一商品編號(沒有可不傳) |
商品名稱 | goods_name | 否 | String(256) | iPhone6s 16G | 商品的實(shí)際名稱 |
商品數(shù)量 | quantity | 是 | int | 1 | 用戶購買的數(shù)量 |
商品單價 | price | 是 | int | 528800 | 單位為:分。如果商戶有優(yōu)惠,需傳輸商戶優(yōu)惠后的單價(例如:用戶對一筆100元的訂單使用了商場發(fā)的紙質(zhì)優(yōu)惠券100-50,則活動商品的單價應(yīng)為原單價-50) |
detail字段值舉例如下:
{
"cost_price": 608800,
"receipt_id": "wx123",
"goods_detail": [ //注意goods_detail字段的格式為"goods_detail":[{}],較多商戶寫成"goods_detail":{}
{
"goods_id": "1246464644",
"wxpay_goods_id": "1001",
"goods_name": "",
"quantity": 1,
"price": 528800
},
{
"goods_id": "1246464644",
"wxpay_goods_id": "1002",
"goods_name": "iPhone6s 32G",
"quantity": 1,
"price": 608800
}
]
}
提交支付數(shù)據(jù)舉例:
<xml>
<appid>wxdace645e0bc2c424</appid>
<attach>test</attach>
<auth_code>130050378319653252</auth_code>
<body>下單測試</body>
<detail><![CDATA[{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"1246464644","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"1246464644","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}]]></detail>
<device_info>TEST01</device_info>
<goods_tag>MEETING</goods_tag>
<mch_id>1900009001</mch_id>
<nonce_str>4b4f6f692547affd2c8fadb39fed603a</nonce_str>
<out_trade_no>19000090011489146530</out_trade_no>
<spbill_create_ip>14.23.150.211</spbill_create_ip>
<sub_mch_id>11383918</sub_mch_id>
<total_fee>503</total_fee>
<version>1.0</version>
<sign>144FF79B7391FE1BD0708470B7D8A2E3</sign>
<trade_type>JSAPI</trade_type>
</xml>
注:參數(shù)值用XML轉(zhuǎn)義即可,CDATA標(biāo)簽用于說明數(shù)據(jù)不被XML解析器解析。
返回結(jié)果
下單接口返回保持不變:
名稱 | 變量名 | 必填 | 類型 | 示例值 | 描述 |
---|---|---|---|---|---|
其他字段列表見 |