Skip to main content
商户通知 —— 新订单、新订阅、续费、取消、逾期 —— 投递到门店配置的收件人。每个收件人拥有各自的地址与各自的逐事件订阅开关,因此同一门店下的两个人可以订阅不同的事件。门店未配置任何收件人时,该门店一封商户通知都不发 —— 没有任何兜底地址。

事件目录

上表 10 个开关全部是逐收件人的 —— 包括 notifySubscriptionPlanChanged 与 notifyChargeback。同一门店下的两个人可以订阅不同的事件,update-recipient 接受这 10 个键中的任意一个。其中 9 个默认开启,notifyChargeback 是唯一例外:它默认关闭,只有该键显式为 true 的收件人才会收到拒付邮件。存量条目缺某个键时按该键的默认读回,因此漏传它不会把拒付邮件打开。投递地址跟收件人列表走:商户通知发到已配置的收件人,不再发到 supportEmail。列表为空时一封不发,不会替换成任何其它地址。

限制

每个门店最多 5 个收件人,超出上限返回 400。没有下限,且空列表就是静默:删空即该门店从此不发任何商户通知(见下节)。面向消费者的交易邮件(订单收据、订阅确认)是另一条链路,不受影响。

Primary 收件人

新建门店会种入一条收件人 —— 商户账号邮箱 —— 并标记 isPrimary: true。该标记只表示来源:这一行不带任何特权,行为与其它收件人完全一致,也和其它收件人一样可以删除。它同时是 update-store 的门店级 notify* 兼容回写所镜像的那一行。 把收件人全部删光(含 Primary 那条)是被接受的:此后该门店不发任何商户通知,也不会合成任何条目来取代它。重新添加地址即恢复投递。

环境

收件人不分环境。请求可以照常携带 X-Environment,但它不参与收件人读写的过滤与改写 —— 同一门店在 test 与 prod 下返回同一份列表。

列出收件人

没有 list-recipients 端点 —— 查询收件人列表走 GraphQL 顶层查询 storeNotificationRecipients;门店没有收件人时它返回 []:

端点

添加收件人

添加一个接收商户通知的地址。

更新收件人

修改收件人订阅的事件。

移除收件人

从列表中移除一个收件人。