# 确认收货提醒

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:notifyConfirmReceive

如你已经从你的快递物流服务方获知到用户已经签收相关商品,可以通过该接口提醒用户及时确认收货,以提高资金结算效率,每个订单仅可调用一次。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/sec/order/notify_confirm_receive?access_token=ACCESS_TOKEN

# 云调用

  • 调用方法:wxa.sec.order.notifyConfirmReceive

  • 出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档。

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:142

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
transaction_idstring原支付交易对应的微信订单号。
merchant_idstring支付下单商户的商户号,由微信支付生成并下发。
sub_merchant_idstring二级商户号。
merchant_trade_nostring商户系统内部订单号,只能是数字、大小写字母`_-*`且在同一个商户号下唯一。
received_timenumber快递签收时间,时间戳形式。

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息

# 4. 注意事项

  1. 通过交易单号或商户号+商户单号来指定订单。
  2. 只有物流类型为物流快递时才能进行提醒。
  3. 签收时间由商户传入,在给用户发送提醒消息时会显示签收时间,签收时间必须在发货时间之后。

# 5. 代码示例

请求示例

{
    "transaction_id": "fake-transid-20221209132531-44",
    "merchant_id": "fake-mchid-123",
    "merchant_trade_no": "fake-tradeno-20221209132531-44",
    "received_time": 1670829139
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok"
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述
-1system error。系统繁忙,此时请开发者稍候再试
10060001支付单不存在。请检查微信支付单号形式下 transaction_id 字段或商户侧单号形式下 mchid、out_trade_no 字段是否有误
10060002支付单已完成发货,无法继续发货。请检查支付单发货情况
10060003支付单已使用重新发货机会。支付单处于已发货状态时调用该API视为重新发货,仅可重新发货一次,请检查支付单发货情况
10060004支付单处于不可发货的状态。请检查支付单状态
10060005物流类型有误。按照文档中物流类型枚举填写该字段
10060006非快递发货时不允许分拆发货。非快递发货时不允许分拆发货,请检查请求参数
10060007分拆发货模式下必须填写 is_all_delivered 字段。请检查请求参数中的 is_all_delivered 字段
10060008商品描述 item_desc 字段不能为空。用于发货信息录入场景时商品描述字段不能为空
10060009商品描述 item_desc 字段太长。请检查商品描述字段
10060012系统错误。系统繁忙,此时请开发者稍候再试
10060014参数错误。根据错误原因描述修改参数
10060019系统错误。系统繁忙,此时请开发者稍候再试
10060020该笔支付单在没有任何商品描述的情况下不允许完成发货。请补充商品描述 item_desc
10060023发货信息未更新。支付单信息不变
10060024物流信息列表太长。支付单物流信息列表长度不可大于 15
10060025物流公司编码太长。请检查物流公司编码是否有误
10060026物流单号太长.。请检查物流单号是否有误
10060028支付单不是已发货状态。请检查支付单状态
10060029签收时间非法。请检查签收时间是否在发货时间之后
10060030支付单已使用提醒收货机会。不可再提醒收货
10060031该笔支付单不属于 openid 所指定的用户。请检查支付单号或 openid 是否有误
10060032只有物流快递发货时允许提醒用户确认收货。请检查支付单物流类型
268485194订单单号类型非法。按照文档中订单单号类型枚举填写该字段
268485195微信支付单号形式下 transaction_id 字段不能为空。微信支付单号形式下 transaction_id 字段必须设置
268485196商户侧单号形式下 mchid 字段不能为空。商户侧单号形式下 mchid 字段必须设置
268485197商户侧单号形式下 out_trade_no 字段不能为空。商户侧单号形式下 out_trade_no 字段必须设置
268485216上传时间非法,请按照 RFC 3339 格式填写。上传时间必须满足 RFC 3339 格式,如 2022-12-15T13:29:35.120+08:00
268485224发货模式非法。按照文档中发货模式枚举设置该字段
268485226物流单号不能为空。物流快递发货时物流单号必须填写
268485227物流公司编码不能为空。物流快递发货时物流公司编码必须填写
268485228统一发货模式下,物流信息列表长度必须为 1。统一发货模式下,物流信息列表长度必须为 1

# 7. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。