创建支付分订单
更新时间:2025.04.01前置条件:无
1. 接口说明
适用对象: 机构模式
请求URL:https://apihk.mch.weixin.qq.com/v3/payscore/oversea/partner/serviceorder
请求方式:POST
Path 指该参数为路径参数
Query 指该参数为URL参数
Body 指该参数需在请求JSON传参
2. 请求参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 | |||
---|---|---|---|---|---|---|---|
服务ID | service_id | string[1,32] | 是 | Body 该服务ID需有本接口对应产品的权限 | |||
服务商公众号ID | appid | string[1,32] | 是 | Body 服务商申请的公众号或移动应用AppID | |||
子商户号 | sub_mchid | string[1,32] | 是 | Body 子商户商户号,由微信支付生成并下发 | |||
子商户公众号ID | sub_appid | string[1,32] | 否 | Body 子商户申请的公众号或移动应用AppID | |||
商户订单号 | out_order_no | string[1,32] | 是 | Body 商户系统内部服务订单号(不是交易单号),要求32个字符内,只能是数字、大小写字母_-|* 且在同一个商户号下唯一。 | |||
货币类型 | currency | string[1,16] | 是 | Body 为收款商户的结算币种类型,同一个商户号下唯一 | |||
服务信息 | service_introduction | string[1,20] | 是 | Body 服务信息,用于介绍本订单所提供的服务 | |||
后付费项目 | post_payments | array[Payment] | 否 | Body 后付费项目列表,最多包含100条付费项目, 用于用户侧展示与完结订单时的总金额计算,详细说明见下文 | |||
| |||||||
商户优惠 | post_discounts | array[ServiceOrderCoupon] | 否 | Body 商户优惠列表,最多包含30条商户优惠,用于用户侧展示与完结订单时的总金额计算,详细说明见下文 | |||
| |||||||
服务风险金 | risk_fund | RiskFund | 是 | Body 用于微信支付分对本次服务进行风险评估,详细说明见下文 | |||
| |||||||
服务时间 | time_range | TimeRange | 是 | Body 服务时间,用于用户侧展示,详细说明见下文 | |||
| |||||||
服务位置 | location | Location | 否 | Body 服务位置,用于用户侧展示,详细说明见下文 | |||
| |||||||
服务商公众号下的用户标识 | openid | string[1,128] | 否 | Body 微信用户在服务商公众号AppID下的唯一标识;need_user_confirm为false时,openid与sub_openid必须填写并且只能填写一个 | |||
子商户公众号下的用户标识 | sub_openid | string[1,128] | 否 | Body 微信用户在子商户公众号SubAppID下的唯一标识; 1、OpenID与SubOpenID必须填写并且只能填写一个 2、如果填写了SubOpenID,那么SubAppID必填 示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o | |||
是否需要用户确认 | need_user_confirm | boolean | 否 | Body 是否需要用户确认; | |||
商户回调地址 | notify_url | string[1,256] | 是 | Body 商户接收用户确认订单通知或扣款成功回调通知的地址 | |||
附加数据 | attach | string[1,256] | 否 | Body 附加数据,可作为自定义参数使用,需要先urlencode后传入,总长度不大于256字符,超出报错处理。 |
3. 请求示例
4. 返回参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 | |||
---|---|---|---|---|---|---|---|
商户订单号 | out_order_no | string[1,32] | 是 | 调用接口传入的商户订单号 | |||
服务ID | service_id | string[1,32] | 是 | 调用接口传入的服务ID | |||
服务商公众号ID | appid | string[1,32] | 是 | 调用接口传入的服务商公众号ID | |||
服务商商户号 | mchid | string[1,32] | 是 | 调用接口传入的服务商商户号 | |||
子商户公众号ID | sub_appid | string[1,32] | 否 | 调用接口传入的子商户公众号ID | |||
子商户商户号 | sub_mchid | string[1,32] | 是 | 调用接口传入的子商户商户号 | |||
服务信息 | service_introduction | string[1,20] | 是 | 调用接口传入的服务信息 | |||
服务订单状态 | state | string[1,32] | 是 | 当前单据状态; | |||
订单状态说明 | state_description | string[1,32] | 否 | 对服务订单"DOING"状态的附加说明; | |||
后付费项目 | post_payments | array[Payment] | 否 | 调用接口传入的后付费项目,详细说明见下文 | |||
| |||||||
货币类型 | currency | string[1,16] | 是 | 为收款商户的结算币种类型,同一个商户号下唯一 | |||
商户优惠 | post_discounts | array[ServiceOrderCoupon] | 否 | 调用接口传入的商户优惠,详细说明见下文 | |||
| |||||||
服务风险金 | risk_fund | RiskFund | 否 | 调用接口传入的服务风险金,详细说明见下文 | |||
| |||||||
服务时间 | time_range | TimeRange | 是 | 调用接口传入的服务时间,详细说明见下文 | |||
| |||||||
服务位置 | location | Location | 否 | 调用接口传入的服务位置,详细说明见下文 | |||
| |||||||
附加数据 | attach | string[1,256] | 否 | 调用接口传入的附加数据 | |||
商户回调地址 | notify_url | string[1,256] | 是 | 调用接口传入的商户回调地址 | |||
微信支付服务订单号 | order_id | string[1,64] | 是 | 微信支付服务订单号,每个微信支付服务订单号与商户号下对应的商户订单号一一对应 | |||
跳转微信侧数据包 | package | string[1,1024] | 是 | 确认订单流程,商户前端跳转到微信侧传入的数据包,该数据一小时内有效 |
5. 返回示例
6. 错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 文档生成签名 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |