PolyPay logoPolyPay.ai
初級4 分鐘閱讀

郵件與通知

設定通知渠道、範本、投遞與計費。

強制帳號通知

餘額到帳、提現進度、方案結果及帳號安全變更會傳送站內信和帳號郵件。商戶範本不能關閉這些通知。

通知與範本

點擊「渠道管理」會在目前頁面的側邊欄開啟通知渠道管理。右上角新增渠道,清單中編輯渠道,均使用對話框。透過頁面頂部的「渠道 / 通知記錄」分頁切換渠道管理與通知記錄;左側導覽不再顯示通知設定入口。兩個面板在目前頁面以左右動畫切換,URL 不變,並保留各自的篩選與分頁狀態。

支付通知由模板開關控制,卡片以標籤展示已啟用模板。

支付範本綁定具體渠道,同一事件、渠道、語言最多一條,新範本預設停用。每個目標優先使用通知語言的已啟用內容,其次使用已啟用英文內容,每個事件最多投遞一次。列表保留在管理面板,新增與編輯使用彈窗;關閉已修改草稿前確認放棄,忙碌操作期間阻止關閉。測試只傳送給選定目標,不儲存或啟用範本。

支付模板的變數位於取消/儲存按鈕上方,預設摺疊,展開後點擊變數即可插入。 取消訂單的預設模板顯示金額和幣種;已儲存的模板需恢復預設並儲存後採用新文案。

支付與錢包通知範本僅支援編輯器列出的變數,不支援程式碼、函式或迴圈。備註、地址名稱等變數以文字處理,不能插入 HTML 或替換其他變數;系統 emoji 圖示保留。連結變數僅接受 HTTP、HTTPS 或站內路徑。範本及呈現結果最多 64 KiB,超出限制會報錯。

錢包收入、支出的中英文預設範本標題均帶有 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 費用;投遞失敗、站內信及系統通知不消耗該額度。