商户通过该接口进行交易的创建下单
## 公共参数
### 请求地址
| 环境 | 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|
