用户申请使用服务时，商户可通过此接口申请创建微信支付分订单。

公共请求参数

参数名 参数描述 类型[长度限制] 必填 备注
method 方法名 string[1,32] 是 SERVICEORDER_CREATE
requestDate 交易日期 string[1,14] 是 格式[yyyyMMddHHmmss]，
如：20190101140908
version 版本 string[1,16] 是 接口版本：1.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
merchantNo 商户号 string[1,16] 是 商户在慧收钱的商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 业务数据 string 是 业务请求参数
sign 签名数据 string[1,128] 否 签名数据

业务请求参数

参数名 参数描述 类型[长度限制] 必填 备注
subMerchantNo 门店编号 string[1,32] 否 商户在支付平台创建生成的门店编号
transNo 商户订单号 string[1,64] 是 商户系统内部订单号保证不重复
goodsInfo 商品信息 string[1,20] 是 商户说明
appid 应用ID string[1,32] 是 示例值：d678efh567hg6787
serviceId 服务ID string[1,32] 是 调用该接口提交的服务ID。 示例值：500001
returnUrl 后台回调地址 string[1,128] 否 服务器主动通知商户服务器的地址
requestDate 交易日期 string[1,14] 是 格式[yyyyMMddHHmmss]，如：20190101140908
extend 商户备用字段 string[1,256] 否 原样返回字段
openid 用户标识 string[1,128] 条件选填 示例值：oUpF8uMuAJO1Q9zNS6o
needUserConfirm 是否需要用户确认 bool 否 枚举值：false：免确认订单 true：需确认订单 默认值true
postPayments 后付费项目 array 否 后付费项目列表，最多包含100条付费项目
postDiscounts 后付费商户优惠 array 否 后付费商户优惠，最多包含30条付费项目。如果传入，用户侧则显示此参数。
riskFund 订单风险金 object 是 订单风险金信息
timeRange 服务时间段 object 是 服务时间范围
location 服务位置 object 否 服务使用信息。如果传入，用户侧则显示此参数。

后付费项目参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 付费项目名称 string[1,20] 否 不超过20个字符，超出报错处理。 示例值：就餐费用, 服务费
amount 金额 int64 条件选填 此付费项目总金额，大于等于0，单位为分，等于0时代表不需要扣费，只能为整数，详见支付金额。 如果填写了“付费项目名称”，则amount或description必须填写其一，或都填。示例值：40000
description 计费说明 string[1,30] 条件选填 描述计费规则，不超过30个字符，超出报错处理。
count 付费数量 int32 否 付费项目的数量。 示例值：4

后付费商户优惠参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 优惠名称 string[1,20] 否 优惠名称说明。
description 优惠说明 string[1,30] 否 优惠使用条件说明。 如果填写了name（优惠名称）和description（优惠说明）其中一个字段内容，则另一个字段也必须填写。示例值：不与其他优惠叠加
count 优惠数量 int32 否 优惠的数量。特殊规则：数量限制100，不填时默认1。 示例值：2

订单风险金参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 风险金名称 string[1,64] 是 枚举值： 【先免模式】（评估不通过可交押金）可填名称为 DEPOSIT：押金ADVANCE：预付款 CASH_DEPOSIT：保证金 【先享模式】（评估不通过不可使用服务）可填名称为 ESTIMATE_ORDER_COST：预估订单费用 示例值：DEPOSIT
amount 风险金额 int32 是 1、数字，必须>0（单位分）。 2、风险金额≤服务ID的风险金额上限。 3、当商户优惠字段为空时，付费项目总金额≤服务ID的风险金额上限 （未填写金额的付费项目，视为该付费项目金额为0）。 4、完结订单的总金额和风险金额的关系。 1）【评估不通过：交押金】模式：总金额≤创单时填写的“订单风险金额” 2）【评估不通过：拒绝】模式：总金额≤“每个服务ID的风险金额上限”示例值：10000
description 风险说明 string[1,30] 否 优惠使用条件说明。 如果填写了name（优惠名称）和description（优惠说明）其中一个字段内容，则另一个字段也必须填写。示例值：不与其他优惠叠加

服务位置参数域

参数名 参数描述 类型[长度限制] 必填 备注
startLocation 服务开始地点 string[1,50] 否 开始使用服务的地点，不超过50个字符，超出报错处理。
endLocation 服务结束位置 string[1,50] 否 结束使用服务的地点，不超过50个字符，超出报错处理。 示例值：嗨客时尚主题展餐厅

业务请求参数模板

公共请求参数模板

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 否 响应码
errorMsg 错误描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,128] 否 响应验签数据

业务响应参数

