邮件与通知

配置通知渠道、模板、投递与计费。

强制账号通知

余额到账、提现进度、套餐结果及账号安全变更会发送站内信和账号邮件。商户模板不能关闭这些通知。

通知与模板

点击“渠道管理”会在当前页面的侧边栏打开通知渠道管理。右上角添加渠道，列表中编辑渠道，添加和编辑均使用弹窗。通过页面顶部的“渠道 / 通知记录”标签切换渠道管理和通知记录；左侧导航不再显示通知设置入口。两个面板在当前页面以左右动画切换，URL 不变，并保留各自的筛选与分页状态。

支付通知由模板开关控制，卡片以标签展示已开启模板。

支付模板绑定具体渠道，同一事件、渠道、语言最多一条，新模板默认禁用。每个目标优先使用通知语言的已启用内容，其次使用已启用英文内容，每个事件最多投递一次。列表保留在管理面板，新增和编辑使用弹窗；关闭已修改草稿前确认放弃，忙碌操作期间阻止关闭。测试只发送给选定目标，不保存或启用模板。

支付模板的变量位于取消／保存按钮上方，默认折叠，展开后点击变量即可插入。

钱包收入、支出的中英文默认模板标题均带有 Telegram 标识，正文直接以收支标签开头，不带前置表情。

桌面端可拖动消息模板侧栏左边缘调整宽度；内容输入框可拖动右下角调整高度，最高为 600px 或视口高度的 70%（取较小值）。

在地址表单的齿轮入口配置模板和渠道。管理列表使用面板，新增与编辑使用弹窗并保留地址草稿。每行“发送测试”仅使用该行已保存的渠道和选中模板，不保存地址，也不代表已监测到真实转账。 监控地址禁用、删除或因计费暂停后，失败的渠道提醒停止重试，手动重发也会被拦截；已经发送的消息不会撤回。

Telegram 测试遇到 Bot Token 鉴权失败（401 Unauthorized）时返回错误码 10036。请通过 BotFather 检查或更换 Token。测试已保存渠道时，掩码 Token 会沿用已保存的凭据；更换时需输入完整的新 Token。

投递与重试

重试前先查看投递记录。邮件发送失败采用阶梯退避，最多尝试 5 次。钱包补发与重发受下述地址状态和 72 小时时限约束。

钱包监控仅通知链上发生时间距今不超过 72 小时的交易。首次扫描、补发及重试均受此限制；超过 72 小时的交易仍可保留在交易记录中，但不再发送站内、外部渠道或 Webhook 通知。

邮件语言

邮件支持中文和英文，按事件语言、商户邮件语言、账号界面语言、英文的顺序选择。

独立 Webhook

钱包监控在“通知设置”的模板下方管理一个 Webhook，不复用支付 Webhook 配置，也不使用通知渠道中的旧通用 Webhook。该配置拥有独立事件与地址范围、密钥、HMAC-SHA256 签名、重试状态和固定版本 JSON。修改 URL、范围、事件或密钥后会保持禁用，直到重新测试通过。旧通用 Webhook 只读保留，请通过迁移操作创建并测试该配置。

验签时请在解析 JSON 前读取原始请求体。读取 X-PolyPay-Timestamp 和 X-PolyPay-Signature（格式为 t=<timestamp>,v1=<hex>），使用完整的 whsec_... 密钥对 <timestamp>.<raw body> 计算 HMAC-SHA256，并使用常量时间比较签名。拒绝时间戳与当前时间相差超过 5 分钟的请求，并按 payload 的 id 只处理一次。每次测试请求都会使用唯一的测试事件 ID。

套餐与用量

收款套餐、订单额度和收款钱包用量按商户独立计算。钱包监控套餐、监控地址及通知额度归账号所有；切换商户不会获得另一份监控额度。

支付人工通知和钱包监控 Webhook 不限次数。只有钱包监控人工渠道按目标首次成功投递才消耗账号监控额度或产生对应 PAYG 费用；投递失败、站内信及系统通知不消耗该额度。