同步订单信息

更新时间：2025.04.01

由于收款商户进行的某些“线下操作”会导致微信支付侧的订单状态与实际情况不符。例如，用户通过线下付款的方式已经完成支付，而在微信支付侧并未支付成功，此时可能导致用户重复支付。因此商户需要通过订单同步接口将订单状态同步给微信支付，修改订单在微信支付系统中的状态。

注意：

待支付（USER_PAYING）状态下，当用户正在尝试通过收银台主动支付订单金额时，同步服务订单信息API无法调用成功，可等待3min后重试

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

1. 接口说明

适用对象: 机构模式

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

请求方式： POST

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名

变量

类型[长度限制]

必填

描述

商户订单号

out_order_no

string[1,32]

是

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

服务ID

service_id

string[1,32]

是

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

子商户商户号

sub_mchid

string[1,32]

是

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

场景类型

type

string[1,32]

是

Body 场景类型- "Order_Paid"：字符串表示“订单收款成功”
示例值：Order_Paid

内容信息详情

detail

SyncDetail

是

Body 场景类型为：Order_Paid 时，为必填项；详细说明见下文

内容信息详情

3. 请求示例

1curl -X POST \
2https://api.mch.weixin.qq.com/v3/payscore/oversea/partner/serviceorder/1234323JKHDFE1243252/sync \
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  "type" : "Order_Paid",
10  "detail" : {
11    "seq" : 1,
12    "paid_time" : "2019-11-11T16:24:05+08:00",
13    "paid_amount" : 1
14  }
15}'

4. 返回参数

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

5. 返回示例

1204 No Content
2
3无返回数据

6. 错误码

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