この記事の内容
Where: 設定 → 読者とお金 → 連携 → 決済
このページを開く: admin.<your-site>/settings/connections/payments（<your-site> をご自身のサイトアドレスに置き換えてください）
事前準備
- 事前にRazorpay、Stripe、またはPayPalを連携させておいてください。詳しくは決済をご覧ください。
- サイト所有者のアカウントで操作する必要があります。
手順
StripeとPayPal: 可能であれば、Keynateが自動で決済通知の設定を行います。「Stripeの決済通知が自動で設定されました」と表示されます。自動設定ができなかった場合は「あと1ステップ」と表示され、Finish setup ボタンが現れます。その場合は以下の手順に進んでください。
Razorpay: 自動設定はできません。Razorpayのカードには、リアルタイム確認付きの3ステップ案内が表示されます。テストまたは本番の初回決済が行われると、「Razorpayからの最初の通知を待機中…」 から 「Razorpayからの最初の通知を受信しました」 に切り替わります。再確認するには Check now を押してください。詳しくはRazorpayの連携をご覧ください。
各決済サービス共通の手順：
- Settings → Readers & money → Connections → Payments を開きます。
- ご利用の決済サービスのカード内にある Webhook の項目を探します。
- Webhookを開く を押します（ボタンには対象の決済サービス名が表示されます）。別タブで各決済サービスの管理画面が開きます。
- 決済サービスの管理画面で、Add を押します。
- Keynateに戻り、Webhook URL の横にある Copy を押してコピーし、決済サービスの画面に貼り付けます。
- Keynateの画面に記載されているイベントにチェックを入れます。
- Razorpayの場合：シークレットコードの Copy を押してコピーし、シークレット欄に貼り付けます。テスト用と本番用で異なるシークレットを使用してください。
- 決済サービス側で保存します。
- StripeとPayPalでは、保存後にコードが表示されます。Stripeでは署名シークレット（
whsec_から始まる文字列）、PayPalではWebhook IDと呼ばれます。これをコピーして、Keynateの対応する入力欄に貼り付けます。 - Test connection を押します。
補足情報
- テスト環境と本番環境で、それぞれ個別のWebhook設定が必要です。
- シークレットを紛失した場合は、決済サービス側で新しいWebhookを追加し、新しいコードを貼り付け直してください。
トラブルシューティング
- 「Razorpayに入力したWebhookシークレットを貼り付けてください」 Keynateの入力欄が空欄になっています。Razorpayに設定したものと同じシークレットを貼り付けてください。
- 「テスト用と本番用で異なるWebhookシークレットを使用してください」 もう一方のモード用には、別の新しいシークレットを作成してください。
- 「Webhook署名シークレットを貼り付けてください。whsec_で始まります」 エンドポイントを追加した後、Stripeからコピーしてください。
- 「Webhook ID（英数字のみ）を貼り付けてください」 PayPalアプリの「Webhooks」一覧からIDをコピーしてください。
- Razorpayの表示が「Razorpayからの最初の通知を待機中…」のまま変わらない。 少額のテスト決済を行ってください。最初の決済完了後に通知が届きます。その後、Check now を押してください。
- 読者が支払ったのに注文が「未払い」のままになっている。 Webhookの設定がないか、誤っています。なお、Keynateは毎晩決済サービスと注文データを自動で照合し、反映漏れを修正します。
よくある質問
よくある質問
APIキーとは違うものですか？
はい、異なります。APIキーはKeynateから決済会社へ問い合わせるためのもので、Webhookは決済会社からKeynateへ結果を伝えるためのものです。
テスト用と本番用で別々のWebhookが必要ですか？
はい。テスト環境と本番環境それぞれに専用の設定が必要です。
シークレットをなくしてしまったら？
決済サービス側で新しくWebhookを追加作成し、新しいコードをKeynateに貼り付けてください。
支払われたのに注文が未払いのままの場合はどうすればいいですか？
Webhookの設定がされていないか、間違っている可能性があります。なお、Keynateは毎晩決済サービスの履歴と注文を照合し、反映漏れを自動で解消します。