支付分订单同步

场景介绍

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

注意:本接口只适用于智慧零售、先享后付、免押租借、免押速住的免押订单

接口说明

接口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

用户通过其他方式付款成功的实际时间
需满足条件:
服务开始时间<调用商户完结订单接口的时间<用户通过其他方式付款成功的实际时间≤商户调用支付分订单同步接口的时间

注:【服务开始时间】
当完结订单有填写【实际服务开始时间】时,【服务开始时间】=完结订单【实际服务开始时间】
当完结订单未填写【实际服务开始时间】时,【服务开始时间】=创建订单【服务开始时间】 」


场景类型=“Order_Paid”时,必填
支持两种格式:yyyyMMddHHmmss和yyyyMMdd
传入20091225091010表示2009年12月25日9点10分10秒
传入20091225表示时间为2009年12月25日23点59分59秒

注:微信支付分会根据此时间更新用户侧的守约记录、负面记录信息;因此请务必如实填写用户实际付款成功时间,以免造成不必要的客诉

请求包体样例:

{
  "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"
}

错误码