完结支付分订单

更新时间：2025.03.06

服务完成后，商户调用本接口，通知微信支付服务已结束(collection.state参数变为USER_PAYING状态，即用户待支付状态)。

注意：

1、在接口参数中，商户需要通过post_payments字段，上传本笔订单实际的付费项目明细，不同的场景有不同的传值要求，详见：post_payments(后付费项目)字段传参说明。

2、完结后微信支付会按照一定频率自动发起扣款，直到扣款成功，中间不会自动失效。商户可参考开发指引做业务逻辑处理。

接口说明

支持商户：【普通服务商】

请求方式：【POST】/v3/payscore/partner/serviceorder/{out_order_no}/complete

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

path 路径参数

out_order_no 　必填 string(32)

【商户服务订单号】商户系统内部服务订单号，要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。需要开发者特别注意，该参数不可用于申请退款接口中的 out_trade_no 参数。

body 包体参数

service_id 　必填 string(32)

【服务ID】商户支付分服务的唯一标识，由32位数字组成。支付分产品权限审核通过后，微信支付运营会向商户提供该ID。

sub_mchid 　必填 string(32)

【子商户号】服务商下的子商户商户号，普通服务商使用特约商户进件生成，平台收付通服务商使用二级商家进件生成。

post_payments 　必填 array[Payment]

【后付费项目】用于展示订单后付费项目明细，商户需要按照所属行业规程传参，详见post_payments(后付费项目)字段传参说明。

属性

post_discounts 　选填 array[ServiceOrderCoupon]

【商户优惠】用于展示订单优惠项目明细，最多30条，完结订单时传的收款总金额需满足计算条件(收款总金额=后付费项目amount和-优惠项目amount和)

属性

total_amount 　必填 integer

【总金额】订单最终收款总金额，整型，单位为分，商户调用完结订单接口和修改订单金额接口传入，受服务ID风险金额上限影响，服务ID风险金额上限具体请与BD确认。
total_amount<=服务ID风险金额上限。
需满足计算条件：total_amount = 后付费项目金额(post_payments.amount总和) - 优惠项目金额(post_discounts.amount总和)，例如商户后付费项目金额总和为10元，优惠项目金额总和为2元，则订单收款总金额为8元。

time_range 　选填 object

【服务时间段】用于描述订单的服务开始和结束时间。

属性

start_time 　选填 string(14)

【服务开始时间】

1、商户提供服务的开始时间。例如，用户今天下单，商户明天提供服务，这里的时间指的是明天。
2、支持格式："yyyyMMddHHmmss"和"yyyyMMdd"。
传入 20091225091010 表示 2009 年 12 月 25 日 9 点 10 分 10 秒。
传入 20091225 表示 2009 年 12 月 25 日 0 点 0 分 0 秒。
3、微信支付会根据传入时间的精度进行校验：
如果是 yyyyMMdd 格式，校验精确到日：start_time 必须晚于或等于商户调用创建订单接口的时间。
如果是 yyyyMMddHHmmss 格式，校验精确到秒：start_time 必须晚于调用创建订单接口的时间（考虑系统时差，建议预留一定误差）。

end_time 　选填 string(14)

【服务结束时间】

1、商户提供服务的结束时间，若创单传入了该字段且和实际服务结束时间一致(无需修改)则该参数可以不填。例如，商户明天提供服务，3天后结束服务，这里的时间指的是3天后的时间。
2、支持格式："yyyyMMddHHmmss"、"yyyyMMdd" 和。
传入 20091225091010 表示 2009 年 12 月 25 日 9 点 10 分 10 秒。
传入 20091225 表示 2009 年 12 月 25 日 0 点 0 分 0 秒。
3、微信支付会根据传入时间的精度进行校验：
如果是 yyyyMMdd 格式，校验精确到日：end_time 必须晚于或等于 start_time，end_time 必须早于或等于商户调用完结接口当前时间。
如果是 yyyyMMddHHmmss 格式，校验精确到秒：end_time 必须晚于 start_time，且end_time必须早于商户调用完结接口当前时间。
4、end_time必须和start_time时间格式一致，如果start_time使用OnAccept格式则end_time必须使用yyyyMMddHHmmss格式。

start_time_remark 　选填 string(20)

【服务开始时间备注】当有传入服务开始时间时，可添加备注说明，不超过20个字符。

end_time_remark 　选填 string(20)

【服务结束时间备注】当有传入服务结束时间时，可添加备注说明，不超过20个字符。

location 　选填 object

【服务位置】用于描述用户使用服务的地理位置

属性

profit_sharing 　选填 boolean

【微信支付服务分账标记】支付分订单的分账标识，完结订单时传入true表示需要进行分账。订单收款成功后，资金将被冻结。商户可请求分账，将订单收款资金分配给其他商户或用户。调用完结分账接口后，剩余资金将解冻；若未进行分账且距离支付完成时间超过30天，资金也会自动解冻。
true：需分账
false：不需分账
注：不传默认false，不需分账。

complete_time 　选填 string(64)

【完结服务时间】支付分订单完结时间，使用ISO 8601所定义的格式，需要晚于或等于end_time，且早于或等于调接口当前时间。
格式示例：
YYYY-MM-DDTHH:mm:ss.SSSZ
YYYY-MM-DDTHH:mm:ssZ
YYYY-MM-DDTHH:mm:ss.SSS+08:00
YYYY-MM-DDTHH:mm:ss+08:00

goods_tag 　选填 string(32)

【订单优惠标记】代金券在创建时可以配置多个订单优惠标记，标记的内容由创券商户自定义设置。如果代金券有配置订单优惠标记，则必须在该参数传任意一个配置的订单优惠标记才能使用券。如果代金券没有配置订单优惠标记，则可以不传该参数。

device 　选填 object

【设备信息】

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/payscore/partner/serviceorder/1234323JKHDFE1243252/complete \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "service_id" : "2002000000000558128851361561536",
8    "sub_mchid" : "1900000109",
9    "post_payments" : [
10      {
11        "name" : "就餐费用",
12        "amount" : 40000,
13        "description" : "就餐人均100元",
14        "count" : 4
15      }
16    ],
17    "post_discounts" : [
18      {
19        "name" : "满20减1元",
20        "description" : "不与其他优惠叠加",
21        "amount" : 100,
22        "count" : 2
23      }
24    ],
25    "total_amount" : 50000,
26    "time_range" : {
27      "start_time" : "20091225091010",
28      "end_time" : "20091225121010",
29      "start_time_remark" : "备注1",
30      "end_time_remark" : "备注2"
31    },
32    "location" : {
33      "start_location" : "嗨客时尚主题展餐厅",
34      "end_location" : "嗨客时尚主题展餐厅"
35    },
36    "profit_sharing" : false,
37    "complete_time" : "2019-11-11T16:24:05+08:00",
38    "goods_tag" : "goods_tag",
39    "device" : {
40      "start_device_id" : "HG123456",
41      "end_device_id" : "HG123456",
42      "materiel_no" : "example_materiel_no"
43    }
44  }'
45

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服