24.2. クレジットカードゲートウェイとしての Stripe の設定
3scale API プロバイダーとして、Stripe を支払いゲートウェイとして管理ポータルおよび開発者ポータルを設定し、クレジットカードゲートウェイとして Stripe を使用して API に対するサブスクリプションからの支払いを受け取ります。
前提条件
Stripe アカウントが必要である。
- Stripe では、ビジネスまたはプロジェクトごとに個別の Stripe サブアカウントを使用することが推奨されます。
- 複数のアカウント は、Stripe のドキュメントを参照すること。
- Stripe 管理者パーミッションが必要である。
手順
Stripe を支払いゲートウェイとして 3scale を設定するには、以下の手順に従います。
24.2.1. 3scale API Management 管理ポータルでの Billing API スコープを設定したアクセストークンの生成 リンクのコピーリンクがクリップボードにコピーされました!
- 3scale 管理ポータルで、Account Settings > Personal > Tokens の順に移動します。
Billing API スコープを設定して 読み取り/書き込み のトークンを作成します。
- Add Access Token をクリックします。
- トークンの名前を指定します。
- スコープに Billing API を選択します。
- パーミッションレベルに 読み取り/書き込み を選択します。
- Create Access token をクリックします。
アクセストークンをコピーします。
- アクセストークンをファイルテキストにコピーしてください。これ以降アクセストークンは表示されません。
- トークンの生成を完了するには、I have copied the token をクリックします。
24.2.2. Stripe からのキーおよび Webhook シークレットの取得 リンクのコピーリンクがクリップボードにコピーされました!
- Stripe で Webhook を設定する必要があります。
- Webhook を使用して、支払いが成功したことを 3scale に通知します。
- その後、3scale は請求書の状態を更新し、それ以上の請求を防止します。
Stripe アカウントで、Secret Key および Publishable Key を取得します。
- Stripe ダッシュボードを開きます。
- Stripe ドキュメントの手順に従って、API キーを確認してください。
- Secret Key および Publishable Key をコピーします。
引き続き、Stripe アカウントで Webhook Signing Secret を作成します。
- Developers > Webhooks の順に移動します。
- Add endpoint をクリックします。
以下のエンドポイント URL を入力します。
https://<Your-provider-admin-domain>/api/payment_callbacks/stripe_callbacks?access_token=<value-of-access-token>
https://<Your-provider-admin-domain>/api/payment_callbacks/stripe_callbacks?access_token=<value-of-access-token>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Events to send に
payment_intent.succeeded
を追加します。 - Add endpoint をクリックします。
- クリックして作成した Webhook の署名シークレットを表示し、このシークレットを書き留めます。これは Webhook Signing Secret です。
24.2.3. 3scale API Management 管理ポータルでの課金設定 リンクのコピーリンクがクリップボードにコピーされました!
3scale 管理ポータルで以下を行います。
- Audience > Billing > Charging & Gateway の順に移動します。
- Charging enabled を選択し、Save をクリックします。
- Credit card gateway > Gateway で、Stripe をゲートウェイとして選択します。
- Stripe からのキーおよび Webhook シークレットの取得 で Stripe アカウントから取得した Secret Key、Publishable Key、および Webhook Signing Secret を追加します。
- Save をクリックします。
24.2.4. 3scale 開発者ポータルでのクレジットカード情報の編集 リンクのコピーリンクがクリップボードにコピーされました!
- 開発者アカウントを使用して 3scale 開発者ポータルにログインします。
- Settings > Credit Card Details の順に移動します。
- クレジットカード情報 (クレジットカード番号、有効期限、および CVC) を追加します。
- Save details をクリックします。
24.2.5. unsuccessfully charged 電子メール応答のテキストを更新する リンクのコピーリンクがクリップボードにコピーされました!
SCA 支払いの修正に関連して、invoice_messenger_unsuccessfully_charged_for_buyer.text.liquid
メールのテキストには、3scale 2.10 での手動更新が必要です。
- 3scale 管理ポータルで Audience > Messages > Email Templates の順に移動します。
- Invoice charge failure for buyer with retry を選択します。
- Override をクリックします。
テンプレートのメッセージを更新します。以下は、課金に失敗した場合のメールレスポンスで使用される完全なテキストです。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Create Email Template をクリックします。
以下の手順により、unsuccessfully charged
メールのレスポンスのメールテンプレートを更新しました。