支付分订单同步
场景介绍
由于收款商户进行的某些“线下操作”会导致微信支付侧的订单状态与实际情况不符,例如用户通过线下付款的方式已经完成了支付,而微信支付侧还没有支付成功,此时可能导致用户重复支付。因此商户需要通过订单同步接口将订单状态同步给微信支付,修改订单在微信支付系统中的状态。
注意:本接口只适用于智慧零售、先享后付、免押租借、免押速住的免押订单
接口说明
接口url | https://api.mch.weixin.qq.com/v3/payscore/payafter-orders/{out_order_no}/sync |
---|---|
请求方式 |
POST |
接口规则 |
https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml |
前置条件
同步商户渠道收款成功信息时,即场景类型=“Order_Paid”,订单的状态需为[FINISHED:商户完结订单]
请求参数
变量名 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appid | string(32) | 是 | wxd678efh567hg6787 | 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid,可在公众平台查看绑定关系.需要在本系统先进行配置. |
out_order_no | string(32) | 是 | 500001 | 仅从URL中传 商户系统内部服务订单号(不是交易单号),要求32个字符内,只能是数字、大小写字母_-|* 且在同一个商户号下唯一。详见商户订单号 |
service_id | string | 是 | 2004000000000531234651675874480 | 该服务ID有本接口对应产品的权限 |
type | string | 是 | Order_Paid | 场景类型 Order_Paid-用户付款成功 |
detail | object | 是 | 内容信息详情 场景类型=“Order_Paid”时,必填,详见detail表格说明 |
detail
变量名 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
paid_time | string | 是 | 20091225091010 | 用户通过其他方式付款成功的实际时间 注:【服务开始时间】
注:微信支付分会根据此时间更新用户侧的守约记录、负面记录信息;因此请务必如实填写用户实际付款成功时间,以免造成不必要的客诉 |
请求包体样例:
{
"appid": "wxd678efh567hg6787",
"service_id": "2004000000000531234651675874480",
"type": "Order_Paid",
"detail": {
"paid_time": "20091225091010"
}
}
返回结果
状态码 | 含义 | 描述 |
---|---|---|
200 | OK | 处理成功 |
其它 | 异常应答 | 处理失败,详见 接口规则 |
状态码为 200 时 返回以下信息
变量名 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appid | string(32) | 是 | wxd678efh567hg6787 | 调用接口提交的公众账号ID |
mchid | string(32) | 是 | 1230000109 | 微信支付分配的商户号 |
out_order_no | string(32) | 是 | 1234323JKHDFE1243252 | 调用接口提交的商户服务订单号 |
order_id | string(128) | 是 | 164646465165651 | 微信支付服务订单号 每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应 |
应答样例:
200 Response{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_order_no": "1234323JKHDFE1243252",
"order_id": "164646465165651"
}
错误码
参见错误码列表