本篇重點
位置： Settings → Readers & money → Connections → Payments
打開此頁面： admin.<your-site>/settings/connections/payments（將 <your-site> 替換為您的網站網址）
事前準備
- 一個 Razorpay 帳號。請先從 Razorpay 的 測試模式 開始。
- 您必須是網站擁有者。
操作步驟
- 在 Razorpay 控制台中，切換到 測試模式。
- 前往 設定 → 進階 → 連結其他 app → API 金鑰 並產生一組金鑰。複製 key id 和 key secret。Razorpay 只會顯示一次密鑰。
- 在 Keynate 中，開啟 設定 → 讀者與營收 → 連線 → 付款 並按下 連結 Razorpay（或 新增連線）。
- 選擇 測試模式。貼上 Key id（開頭為
rzp_test_）、Key secret 和 Webhook 密鑰。 - 按下工作表底部的 連結 Razorpay。
- 在卡片上找到 讓 Razorpay 自動通知網站付款狀態。Razorpay 不允許其他應用程式代您執行此操作，因此需要在 Razorpay 中花費一分鐘設定。共有 3 個步驟：
- 開啟 Razorpay → Webhooks 並按下 Add New Webhook。
- 在 Razorpay 的表單中填入 Webhook URL、Secret 和 Active events（勾選每一個）。每個項目都有一個 複製 按鈕。密鑰只會顯示一次。如果您弄丟了，請按下 編輯，然後按下 為我產生新的密鑰。
- 按下 Create Webhook。接著進行一筆小額測試付款。
- 查看步驟下方的提示行。它會顯示 Waiting for Razorpay's first message…，成功時會變綠並顯示 We received Razorpay's first message.。款項隨後會自動顯示為已付款。按下 立即檢查 可重新檢查。日後按下 再次顯示步驟 即可打開這些步驟。
- 按下卡片上的 測試連線，然後進行測試付款。
- 成功後，在測試模式列中按下 Go live with Razorpay 並新增您的正式環境金鑰（
rzp_live_）。在正式模式下，卡片會在您收到第一筆真實付款後變綠。
更多說明：付款訊息 (webhook)。
貼心提醒
- 測試模式的 Key id 必須以
rzp_test_開頭，正式模式則必須以rzp_live_開頭。 - 測試與正式環境請使用不同的 webhook secret。
疑難排解
- "Key ids start with rzp_test_ (test mode) or rzp_live_ (live mode). Copy it from the API keys page inside your Razorpay dashboard."
- "Paste the key secret. Razorpay shows it only once, when you create the key." 如果您弄丟了，請產生一組新金鑰。
- "Paste the webhook secret you typed in Razorpay."
常見問題
常見問題
Razorpay 金鑰頁面在哪裡？
工作表中有一個可在新分頁打開該頁面的連結，而且頁面側邊欄也有 開啟 Razorpay API keys 和 開啟 Razorpay Webhooks。
我如何知道 webhook 是否正常運作？
卡片會顯示 We received Razorpay's first message.，在此之前則會顯示 Waiting for Razorpay's first message…。若 Stripe 或 PayPal 也同時開啟，卡片無法判斷訊息是由哪一個所發送，並會對此進行提示。如果您已經完成過一次，就無需再進行任何操作。
測試模式開關在哪裡？
在 Razorpay 控制台中。請在建立金鑰之前切換至 測試模式。