Checkout の仕組み

Checkout のライフサイクル

1. 顧客が購入を完了する準備ができると、アプリケーションは新しい Checkout セッションを作成します。
2. ウェブサイトに Checkout を埋め込んで、決済フォームを表示します。
3. 顧客は決済情報を入力し、取引を完了します。
4. 取引終了後、checkout.session.completed Webhook イベントによって注文のフルフィルメントプロセスが開始されます。

ローコードの組み込み

最小限のコーディングのみを必要とする Checkout は、事前に構築された機能とカスタマイズ可能なオプションを持つため、ほとんどの構築システムにおける最適な選択肢です。Checkout は、Checkout セッションを作成し、購入者の支払い情報を収集することで実装できます。支払いを回収するには、ウェブサイトに決済フォームを埋め込みます。

Stripe の他の決済オプションと Checkout を比較して、最適なオプションを判断してください。Checkout は、顧客の支払い情報を収集を収集するための支払いフォームの表示、カード情報の検証、エラーの処理などを実行します。

カスタムブランディング

ダッシュボードのブランディング設定を使用し、オンラインフォームのフォント、色、アイコン、フィールドのスタイルなどを設定できます。 詳細は、Checkout のカスタマイズをご覧ください。

Checkout セッション

Checkout セッションは、決済フォームで顧客に対して表示される内容をプログラムで表現したものです。Checkout セッションを作成したら、Checkout を自社の決済ページにマウントして、購入を完了できるようにします。購入完了後、Checkout セッションイベントを処理するためにイベントの送信先を設定ことで注文のフルフィルメントを履行できます。クイックスタートガイドから抜粋されたこのコードスニペットは、アプリケーションで Checkout セッションを作成する方法の一例です。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

1 回限りの支払いと継続支払い

Checkout セッションで mode パラメーターを設定することにより、商品やサービスに対して顧客が 1 回限りの支払いを行ったり、サブスクリプションを選択したりできるようにします。

混合カート

Checkout で、顧客がサブスクリプションアイテムと 1 回限りの購入アイテムを同時に購入できる混合カートを作成します。混合カートを作成するには、mode パラメーターを subscription に設定し、line_items 配列の各 line_item には Price ID、または price_data を含めます。Price ID は、Stripe ダッシュボードまたは API を使用して作成された Price オブジェクトからのもので、商品カタログについての情報を Stripe に格納できます。

Stripe に商品カタログ情報を格納する代わりに、price_data を使用して、価格と商品の詳細を保存している外部データベースから情報を参照することもできます。詳細については、サブスクリプションシステムを構築するをご覧ください。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "line_items[1][price]"={{ONE_TIME_PRICE_ID}} \
  -d "line_items[1][quantity]"=1 \
  -d mode=subscription \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

支払い方法

Stripe ダッシュボードでは、いつでもさまざまな支払い方法を表示、有効化、無効化することができます。Stripe は、特定の支払い方法をデフォルトで有効にします。また、通知後に追加の支払い方法を有効にする場合があります。Stripe の支払い方法のリストをご覧ください。

決済情報とデフォルトの支払い方法を保存する

セッションを作成する際に API パラメーターを送信すると、将来の使用のために支払いの詳細を保存できます。支払いの詳細を保存するためのオプションは以下のとおりです。

• 単一の決済: Checkout セッションで payment モードを使用している場合には、payment_intent_data.setup_future_usage パラメーターを設定します。
• サブスクリプションの決済: Checkout セッションで subscription モードを使用している場合には、Stripe はデフォルトで支払い方法を保存します。
• 支払い方法の複数保存: 1 人の顧客に複数の支払い方法が保存されている場合は、Customer オブジェクトの default_payment_method フィールドにデフォルトの支払い方法を格納できます。ただし、これらの支払い方法は Checkout での返品購入には表示されません。

ゲスト顧客

Customer オブジェクトは、ビジネスの顧客を表し、同じ顧客に属するサブスクリプションと支払いを追跡するために使用できます。Customer を作成しない Checkout セッションの場合は、代わりにゲスト顧客に関連付けられます。

取引を完了する

取引が行われた後にビジネスフローを自動化するには、イベントの送信先を登録して、Webhook エンドポイントハンドラを構築します。以下のイベントと自動化を検討してください。

• checkout.session.completed イベントを処理して、顧客が購入した完了したときに注文のフルフィルメントを実行します。
• checkout.session.expired イベントを処理して、ユーザーが購入せず、カードの期限が切れた場合に、在庫にアイテムを返品するか、カード放棄メールをユーザーに送信します。