商户入驻状态回调通知接口文档

1. 接口说明

该接口用于在商户入驻状态变更时（邀请授权状态、产品开票能力状态），向服务商发起异步回调通知。

2. 通知触发条件

• 商户已配置有效的回调地址（notify_url）
• 商户产品开票能力状态发生变化

3. 通知类型说明

4. 产品开票能力状态通知（notifyType = PRODUCT）

4.1 请求参数

4.2 产品事件类型

4.3 开票能力编码

4.4 产品接入状态

4.5 授权状态

4.6 请求示例

4.6.1 PRODUCT_AUTHORIZED（产品授权成功）

{
  "eventType": "PRODUCT_AUTHORIZED",
  "merchantId": "M202406220001",
  "partnerId": "P100001",
  "channel": "WECHAT",
  "productAbility": "BASIC",
  "accessStatus": "ENABLED",
  "accessStatusDesc": "商户数电开票能力，税局接入完成",
  "authStatus": "AUTHORIZED",
  "authStatusDesc": "数电开通能力已授权",
  "failReason": null,
  "notifyTime": "2024-06-22T14:30:00"
}

4.6.2 PRODUCT_AUTH_FAILED（产品授权失败）

{
  "eventType": "PRODUCT_AUTH_FAILED",
  "merchantId": "M202406220001",
  "partnerId": "P100001",
  "channel": "ALIPAY",
  "productAbility": "BASIC",
  "accessStatus": "APPLY_FAILED",
  "accessStatusDesc": "税局申请不通过，请查看接入失败原因",
  "authStatus": "AUTH_FAILED",
  "authStatusDesc": "能力授权失败",
  "failReason": "税务机关审批未通过，请核实商户信息",
  "notifyTime": "2024-06-22T14:30:00"
}

4.6.3 PRODUCT_DISABLED（产品被禁用）

{
  "eventType": "PRODUCT_DISABLED",
  "merchantId": "M202406220001",
  "partnerId": "P100001",
  "channel": "ALIPAY",
  "productAbility": "BASIC",
  "accessStatus": "DISABLED",
  "accessStatusDesc": "未接入或商户解除授权，请重新发起能力邀请商户确认授权",
  "authStatus": "DEAUTHORIZED",
  "authStatusDesc": "商户已取消支付宝应用授权",
  "failReason": null,
  "notifyTime": "2024-06-22T14:30:00"
}

4.6.4 PRODUCT_STATUS_CHANGED（产品状态变更-中间态）

{
  "eventType": "PRODUCT_STATUS_CHANGED",
  "merchantId": "M202406220001",
  "partnerId": "P100001",
  "channel": "WECHAT",
  "productAbility": "BASIC",
  "accessStatus": "APPROVAL_PENDING",
  "accessStatusDesc": "请等待当地税务机关审批",
  "authStatus": "NEED_AUTH",
  "authStatusDesc": "需要财务负责人或者法定代表人，登录电子税局系统，进行开票能力授权",
  "failReason": null,
  "notifyTime": "2024-06-22T14:30:00"
}

5. 响应要求

接收方收到通知后，应在 5秒内 返回 HTTP 响应，响应内容为字符串 success（不区分大小写）：

6. 重试机制

• 待补充

7. 事件类型与状态对应关系

7.1 邀请状态事件

7.2 产品状态事件

8. 通知触发场景

9. 去重说明

• 产品状态通知：仅在状态发生变化时发送，避免重复通知