在這故事中,
位置： 設定 → 讀者與金流 → 連線 → 付款
開啟此頁面： admin.<your-site>/settings/connections/payments（將 <your-site> 替換為您的網站網址）
事前準備
- 請先連接 Razorpay、Stripe 或 PayPal。請參閱 Payments。
- 您必須是網站擁有者。
操作步驟
Stripe 與 PayPal： Keynate 可以在情況允許時為您在帳號中設定付款訊息。卡片會顯示「已為您在 Stripe 中設定付款訊息。」如果無法自動設定，則會顯示「還差一步」與 完成設定 按鈕。請依照下列步驟操作。
Razorpay： 這項操作無法為您自動完成。Razorpay 卡片有一個引導式 3 步驟方塊並帶有即時檢查：在您進行第一筆付款（測試或正式）後，正在等待 Razorpay 的第一則訊息… 會變成 我們收到了 Razorpay 的第一則訊息。。按下 立即檢查 可再次查看。請參閱 Connect Razorpay。
任何金流服務的設定步驟：
- 開啟 設定 → 讀者與營收 → 連線 → 付款。
- 在您的金流服務卡片上，找到 Webhook 方塊。
- 按下 開啟 Webhook（按鈕會標示您的金流服務名稱）。金流服務的控制台會在分頁中開啟。
- 在金流服務中，按下 新增。
- 回到 Keynate，按下 Webhook URL 旁的 複製，並將其貼到金流服務中。
- 勾選 Keynate 方塊中列出的事件。
- Razorpay：按下密鑰上的 複製，並將其貼為 secret。測試和正式模式請使用不同的密鑰。
- 在金流服務中儲存。
- Stripe 與 PayPal 在儲存後會顯示一組代碼。Stripe 稱之為簽署密鑰（signing secret），並以
whsec_開頭。PayPal 稱之為 Webhook ID。複製該代碼並貼到 Keynate 對應的方塊中。 - 按下 測試連線。
貼心提醒
- 測試模式與正式模式各自需要專屬的 webhook。
- 如果您遺失了密鑰，請在金流服務中新增一個 webhook，並將新代碼貼上。
疑難排解
- 「請貼上您在 Razorpay 輸入的 webhook 密鑰。」 Keynate 中的方塊是空的。請貼上您提供給 Razorpay 的相同密鑰。
- 「測試與正式環境請使用不同的 webhook 密鑰。」 請為第二個模式建立新的密鑰。
- 「請貼上 webhook 簽署密鑰。開頭為 whsec_。」 在新增端點後從 Stripe 複製它。
- 「請貼上 Webhook ID（僅限英文字母和數字）。」 從 PayPal 應用程式的 Webhooks 清單複製該 ID。
- Razorpay 仍顯示「正在等待 Razorpay 的第一則訊息…」。 請進行一筆小額測試付款。訊息會在第一筆付款後送達。接著按下 立即檢查。
- 讀者付款後訂單仍處於未付款狀態。 Webhook 遺失或錯誤。每天夜間 Keynate 也會將您的訂單與金流服務比對，並修正遺漏的訂單。
常見問題
常見問題
這與 API 金鑰相同嗎？
不同。金鑰讓 Keynate 能與金流服務通訊。Webhook 則是讓金流服務能與 Keynate 通訊。
測試與正式環境都需要 webhook 嗎？
是的。測試模式與正式模式各自都需要一個。
如果我遺失了密鑰該怎麼辦？
在金流服務中新增一個 webhook，並將新代碼貼到 Keynate。
如果讀者已經付款，但訂單仍處於未付款狀態該怎麼辦？
Webhook 遺失或錯誤。每天夜間 Keynate 也會將您的訂單與金流服務比對，並修正遺漏的訂單。