# 确认收货提醒
接口应在服务器端调用,不可在前端(小程序、网页、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_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| transaction_id | string | 否 | 原支付交易对应的微信订单号。 |
| merchant_id | string | 否 | 支付下单商户的商户号,由微信支付生成并下发。 |
| sub_merchant_id | string | 否 | 二级商户号。 |
| merchant_trade_no | string | 否 | 商户系统内部订单号,只能是数字、大小写字母`_-*`且在同一个商户号下唯一。 |
| received_time | number | 是 | 快递签收时间,时间戳形式。 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
# 4. 注意事项
- 通过交易单号或商户号+商户单号来指定订单。
- 只有物流类型为物流快递时才能进行提醒。
- 签收时间由商户传入,在给用户发送提醒消息时会显示签收时间,签收时间必须在发货时间之后。
# 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 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| -1 | system 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. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。