商戶通過該接口進行交易的創建下單
## 公共參數
### 請求地址
| 環境 | 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|