创建智慧零售订单
接口说明
| 接口url | https://api.mch.weixin.qq.com/v3/payscore/smartretail-orders |
|---|---|
请求方式 |
POST |
前置条件
无
请求参数
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| appid | string(32) | 是 | wxd678efh567hg6787 | 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid，可在公众平台查看绑定关系.需要在本系统先进行配置. |
| out_order_no | string(32) | 是 | 1234323JKHDFE1243252 | 商户系统内部服务订单号（不是交易单号），要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。详见商户订单号 |
| service_id | string(32) | 是 | 500001 | 该服务ID有本接口对应产品的权限 |
| service_start_time | string(14) | 是 | 20091225091010 | 用户下单时确认的服务开始时间（比如用户今天下单，明天开始接受服务，这里指的是明天的服务开始时间）. 支持三种格式:yyyyMMddHHmmss和yyyyMMdd和“OnAccept” 传入20091225091010表示2009年12月25日9点10分10秒 传入20091225默认时间为2009年12月25日0点0分0秒 传入OnAccept表示用户确认订单成功时间为【服务开始时间】 【服务开始时间】不能早于调用接口时间。 |
| service_end_time | string(14) | 否 | 20091225091210 | 用户下单时确定的预计服务结束时间，如果超出此时间服务方还未完结订单，用户的本订单将会进入待处理状态. 支持两种格式:yyyyMMddHHmmss和yyyyMMdd 传入20091225091010表示2009年12月25日9点10分10秒 传入20091225表示时间为2009年12月25日23点59分59秒 不填表示用户未确定服务结束时间 【预计服务结束时间】需要超过【服务开始时间】. 【预计服务结束时间】需要至少需要比调用接口时间晚一分钟以上(例如:调用接口时间为201808121200,传入的【预计服务结束时间】需要大于201808121201) |
| service_start_location | string(20) | 是 | 嗨客时尚主题展餐厅 | 开始使用服务的地点. 不超过20个字符，超出报错处理 |
| service_end_location | string(20) | 否 | 嗨客时尚主题展餐厅 | 预计服务结束的地点，用户下单时未确认服务结束地点时，可不填写。 不超过20个字符，超出报错处理 |
| service_introduction | string(20) | 是 | 嗨客餐厅用餐 | 服务信息，用于介绍本订单所提供的服务 不超过20个字符，超出报错处理 |
| fees | array | 否 | none | 后付费，最多包含100条付费项目。 参见Fee表格说明 |
| discounts | array | 否 | none | 商户优惠，最多包含5条商户优惠。 参见Discount表格说明 |
| risk_amount | int | 是 | 100000 | 订单风险金额，指该笔订单的预估金额 |
| attach | string(200) | 否 | attach | 商户自定义说明,可存放本订单所需信息. 需要先urlencode后传入. 总长度不大于200字符,超出报错处理. |
| need_user_confirm | bool | 否 | true | true：使用需用户确认订单类型；false：使用免确认订单类型；默认为true |
| openid | string(128) | 否 | oUpF8uMuAJO_M2pxb1Q9zNjWeS6o | 微信用户在商户对应appid下的唯一标识，使用免确认订单类型必须填写，使用需用户确认订单类型不允许填写 |
FEE
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| fee_name | string(20) | 是 | 阿萨姆瓶装奶茶 | 不超过20个字符，超出报错处理，各付费项目名称不能重复 |
| fee_count | int | 否 | 2 | 数量，付费项目数量，大于等于1且小于等于100，不填默认为1 |
| fee_amount | int | 否 | 800 | 金额，大于等于0，单位为分，等于0时代表不需要扣费 |
| fee_desc | string(30) | 否 | 每分钟1元 | 计费说明，不超过30个字符，超出报错处理 不超过30个字符，超出报错处理 【金额】、【计费说明】二者必填其一，也可以同时填写 |
Discount
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| discount_name | string(20) | 否 | 满20减1元 | 不超过20个字符，超出报错处理，各优惠项目名称不能重复 |
| discount_desc | string(30) | 否 | 不与其他优惠叠加 | 不超过30个字符，超出报错处理 在填写【优惠名称】的情况下，【优惠说明】也必须填写 |
请求包体样例：
{
"appid": "wxd678efh567hg6787",
"out_order_no": "1234323JKHDFE1243252",
"service_id": null,
"service_start_time": "20091225091010",
"service_end_time": "20091225091210",
"service_start_location": "嗨客时尚主题展餐厅",
"service_end_location": "嗨客时尚主题展餐厅",
"service_introduction": "嗨客用餐",
"fees": [{
"fee_name": "服务费",
"fee_amount": 40000,
"fee_desc": "每分钟1元"
}],
"discounts": [{
"discount_name": "满20减1元",
"discount_desc": "不与其他优惠叠加"
}],
"risk_amount": 100000,
"attach": "attach"
}
"appid": "wxd678efh567hg6787",
"out_order_no": "1234323JKHDFE1243252",
"service_id": null,
"service_start_time": "20091225091010",
"service_end_time": "20091225091210",
"service_start_location": "嗨客时尚主题展餐厅",
"service_end_location": "嗨客时尚主题展餐厅",
"service_introduction": "嗨客用餐",
"fees": [{
"fee_name": "服务费",
"fee_amount": 40000,
"fee_desc": "每分钟1元"
}],
"discounts": [{
"discount_name": "满20减1元",
"discount_desc": "不与其他优惠叠加"
}],
"risk_amount": 100000,
"attach": "attach"
}
返回结果
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK | 处理成功 |
| 其它 | 异常应答 | 处理失败，详见 接口规则 |
状态码为 200 时 返回以下信息
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| appid | string(32) | 是 | wxd678efh567hg6787 | 调用接口提交的公众账号ID |
| mchid | string(32) | 是 | 1230000109 | 调用接口提交的商户号 |
| out_order_no | string(32) | 是 | 1234323JKHDFE1243252 | 调用接口提交的商户服务订单号 |
| service_id | string(32) | 是 | 500001 | 调用该接口提交的服务ID |
| order_id | string(128) | 是 | 13145646546516 | 微信支付服务订单号 每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 |
| miniprogram_businesstype | string(64) | 是 | wxpayScoreUse | 小程序跳转businessType,在商户小程序跳转到微信侧小程序流程需要用户 |
| miniprogram_appid | string(32) | 是 | wxid15165161145 | 小程序跳转appid，在商户小程序跳转到微信侧小程序流程需要用到 |
| miniprogram_path | string(128) | 是 | /wxvalue | 小程序跳转路径 |
| miniprogram_username | string(128) | 是 | username | 小程序跳转username，在商户APP跳转微信侧小程序流程需要用到 |
| package | string(300) | 是 | package | 用于跳转到微信侧小程序订单数据,跳转到微信侧小程序传入 |
应答样例：
200 Response
{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_order_no": "1234323JKHDFE1243252",
"service_id": "500001",
"order_id": "13145646546516",
"miniprogram_appid": "wxid15165161145",
"miniprogram_path": "/wxvalue",
"miniprogram_username": "username",
"package": "package"
}
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_order_no": "1234323JKHDFE1243252",
"service_id": "500001",
"order_id": "13145646546516",
"miniprogram_appid": "wxid15165161145",
"miniprogram_path": "/wxvalue",
"miniprogram_username": "username",
"package": "package"
}
错误码
参见错误码列表