参数名 参数描述 类型[长度限制] 必填 备注
transNo 商户订单号 string[1,64] 是 商户系统内部订单号保证不重复
tradeNo 交易订单号 string[1,32] 是 支付平台交易订单号
appid 应用ID string[1,32] 是 示例值：d678efh567hg6787
serviceId 服务ID string[1,32] 是 调用该接口提交的服务ID。 示例值：500001
state 服务订单状态 string[1,32] 是 表示当前单据状态。枚举值：
1、CREATED：商户已创建服务订单
2、DOING：服务订单进行中
3、DONE：服务订单完成
4、REVOKED：商户取消服务订单
5、EXPIRED：服务订单已失效
示例值：DOING
stateDescription 订单状态说明 string[1,32] 否 对服务订单”进行中”状态的附加说明。
1、USER_CONFIRM：用户确认
2、MCH_COMPLETE：商户完结
示例值：MCH_COMPLETE
respCode 错误码 string[1,32] 是 详见错误码
respMsg 错误信息 string[1,128] 是 详见错误码
extend 商户备用字段 string[1,128] 否 原样返回字段
package 唤醒微信侧数据包 string[1,300] 是 需确认模式特有API中调起支付分-确认订单传入
postPayments 后付费项目 array 是 后付费项目列表，最多包含100条付费项目
postDiscounts 后付费商户优惠 array 否 后付费商户优惠，最多包含30条付费项目。如果传入，用户侧则显示此参数。
riskFund 订单风险金 object 是 订单风险金信息
timeRange 服务时间段 object 否 服务时间范围
location 服务位置 object 否 服务使用信息。如果传入，用户侧则显示此参数。

后付费项目参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 付费项目名称 string[1,20] 否 不超过20个字符，超出报错处理。 示例值：就餐费用, 服务费
amount 金额 int64 条件选填 此付费项目总金额，大于等于0，单位为分，等于0时代表不需要扣费，只能为整数，详见支付金额。 如果填写了“付费项目名称”，则amount或description必须填写其一，或都填。示例值：40000
description 计费说明 string[1,30] 条件选填 描述计费规则，不超过30个字符，超出报错处理。
count 付费数量 int32 否 付费项目的数量。 示例值：4

后付费商户优惠参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 优惠名称 string[1,20] 否 优惠名称说明。
amount 优惠金额 int 否 优惠金额，只能为整数，详见支付金额。示例值：100
description 优惠说明 string[1,30] 否 优惠使用条件说明。 如果填写了name（优惠名称）和description（优惠说明）其中一个字段内容，则另一个字段也必须填写。示例值：不与其他优惠叠加
count 优惠数量 int32 否 优惠的数量。特殊规则：数量限制100，不填时默认1。 示例值：2

订单风险金参数域

参数名 参数描述 类型[长度限制] 必填 备注
name 风险金名称 string[1,64] 是 枚举值： 【先免模式】（评估不通过可交押金）可填名称为 DEPOSIT：押金ADVANCE：预付款 CASH_DEPOSIT：保证金 【先享模式】（评估不通过不可使用服务）可填名称为 ESTIMATE_ORDER_COST：预估订单费用 示例值：DEPOSIT
amount 风险金额 int32 是 1、数字，必须>0（单位分）。 2、风险金额≤服务ID的风险金额上限。 3、当商户优惠字段为空时，付费项目总金额≤服务ID的风险金额上限 （未填写金额的付费项目，视为该付费项目金额为0）。 4、完结订单的总金额和风险金额的关系。 1）【评估不通过：交押金】模式：总金额≤创单时填写的“订单风险金额” 2）【评估不通过：拒绝】模式：总金额≤“每个服务ID的风险金额上限”示例值：10000
description 风险说明 string[1,30] 否 优惠使用条件说明。 如果填写了name（优惠名称）和description（优惠说明）其中一个字段内容，则另一个字段也必须填写。示例值：不与其他优惠叠加

服务时间段参数域

参数名 参数描述 类型[长度限制] 必填 备注
startTime 服务开始时间 string[1,14] 是 用户端展示用途。格式：yyyyMMddHHmmss、yyyyMMdd和 OnAccept
startTimeRemark 服务开始时间备注 string[1,20] 否 服务开始时间备注说明
endTime 预计服务结束时间 string[1,14] 是 用户端展示用途。格式：yyyyMMddHHmmss或yyyyMMdd
endTimeRemark 预计服务结束时间备注 string[1,20] 否 预计服务结束时间备注说明，预计服务结束时间有填时可填写

服务位置参数域

参数名 参数描述 类型[长度限制] 必填 备注
startLocation 服务开始地点 string[1,50] 否 开始使用服务的地点，不超过50个字符，超出报错处理。
endLocation 服务结束位置 string[1,50] 否 结束使用服务的地点，不超过50个字符，超出报错处理。 示例值：嗨客时尚主题展餐厅

业务响应参数模板

公共响应参数模板

{
    "success": true, 
    "result": "88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d", 
    "errorCode": null, 
    "errorMsg": null
}
作者：xiaochen  创建时间：2023-05-24 14:41
最后编辑：admin  更新时间：2024-10-21 15:46