使用场景：创建服务单
接口编号：serviceorderadd
请求参数（bizdata）：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| out_order_no | 商户订单号 |
商户系统内部服务订单号(不是交易单号) 要求32个字符内，只能是数字、大小写字母 且在同一个商户号下唯一 |
否 | String(32) | |
| service_introduction | 服务信息 | 服务信息，用于介绍本订单所提供的服务 | 否 | String(20) | |
| post_payments | 后付费项目 |
后付费项目列表，最多包含100条付费项目， 用于用户侧展示与完结订单时的总金额计算创建订单接口 1.name是选填； 2.若name非空： amount和description， 二者必须填其一，也可同时填写； 完结订单接口： 1. name和amount是必填； |
否 | array | |
| post_discounts | 商户优惠 |
body商户优惠列表，最多包含30条商户优惠， 用于用户侧展示与完结订单时的总金额计算创建订单接口 1.name和description是选填， 但是要填写的话，须同时填写； 完结订单接口： 1.若name和description非空，amount金额必填； 2..优惠项目名称可以重复 3. 订单优惠项目，均以完结订单传入的信息为准； |
是 | array | |
| risk_fund | 服务风险金 | 用于微信支付分对本次服务进行风险评估 | 否 | object | |
| time_range | 服务时间 | 服务时间，用于用户侧展示 | 否 | object | |
| location | 服务位置 | 服务位置，用于用户侧展示 | 是 | object | |
| sub_appid | 子商户的公众号ID |
微信公众平台分配的与传入的子商户商户号 建立了支付绑定关系的AppID |
是 | String(32) | |
| sub_openid | 子商户的用户标识 | 子商户的AppID下的用户标识 | 是 | String(128) | |
| need_user_confirm | 是否需要用户确认 |
false: 不需要; true: 需要确认（默认false） |
是 | boolean | |
| notify_url | 通知地址 | 回调通知地址 | 否 | String(100) | |
| attach | 附加数据 |
附加数据 可作为自定义参数使用 需要先urlencode后传入 |
否 | String(128) |
post_payments的明细字段：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| name | 付费名称 | 不超过20个字符，超出报错处理 | 是 | String(20) | 示例值：就餐费用 |
| amount | 付费金额 | 此付费项目总金额，大于等于0，单位为分，等于0时代表不需要扣费 | 是 | int | |
| description | 付费说明 | 描述计费规则，不超过30个字符，超出报错处理 | 是 | String(30) | 就餐人均100元 |
| count | 付费数量 | 是 | int | 付费项目的数量 |
post_discounts的明细字段：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| name | 优惠名称 | 不超过20个字符，超出报错处理 | 是 | String(20) | 示例值：满20减1元 |
| amount | 优惠金额 | 优惠金额 | 是 | int | |
| description | 优惠说明 | 优惠使用条件说明 | 是 | String(30) | 不与其他优惠叠加 |
| count | 优惠数量 | 是 | int | 优惠项目的个数 |
risk_fund的明细字段：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| name | 风险名称 |
1.【评估不通过：交押金】模式： 由微信支付分指定名称，商户可选择一种： 押金[DEPOSIT] 预付款[ADVANCE] 保证金[CASH_DEPOSIT] （若微信支付分提供的名称，商户均认为不合适，需联系微信支付分新增合适的名称）
2.【评估不通过：拒绝】模式： 默认 ESTIMATE_ORDER_COST [预估订单费用] |
否 | String(30) | DEPOSIT |
| amount | 风险金额 |
1.数字，必须>0（单位分） 2.风险金额≤每个服务ID的风险金额上限。 3.当商户优惠字段为空时，付费项目总金额≤风险金额 (未填写金额的付费项目，视为该付费项目金额为0) |
否 | int | 示例值：10000 |
| description | 风险说明 | 文字，不超过30个字 | 是 | String(30) | 就餐的预估费用 |
time_range的明细字段：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| start_time |
服务开始 时间 |
【用户端展示用途】 | 是 | String(14) |
示例值： 20091225091010 |
|
【创建订单接口：是必填项】 用户下单时确认的服务开始时间 比如用户今天下单，明天开始接受服务 这里指的是明天的服务开始时间 支持三种格式: "yyyyMMddHHmmss"、"yyyyMMdd" 和 "OnAccept" 传入20091225091010表示2009年12月25日9点10分10秒 传入20091225默认认为时间为2009年12月25日0点0分0秒 传入OnAccept表示用户确认订单成功时间为【服务开始时间】 【服务开始时间】不能早于调用接口时间。 |
|||||
| end_time |
服务结束 时间 |
是 | String(14) |
示例值： 20091225091010 |
|
| start_time_remark |
服务开始 时间备注 |
是 | String(20) | ||
| end_time_remark |
服务结束 时间备注 |
是 | String(20) |
location的明细字段：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| start_location | 服务开始地点 |
开始使用服务的地点. 不超过50个字符，超出报错处理； 接口选填说明： 1.创建订单接口：可填入； 2. 完结订单接口：不填写； |
是 | String(50) |
示例值： 嗨客时尚主题展餐厅 |
| end_location | 服务结束地点 | 结束使用服务的地点. 不超过50个字符，超出报错处理 | 是 | String(50) |
示例值： 嗨客时尚主题展餐厅 |
响应参数（bizrsp）：
| 参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
|---|---|---|---|---|---|
| out_order_no | 商户订单号 |
商户系统内部服务订单号（不是交易单号） 要求32个字符内，只能是数字、大小写字母 且在同一个商户号下唯一 |
否 | String(32) | |
| chnl_order_no |
渠道服务 单号 |
渠道服务单号（不是交易单号）对应微信端的商户单号 | 否 | String(32) | |
| service_introduction | 服务信息 | 服务信息，用于介绍本订单所提供的服务 | 否 | String(20) | |
| sub_appid |
子商户公 众号ID |
子商户公众号AppID | 是 | String(32) | |
| sub_mchid |
子商户商 户号 |
否 | String(32) | ||
| sub_openid |
子商户的用 户标识 |
子商户的AppID下的用户标识 | 是 | String(128) | |
| channel_id |
渠道商商 户号 |
否 | String(32) | ||
| state |
服务订单 状态 |
CREATED: 服务订单已创建 DOING: 服务订单进行中 DONE: 服务订单已完成 REVOKED: 商户取消服务订单 EXPIRED: 服务订单已失效 "CREATED"状态超过1小时未变动，则订单失效 示例值：CREATED |
否 | String(32) | |
| state_description |
订单状态 说明 |
对服务订单"DOING"状态的附加说明. USER_CONFIRM: 用户确认 MCH_COMPLETE：商户完结 示例值：MCH_COMPLETE |
是 | String(32) | |
| post_payments |
后付费项 目 |
后付费项目列表，最多包含100条付费项目， 用于用户侧展示与完结订单时的总金额计算创建订单接口 1.name是选填； 2. 若name非空： amount和description 二者必须填其一，也可同时填写； 完结订单接口： 1. name和amount是必填； |
否 | array | |
| post_discounts | 商户优惠 |
body商户优惠列表 最多包含30条商户优惠 用于用户侧展示与完结订单时的总金额计算创建订单接口 1.name和description是选填 但是要填写的话，须同时填写； 完结订单接口： 1.若name和description非空，amount金额必填； 2. 优惠项目名称可以重复 3. 订单优惠项目，均以完结订单传入的信息为准； |
是 | array | |
| risk_fund |
服务风险 金 |
用于微信支付分对本次服务进行风险评估 | 否 | object | |
| time_range | 服务时间 | 服务时间，用于用户侧展示 | 否 | object | |
| location | 服务位置 | 服务位置，用于用户侧展示 | 是 | object | |
| order_id |
微信支付 服务订单 号 |
微信支付服务订单号， 每个微信支付服务订单号与商户号下 对应的商户订单号一一对应 |
是 | String(64) | |
| package |
跳转微信 侧数据包 |
确认订单流程，商户前端跳转到微信侧传入的数据包 | 是 | String(1024) | |
| need_user_confirm |
是否需要 用户确认 |
false: 不需要; true: 需要确认（默认true） |
是 | boolean | |
| notify_url | 通知地址 | 回调通知地址 | 否 | String(100) | |
| attach | 附加数据 |
附加数据 可作为自定义参数 使用需要先urlencode后传入 |
否 | String(128) | |
| order_sign |
服务单信 息签名 |
用于客户的app、小程序调起支付分服务单详情页 | 否 | String(1024) | json字符串 |
其中order_sign的字段如下：
| 参数 | 参数名称 | 类型 | 可空 | 备注 |
|---|---|---|---|---|
| 商户号 | mchid | string(32) | 否 | 调用接口提交的商户号。示例值：1230000109 |
| 商户服务订单号 | out_order_no | string(32) | 否 | 调用接口提交的商户服务订单号。示例值：1234323JKHDFE1243252 |
| 服务ID | service_id | string(32) | 否 | 调用该接口提交的服务ID。示例值：500001 |
| 时间戳 | timeStamp | string(32) | 否 | 生成签名时间戳，单位秒 |
| 随机字符串 | nonceStr | string(32) | 否 | 生成签名随机字符串，有数字，大小写字母组成，长度不超过32位 |
| 签名方式 | signType | string(32) | 否 | 签名类型，仅支持HMAC-SHA256 |
| 签名 | paySign | string(64) | 否 |
使用字段mch id、service id、out order no、timestamp、nonce str、sign type 按照签名生成算法计算得出的签名值。 示例值:029B52F67573D7E3BE74904BF9AEA |