高清无码极品精品,国产一级C片免费不卡,国产区精品视频一区二区三区

您的位置：首頁 » 軟件及微信開發

微信支付-掃碼支付-原生支付-統一下單-參數說明

發布于2017/11/08 21:12:44 訪問次數：8321 來源：本站

統一下單

應用場景

除被掃支付場景以外，商戶系統先調用該接口在微信支付服務后臺生成預支付交易單，返回正確的預支付交易回話標識后再按掃碼、JSAPI、APP等不同場景生成交易串調起支付。

接口鏈接

URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder

是否需要證書

不需要

請求參數

字段名	變量名	必填	類型	示例值	描述
公眾賬號ID	appid	是	String(32)	wxd678efh567hg6787	微信分配的公眾賬號ID（企業號corpid即為此appId）
商戶號	mch_id	是	String(32)	1230000109	微信支付分配的商戶號
設備號	device_info	否	String(32)	013467007045764	終端設備號(門店號或收銀設備ID)，注意：PC網頁或公眾號內支付請傳"WEB"
隨機字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	隨機字符串，不長于32位。推薦隨機數生成算法
簽名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	簽名，詳見簽名生成算法
商品描述	body	是	String(32)	Ipad mini 16G 白色	商品或支付單簡要描述
商品詳情	detail	否	String(8192)	Ipad mini 16G 白色	商品名稱明細列表
附加數據	attach	否	String(127)	深圳分店	附加數據，在查詢API和支付通知中原樣返回，該字段主要用于商戶攜帶訂單的自定義數據
商戶訂單號	out_trade_no	是	String(32)	20150806125346	商戶系統內部的訂單號,32個字符內、可包含字母, 其他說明見商戶訂單號
貨幣類型	fee_type	否	String(16)	CNY	符合ISO 4217標準的三位字母代碼，默認人民幣：CNY，其他值列表詳見貨幣類型
總金額	total_fee	是	Int	888	訂單總金額，單位為分，詳見支付金額
終端IP	spbill_create_ip	是	String(16)	123.12.12.123	APP和網頁支付提交用戶端ip，Native支付填調用微信支付API的機器IP。
交易起始時間	time_start	否	String(14)	20091225091010	訂單生成時間，格式為yyyyMMddHHmmss，如2009年12月25日9點10分10秒表示為20091225091010。其他詳見時間規則
交易結束時間	time_expire	否	String(14)	20091227091010	訂單失效時間，格式為yyyyMMddHHmmss，如2009年12月27日9點10分10秒表示為20091227091010。其他詳見時間規則注意：最短失效時間間隔必須大于5分鐘
商品標記	goods_tag	否	String(32)	WXG	商品標記，代金券或立減優惠功能的參數，說明詳見代金券或立減優惠
通知地址	notify_url	是	String(256)	http://www.weixin.qq.com/wxpay/pay.php	接收微信支付異步通知回調地址
交易類型	trade_type	是	String(16)	JSAPI	取值如下：JSAPI，NATIVE，APP，詳細說明見參數規定
商品ID	product_id	否	String(32)	12235413214070356458058	trade_type=NATIVE，此參數必傳。此id為二維碼中包含的商品ID，商戶自行定義。
指定支付方式	limit_pay	否	String(32)	no_credit	no_credit--指定不能使用信用卡支付
用戶標識	openid	否	String(128)	oUpF8uMuAJO_M2pxb1Q9zNjWeS6o	trade_type=JSAPI，此參數必傳，用戶在商戶appid下的唯一標識。openid如何獲取，可參考【獲取openid】。企業號請使用【企業號OAuth2.0接口】獲取企業號內成員userid，再調用【企業號userid轉openid接口】進行轉換

舉例如下：

<xml>
   <appid>wx2421b1c4370ec43b</appid>
   <attach>支付測試</attach>
   <body>JSAPI支付測試</body>
   <mch_id>10000100</mch_id>
   <nonce_str>1add1a30ac87aa2db72f57a2375d8fec</nonce_str>
   <notify_url>http://wxpay.weixin.qq.com/pub_v2/pay/notify.v2.php</notify_url>
   <openid>oUpF8uMuAJO_M2pxb1Q9zNjWeS6o</openid>
   <out_trade_no>1415659990</out_trade_no>
   <spbill_create_ip>14.23.150.211</spbill_create_ip>
   <total_fee>1</total_fee>
   <trade_type>JSAPI</trade_type>
   <sign>0CB01533B8C1EF103065174F50BCA001</sign>
</xml>

注：參數值用XML轉義即可，CDATA標簽用于說明數據不被XML解析器解析。

返回結果

字段名	變量名	必填	類型	示例值	描述
返回狀態碼	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL 此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷
返回信息	return_msg	否	String(128)	簽名失敗	返回信息，如非空，為錯誤原因簽名失敗參數格式校驗錯誤

字段名

變量名

必填

類型

示例值

描述

返回狀態碼

return_code

是

String(16)

SUCCESS

SUCCESS/FAIL

此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷

返回信息

return_msg

否

String(128)

簽名失敗

返回信息，如非空，為錯誤原因

簽名失敗

參數格式校驗錯誤

以下字段在return_code為SUCCESS的時候有返回

字段名	變量名	必填	類型	示例值	描述
公眾賬號ID	appid	是	String(32)	wx8888888888888888	調用接口提交的公眾賬號ID
商戶號	mch_id	是	String(32)	1900000109	調用接口提交的商戶號
設備號	device_info	否	String(32)	013467007045764	調用接口提交的終端設備號，
隨機字符串	nonce_str	是	String(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	微信返回的隨機字符串
簽名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	微信返回的簽名，詳見簽名算法
業務結果	result_code	是	String(16)	SUCCESS	SUCCESS/FAIL
錯誤代碼	err_code	否	String(32)	SYSTEMERROR	詳細參見第6節錯誤列表
錯誤代碼描述	err_code_des	否	String(128)	系統錯誤	錯誤返回的信息描述

以下字段在return_code 和result_code都為SUCCESS的時候有返回

字段名	變量名	必填	類型	示例值	描述
交易類型	trade_type	是	String(16)	JSAPI	調用接口提交的交易類型，取值如下：JSAPI，NATIVE，APP，詳細說明見參數規定
預支付交易會話標識	prepay_id	是	String(64)	wx201410272009395522657a690389285100	微信生成的預支付回話標識，用于后續接口調用中使用，該值有效期為2小時
二維碼鏈接	code_url	否	String(64)	URl：weixin：//wxpay/s/An4baqw	trade_type為NATIVE是有返回，可將該參數值生成二維碼展示出來進行掃碼支付