プラットフォーム上の加盟店が直接決済を受け付けることができるようにする公開プレビュー

SaaS プラットフォーム上のビジネスが顧客から直接支払いを受け付けられるようにします。

加盟店が設定した連結アカウントが、ブランディングを反映した Stripe がホストする決済ページを使用してダイレクト支払いを受け付けられるようにします。

Checkout Session を作成
クライアント側
サーバー側

サーバー側のエンドポイントを呼び出して Checkout Session を作成するチェックアウトボタンを Web サイトに追加します。

checkout.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

サーバーで、項目、注文金額、通貨などの購入の詳細を含む決済フォームを顧客に表示する Checkout Session を作成します。レスポンスで返された URL に顧客をリダイレクトします。

パラメーター	説明
`line_items`	Stripe がホストする決済ページに最大 100 の購入アイテムをレンダリングします。
`payment_intent_data[application_fee_amount]`	プラットフォームが取引から差し引く金額をプラットフォーム手数料として指定します。この金額は、決済完了後にプラットフォーム残高に送金されます。詳細については、手数料を徴収をご覧ください。
`success_url`	決済完了後、Stripe が顧客をリダイレクトする場所です。Stripe はこのリクエストから生成された `{CHECKOUT_SESSION_ID}` で URL を更新します。Stripe がホストするページでリダイレクトの動作をカスタマイズし、以下を実行できます。 Checkout Session を取得し、そのステータスを調べて顧客に表示する内容を決定します。独自のクエリパラメーターを追加します。このパラメーターはリダイレクトプロセス全体にわたって存続します。
`Stripe-Account`	連結アカウントを取引のマーチャントオブレコードとして識別するヘッダー。決済では、プラットフォームのブランディングではなく連結アカウントのブランディングが使用されます。

連結アカウントで直接作成された支払いは、そのアカウントのみに報告されます。プラットフォームのダッシュボードやエクスポートには表示されません。ダイレクト支払いは、プラットフォームで管理される連結アカウントのレポートと Sigma に含まれています。Stripe API を使用することで、いつでもこの情報を取得できます。

支払い後のイベントを処理する
サーバー側

支払いが完了すると Stripe は checkout.session.completed イベントを送信します。Webhook を使用してこのイベントを受信し、顧客への注文確認メールの送信、データベースへの売上の記録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアント側では、コールバックの実行前に顧客がブラウザーのウィンドウを閉じたり、アプリケーションを終了したりする可能性があります。また、支払い方法によっては支払いの確定までに 2 ～ 14 日かかることがあります。自社の構築済みのシステムで非同期イベントをリッスンするように設定すると、一度の導入で複数の支払い方法に対応できるようになります。

Checkout で支払いを回収するときは、以下のすべてのイベントを処理することをお勧めします。

イベント	説明	次のステップ
checkout.session.completed	顧客が Checkout フォームを送信して、決済を正常に承認しました。	決済の成功または失敗の結果を待ちます。
checkout.session.async_payment_succeeded	顧客の決済が成功しました。	購入された商品やサービスのフルフィルメントを行います。
checkout.session.async_payment_failed	何らかの理由により決済が拒否されたか、失敗しました。	顧客にメールで連絡して、新たに注文するように依頼します。

これらのイベントのすべてに、Checkout Session (Checkout セッション) オブジェクトが含まれています。決済が成功すると、基となる PaymentIntent のステータスが processing から succeeded または失敗のステータスに変わります。

導入をテストする

カード番号	シナリオ	テスト方法
	カード支払いは成功し、認証は必要とされません。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	カード支払いには認証が必要です。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	カードは、`insufficient_funds` などの拒否コードで拒否されます。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
	UnionPay カードは、13 ～ 19 桁の可変長です。	クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。

実装内容をテストするためのその他の情報については、テストをご覧ください。

オプションその他の支払い方法を有効にする

ダッシュボードの連結アカウントの支払い方法を管理するに移動して、連結アカウントで対応する支払い方法を設定します。デフォルトの設定に対する変更は、新規および既存のすべての連結アカウントに適用されます。

支払い方法の情報に関する次のリソースをご覧ください。

支払い方法ガイドは、プラットフォームに適した支払い方法の選択に役立ちます。
アカウントのケイパビリティを使用して、選択した決済手段が連結アカウントで機能することを確認します。
決済手段と製品サポートの表を参照して、選択した決済手段が使用中の Stripe プロダクトと決済フローで機能することを確認します。

支払い方法ごとに、次のいずれかのドロップダウンオプションを選択できます。

デフォルトで有効にする	連結アカウントは、決済フローでこの支払い方法に対応します。一部の支払い方法は、無効またはブロックされている可能性があります。これは、Stripe ダッシュボードへのアクセスが許可された連結アカウントが、設定ページで有効化する必要があるためです。
デフォルトで無効にする	連結アカウントは、決済フローでこの支払い方法に対応しません。Stripe ダッシュボードへのアクセスが許可された連結アカウントに、自身の支払い方法を管理することを許可している場合、連結アカウントはこれを有効にすることができます。
ブロック済み	連結アカウントは、決済フローでこの支払い方法に対応しません。連結アカウントに Stripe ダッシュボードにアクセスして自身の支払い方法を管理することを許可していても、連結アカウントはこれを有効にできません。

支払い方法のドロップダウンオプション。支払い方法ごとに選択可能なオプション (ブロック済み、デフォルトで有効にする、デフォルトで無効にする) を示します。

支払い方法のオプション

支払い方法を変更した場合は、画面下部のバーにある変更を確認をクリックし、保存して適用をクリックして、連結アカウントを更新する必要があります。

保存ボタンをクリックした後に表示される、ユーザーが変更した内容のリストを含むダイアログ

保存ダイアログ

連結アカウントによる支払い方法の管理を許可する

Stripe では、連結アカウントが自身の支払い方法をカスタマイズできるようにすることをお勧めしています。このオプションを有効にすると、Stripe ダッシュボードにアクセスできる各連結アカウントは、支払い方法ページを表示および更新できるようになります。Stripe ダッシュボードには、新規および既存のすべての連結アカウントに対して適用される支払い方法のデフォルトのセットが表示されます。連結アカウントは、お客様がブロックした支払い方法を除き、これらのデフォルトを上書きできます。

このオプションを有効にするには、アカウントのカスタマイズチェックボックスを選択します。画面下部のバーにある変更を確認をクリックし、保存して適用をクリックして、この設定を更新する必要があります。

連結アカウントの所有者に支払い方法のカスタマイズを許可する際に選択するチェックボックスのスクリーンショット

アカウントのカスタマイズのチェックボックス

支払い方法ケイパビリティ

連結アカウントが追加の支払い方法を受け付けられるようにするには、連結アカウントが有効な各支払い方法のケイパビリティを設定していることを確認する必要があります。ほとんどの支払い方法には、card_payments ケイパビリティと同じ確認要件が適用されますが、いくつかの制限と例外があります。支払い方法ケイパビリティのテーブルには、カードの追加確認が必要な支払い方法のリストが記載されています。

ダッシュボードの連結アカウントの支払いの設定に移動して、支払い方法と国の組み合わせごとに、新規と既存の連結アカウントのケイパビリティをリクエストします。

次のステップ

収益化戦略に取引ごとの手数料の請求が含まれる場合は、各決済からプラットフォーム手数料を徴収する方法をご覧ください。
プラットフォームの使用に対してサブスクリプション手数料の決済を計画している場合は、請求書を使用してサービス手数料を支払う方法をご覧ください。