完结支付分订单

更新时间：2025.04.01

完结微信支付分订单。用户使用服务完成后，商户可通过此接口完结订单。

注意：

完结接口调用成功后，微信支付将自动发起免密代扣。若扣款失败，微信支付将自动再次发起免密代扣（按照一定频次），直到扣成功为止；

API参数涉及时间参数时需注意，可能由于商户时钟系统和微信支付分时钟系统，取当前时间存在一定误差。可能导致在API调用出现失败情况。因此商户在传入时间参数时需预留一定误差时间。

1. 接口说明

适用对象：机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/payscore/oversea/partner/serviceorder/{out_order_no}/complete

请求方式：POST

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

商户订单号

out_order_no

string[1,32]

是

Path 商户系统内部服务订单号（不是交易单号），要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。
示例值：out_order_no_666

服务ID

service_id

string[1,32]

是

Body 该服务ID需有本接口对应产品的权限
示例值：2002000000000558128851361561536

子商户号

sub_mchid

string[1,32]

是

Body 子商户商户号，由微信支付生成并下发
示例值：1900000109

后付费项目

post_payments

array[Payment]

是

Body 后付费项目列表，最少包含1条、最多包含100条付费项目创建订单接口传入的【后付费项目】将失效，以本接口传入的【付费项目】为准，详细说明见下文

后付费项目

商户优惠

post_discounts

array[ServiceOrderCoupon]

否

Body 商户优惠列表，最多包含30条商户优惠创建订单接口传入的【商户优惠】将失效，以本接口传入的【商户优惠】为准，详细说明见下文

商户优惠

总金额

total_amount

integer

是

Body 1、金额：数字，必须≥0（单位：分）
2、总金额 =（付费项目1+...+付费项目n）-（商户优惠1+…+完结商户优惠n）
3、总金额上限
1）【评估不通过：交押金】模式：总金额≤创单时填写的“订单风险金额”
2）【评估不通过：拒绝】模式：总金额≤“服务风险金额”
示例值：50000

货币类型

currency

string[1,16]

是

Body 为收款商户的结算币种类型（与创单时传入的货币类型需一致），同一个商户号下唯一
示例值：HKD

实际服务时间

time_range

TimeRange

否

Body 实际服务时间，创建订单未填写服务结束时间，则完结的时候，服务结束时间必填，详细说明见下文

实际服务时间

实际服务位置

location

Location

否

Body 实际服务位置，覆盖创建订单时的服务位置，用于用户端展示，详细说明见下文

实际服务位置

微信支付服务分账标记

profit_sharing

boolean

否

Body 完结订单分账接口标记 false-不分账，true-分账，默认：false
示例值：false

完结服务时间

complete_time

string[1,64]

否

Body 遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒
示例值：2019-11-11T16:24:05+08:00

订单优惠标记

goods_tag

string[1,32]

否

Body 代金券或立减金优惠的参数，说明详见代金券或立减金优惠
示例值：goods_tag

3. 请求示例

1curl -X POST \
2https://api.mch.weixin.qq.com/v3/payscore/oversea/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  "currency" : "HKD",
27  "time_range" : {
28    "start_time" : "2019-11-11T16:24:05+08:00",
29    "end_time" : "2019-11-11T16:24:05+08:00",
30    "start_time_remark" : "备注1",
31    "end_time_remark" : "备注2"
32  },
33  "location" : {
34    "start_location" : "嗨客时尚主题展餐厅",
35    "end_location" : "嗨客时尚主题展餐厅"
36  },
37  "profit_sharing" : false,
38  "complete_time" : "2019-11-11T16:24:05+08:00",
39  "goods_tag" : "goods_tag"
40}'

4. 返回参数

无返回数据(HTTP状态码为204)

5. 返回示例

1204 No Content
2
3无返回数据

6. 错误码

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