Stripe

もう 1 つの方法: 独自のキーを貼り付けます

ここから先はすべて手動パスです。 Stripe ダッシュボードで Webhook を設定し、そこで 3 つの値を収集し、Coin Moebius に貼り付けます。 10分程度を予定してください。上記でサインインしている場合は、すでに作業は完了しているため、この作業はすべてスキップできます。

必要なもの

これらはキー パスのみに必要です。上記の Stripe でサインインした場合、収集するものは何もありません。 Stripe は、テスト モードとライブ (pk_test_ / sk_test_ 対 pk_live_ / sk_live_) に個別のキーを保持し、それぞれに独自の Webhook 署名秘密が含まれます。 Coin Moebius は [ライブ] タブと [テスト] タブの両方で保持されるため、すべてを再入力することなく、テスト キーで検証し、後でライブ キーを追加できます。

各フィールドを尋ねる理由

Publishable key

チェックアウトが購入者のブラウザで開くとき、あなたのアカウントを識別します。設計上、公開です。

Secret key

請求の作成を承認する秘密の半分で、支払いがあなたのアカウントを通るようにします。

Webhook signing secret

届いた webhook が本当に Stripe からのものだと証明し、誰も「支払い済み」イベントを偽造できないようにします。secret key とは別の値です。

成功とキャンセルの URL

素の設定です。支払い後、または引き返した後に購入者がたどり着く先。秘密ではありません。

設定

1. テストモードを使う(無料)

   Stripe アカウントは無料で、テストモードは有効化の前から機能します。dashboard.stripe.com にサインインし、テストモードをオンにします(上部の隅)。まずテストで設定し、その後ライブで繰り返します。

2. キーをコピーする

   Developers → API keys に行き、Publishable key と Secret key をコピーします。

   ⤢
3. webhook を追加する
   1. Developers → Webhooks → Add endpoint。
   2. エンドポイント URL をプロジェクトの webhook アドレス(下記)に設定します。
   3. イベントを選びます。一回払いには:checkout.session.completed、charge.refunded、charge.dispute.created。サブスクリプションを売るなら、さらに:customer.subscription.created、customer.subscription.updated、customer.subscription.deleted、invoice.payment_succeeded、invoice.payment_failed。余分なイベントは無害です。使わないものは無視します。
   4. エンドポイントの Signing secret(whsec_…)をコピーします。テストとライブはそれぞれ別です。

   https://api.coinmoebius.com/webhook/stripe/<your project id>

   ⤢
4. テストする

   テストカードはテストモードでのみ機能し、実際のカードに請求することは決してありません。任意の未来の有効期限、任意の CVC、任意の郵便番号を使います。

   結果	カード
   成功	4242 4242 4242 4242
   認証が必要	4000 0025 0000 3155
   拒否	4000 0000 0000 9995

5. ダッシュボードでつなぐ

   プロバイダーを追加 → Stripe。publishable key、secret key、webhook signing secret、成功 URL、キャンセル URL を入力します。テストキーで流れを確認し、その後プロバイダーを編集してライブキーに差し替えます。

接続した後

ライブを開始する前に 1 回支払いを行ってください。

1. Stripe でサインインしていますか?あなたのアカウントは有効です。ご自身のカードで 1 ドルの商品を購入し、その後 Stripe から返金してください。テストキーを貼り付けましたか?すべての支払いはテスト支払いであるため、上記のテスト カードを使用してください。
2. 商品を作り、プロジェクトに向けた買うボタンをページ(ローカルの HTML ファイルでも可)に置きます。
3. 上記のテストカードでチェックアウトします。
4. 取引タブを開きます。新しい行のステータスが succeeded に達したら、キーと webhook が両方とも端から端まで機能しています。

テスト キーを使用した場合は、プロバイダーを編集し、ライブ キーを交換すると、実際の支払いが発生します。

トラブルシューティング

Verify から始めてください。ダッシュボードで、Stripe カードの Verify をクリックします。 Stripe にアカウントについて尋ねるか、キーをチェックし、何か問題がある場合は特定のメッセージを返します。

Stripe でサインインすると、「アカウントが接続されました。アクションが必要です。」というメッセージが表示されました。

あなたの Stripe アカウントは接続されていますが、Stripe はまだカード支払いをクリアしていません。 Stripe を開き、要求される内容 (通常はビジネスの詳細または銀行口座) を完了し、Coin Moebius の Stripe カードの Verify をクリックします。

Stripe カードには「切断されました」と表示されます。

Coin Moebius はあなたの Stripe アカウントから削除されました。通常は Stripe の承認済みアプリケーション ページから削除されました。カードを開いて Edit を選択し、Reconnect をクリックして再度承認します。

検証がキーの形式が違うと言う。

secret key は sk_test_ または sk_live_ で始まります(制限付きキーは rk_ で始まります)。webhook signing secret は whsec_ で始まります。正しい値を正しいフィールドに改めてコピーしてください。

検証が Stripe にキーを拒否されたと言う。

Developers → API keys から secret key を改めてコピーし、テストキーとライブの webhook secret(またはその逆)を組み合わせていないか確認してください。

支払いは完了するのに、注文が保留のまま。

webhook が届いていません。エンドポイント URL が正確に一致すること、checkout.session.completed を選んだこと、テスト支払いがテストモードのエンドポイントに当たっていること(テストとライブは別のエンドポイントです)を確認してください。

署名の検証が失敗する。

Stripe の各エンドポイントは独自の signing secret を持ちます。別のエンドポイントではなく、このエンドポイントの設定から whsec_ をコピーしてください。

端から端まで確認する。

Stripe にはシミュレートのボタンがありません。Stripe Dashboard で最近のイベントをエンドポイントに再送するか、テストの PaymentIntent を作り、注文が更新されるのを見てください。

知っておくとよいこと

Stripe でサインインしました. コピー、保存、またはローテーションするキーや Webhook シークレットはありません。 Stripe は、アカウントが変更されると Coin Moebius に通知します。リンクを切断するには、Stripe カードの Disconnect をクリックするか、Stripe の承認済みアプリケーションの下にある Coin Moebius を削除します。

キーのローテーション. 自分のキーを貼り付けましたか?いつでも秘密キーまたは Webhook シークレットをロールし、新しい値を貼り付けます。 Secret フィールドは編集時に空白のままなので、ローテーションされたキーをドロップできます。

有効化. ライブキーは、アカウントが支払い向けに有効化されて初めて機能します。テストキーはすぐに機能します。

ご質問は? Join our Discord