商戶通過該接口進行交易的創建下單 ## 公共參數 ### 請求地址 | 環境 | HTTPS請求地址 | | --- | --- | | 正式環境 | https://open.zoomtk.com/api | ### 公共請求參數 | 參數 | 類型 | 是否必填 | 最大長度 | 描述 | 示例值 | | --- | --- | --- | --- | --- | --- | | app\_id | String | 是 | 32 | 平臺分配給開發者的應用ID | ts5d09fbf1e6b0c| |app\_secret | String | 是 | 64| 平臺分配給開發者的應用TOKEN | d1cb3c7f884504ebf8426ad3ce8a9995| | path| String | 是 | 255 | 接口名稱 | payment/pay/gateway | | format | String | 否 | 40 | 僅支持JSON | JSON | | charset | String | 是 | 10 | 請求使用的編碼格式,僅支持utf-8 | utf-8 | | sign\_type | String | 是 | 10 | 商戶生成簽名字符串所使用的簽名算法類型，目前支持MD5 | sign | String | 是 | 344 | 商戶請求參數的簽名串，詳見[簽名](https://docs.open.alipay.com/291/105974) | 詳見示例 | | timestamp | String | 是 | 19 | 發送請求的時間，格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 | | version | String | 是 | 3 | 調用的接口版本，固定為：1.0 | 1.0 | | JsonData | String | 是 | | 請求參數的集合，最大長度不限，除公共參數外，多接口批量調用時，請求參數已JSON數組放在這個參數中傳遞，與path二選一，path僅支持單接口調用| [{},{}] | ## 請求參數 | 參數 | 類型 | 是否必填 | 最大長度 | 描述 | 示例值 | | --- | --- | --- | --- | --- | --- | |pay_type| String | 必選 | 10 | 支付類型，目前支持 wxpay,alipay | wxpay| |pay_scene| String | 必選 | 10 | 場景屬性，二維碼收單:qrcodepay | qrcodepay| | out\_trade\_no | String | 必選 | 64 | 商戶訂單號,64個字符以內、只能包含字母、數字、下劃線；需保證在商戶端不重復 | 20150320010101001 | |goods_body| String | 必選 | 128 | 對交易或商品的描述：如：產品的商品名稱 |小谷米| |order_amount| String | 必選 | 10 | 收單金額，已分為計算單位，如：100為1元 | 100| |mac_id| String | 必選 | 64| 平臺分配唯一商戶號|1000000| |sup_id| String | 可選（多個授權主體必須）| 64| 商戶平臺商戶號，服務商或多模式下單情況下須填寫|1000000| |notify_url| String | 可選 | 334| 異步接收支付結果通知的回調地址，通知url必須為外網可訪問的url，不能攜帶參數 | http://pay.zoomtk.com/notify_url| |goods_detail| String | 可選| 6000| 訂單包含的商品列表信息，json格式，微信支付參考微信支付[detail]([https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9\_102&index=2](https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_102&index=2))，支付寶支付[goods_detail]([https://docs.open.alipay.com/api\_1/alipay.trade.create/](https://docs.open.alipay.com/api_1/alipay.trade.create/))|\[{"goods\_id":"apple-01","goods\_name":"ipad","goods\_category":"7788230","price":"2000.00","quantity":"1"}\]| |scene_info| String | 可選| 6000| 場景信息：該字段為JSON對象數據，微信支付線下活動，支付寶無效 | {"store\_info" : { "id": "SZTX001", "name": "騰大餐廳", "area\_code": "440305", "address": "科技園中一路騰訊大廈" }}| |attach| String | 可選| 64| 自定義擴展屬性字符串，系統將原樣返回 | | ## 響應參數 | 參數 | 類型 | 是否必填 | 最大長度 | 描述 | 示例值 | | --- | --- | --- | --- | --- | --- | |pay_type| String | 必選 | 10 | 支付類型，wxpay,alipay | wxpay| |pay_scene| String | 必選 | 10 | 場景屬性，二維碼:scan|scan | | out_order_no| String | 必填 | 64 | 商戶訂單號 | 20150423001001 | | order_sn| String | 必填 | 64 | 平臺訂單號 | 20150423001001 | | qrcode_url| String | 必填 | 64 |二維碼收款url | wx:xxxxx| | return_code| String | 必填 | 64 | 狀態碼：10000正常 20000服務不可用 40004處理業務失敗 40006權限不足 40002非法參數 40001缺少必要參數 | 10000| | return_state| String | 必填 | 64 | 狀態 失敗fail 成功：success | success | | return_msg| String | 必填 | 64 | 狀態消息 | ok|