メールと通知
通知チャネル、テンプレート、配信、課金を設定します。
必須のアカウント通知
残高入金、出金状況、プランの処理結果、アカウントのセキュリティ変更は、アプリ内通知とアカウント宛てメールで届きます。加盟店テンプレートでは無効化できません。
通知とテンプレート
チャネル管理は現在のページのサイドバーで開きます。右上で追加、一覧から編集し、どちらもダイアログで行います。ページ上部の「チャネル / 通知履歴」タブでチャネル管理と通知履歴を切り替えます。通知設定の入口はサイドバーから削除されています。2つのパネルはURLを変えずにページ内で左右に切り替わり、それぞれの絞り込みとページ番号を保持します。
テンプレートのスイッチで決済通知を制御し、有効なテンプレートをタグ表示します。
支払いテンプレートは特定の通知先に紐付き、イベント・通知先・言語ごとに一つです。新規テンプレートは無効です。通知言語の有効な内容、次に有効な英語を使用し、各イベントで各通知先へ最大一回配信します。一覧はパネルに、追加・編集はダイアログに表示します。変更の破棄には確認が必要で、処理中は閉じられません。テストは選択した通知先だけに送信し、テンプレートを保存・有効化しません。
支払いテンプレートの変数はキャンセル・保存ボタンの上で折りたたまれています。展開して変数をクリックすると挿入できます。
ウォレットの入金・出金の英語と中国語のデフォルトテンプレートには、タイトルに Telegram が付きます。本文は絵文字を付けずに入出金タグから始まります。
デスクトップでは、メッセージテンプレートのサイドバー左端をドラッグして幅を調整できます。内容エディターの右下隅をドラッグすると高さを調整でき、上限は600pxまたは表示領域の高さの70%のうち小さい方です。
アドレスフォームの歯車からテンプレートと通知先を設定します。一覧はパネル、フォームはダイアログで開き、アドレスの下書きを保持します。テスト送信はその行の保存済み通知先と選択テンプレートだけを使用し、アドレスの保存や実際の送金検知は行いません。 監視アドレスが無効化、削除、または請求上の理由で一時停止されると、失敗したチャネル通知の再試行は停止し、手動再送もブロックされます。送信済みのメッセージは取り消されません。
Telegram のテストで Bot Token の認証に失敗すると（401 Unauthorized）、エラーコード 10036 が返されます。BotFather でトークンを確認または更新してください。保存済みチャネルのテストでは、マスクされたトークンは保存済みの認証情報を使用します。変更する場合は新しいトークン全体を入力してください。
配信と再試行
再試行の前に配信履歴を確認してください。失敗したメールは間隔を広げて最大5回試行します。ウォレット通知の補完と再送には、下記のアドレス状態と72時間の制限が適用されます。
ウォレット監視は、オンチェーンの発生時刻から 72 時間以内の取引のみを通知します。初回スキャン、未送信通知の補完、再試行にもこの制限が適用されます。72 時間を超えた取引は履歴に保持できますが、アプリ内・外部チャネル・Webhook の通知は送信されません。
メールの言語
メールは英語と中国語に対応しています。イベントの言語、加盟店のメール言語、アカウントの表示言語、英語の順に選択します。
独立 Webhook
「通知設定」のテンプレート下にある Webhook セクションで、ウォレット監視 Webhook を1件管理します。支払い 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 は 1 回だけ処理してください。テストリクエストごとに一意のテストイベント ID が使用されます。
プランと使用量
決済プラン、注文枠、受取ウォレットの使用量は加盟店ごとに管理されます。監視プラン、監視アドレス、通知枠はアカウント単位です。加盟店を切り替えても監視枠は増えません。
人向けの決済通知とウォレット監視Webhookは回数無制限です。人向けの監視通知は、送信先ごとの最初の配信成功時だけアカウントの監視通知枠を消費するか、該当するPAYG料金が発生します。配信失敗、アプリ内通知、システム通知は枠を消費しません。