创建智慧零售订单

接口说明

接口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

订单风险金额,指该笔订单的预估金额
大于0的数字,单位为分
订单风险金额≤每个服务ID的服务风险金额
当【优惠金额】字段为空时,服务ID的服务风险金额需满足:
服务ID的服务风险金额≥付费项目金额之和
微信支付分会评估用户是否可以使用此额度的智慧零售权益。若评估通过,可进入下一步流程;若评估不通过,将创建订单失败。

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"
}

返回结果

状态码 含义 描述
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"
}

错误码