## 提交预支付购物订单(orderCreate) >[info] 场景说明:创建预支付购物订单获取商户业务订单号,下一步进入收银台结算 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/order/create ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | otype | string | 必须 | 订单类型,取值:"normal"=普通订单、"meal"=搭配购订单、"teambuy"=拼团订单、"guidebuy"=社区团购订单 | | addr\_id | integer | 可选 | 收货地址ID,由于收货地址与运费计算有关,建议传该值 | | region\_id | integer | 可选 | 收货地址末级地区ID,当不传addr\_id时必须 | | consignee | string | 可选 | 收货人姓名,当不传addr\_id时必须 | | phone\_mob | string | 可选 | 收货人手机号,当不传addr\_id时必须 | | address | string | 可选 | 收货人详细地址(不含省市区),当不传addr\_id时必须 | | delivery\_type | object | 必须 | 物流配送类型,目前取值有:express、ems、post。格式如:{卖家ID:物流配送类型},例子:{2:'express',4:'ems'} | | postscript | object | 可选 | 买家下单留言,格式如:{卖家ID:留言内容},例子:{2:'送到家',4:'包装好一些'} | | coupon\_sn | object | 可选 | 买家使用的优惠券,格式如:{卖家ID:优惠券号},例子:{2:'02660090',4:'02660091'} | | anonymous | object | 可选 | 是否匿名购买,1=匿名、0=不匿名。格式如:{卖家ID:1},例子:{2:1,4:0} | | exchange\_integral | decimal | 可选 | 使用多少积分抵扣 | | specs | json | 可选 | 购买的商品SKUID组合,格式如:JSON.stringify(\[{spec\_id1: quantity1},{spec\_id2: quantity2}\]),当otype="meal" 和 otype="guidebuy" 时有效 | | \+ extraParams | array | 可选 | 其他参数 | | └ meal\_id | integer | 可选 | 搭配购活动ID,当otype="meal"时必须 | | └ spec\_id | integer | 可选 | 商品SKUID,当otype="teambuy"时必须 | | └ quantity | integer | 可选 | 购买数量,当otype="teambuy"时必须 | | └ teamid | string | 可选 | 参团关联ID,当otype="teambuy"时有效 | | └ shopid | integer | 可选 | 自提门店ID,当 otype="guidebuy"时必须 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "otype": "normal", "addr_id: 3, "delivery_type": { 2: "express", 4: "ems" }, "postscript": { 2: "送到家", 4: "包装好一些" }, "coupon_sn": { 2: "02660090", 4: "" }, anonymous: { 2: 1, 4: 1 }, "exchange_integral": 100 } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有指定用返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | bizOrderId | string | 必须 | 商户业务订单号,如果是支付多个订单,则用半角逗号隔开 | | bizIdentity | string | 必须 | 订单业务类型,具体参考:[订单业务类型代码](order-code.md) | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "bizOrderId": "15993522370474142,15356982370473980", "bizIdentity": "trade10001" } } ```