Checkout の仕組み

Checkout のライフサイクル

1. 顧客が購入を完了する準備ができると、アプリケーションは新しい Checkout セッションを作成します。
2. Checkout セッションは、顧客を Stripe がオンラインで提供する決済ページにリダイレクトする URL を提供します。
3. 顧客は決済ページに決済情報を入力し、取引を完了します。
4. 取引終了後、Webhook は checkout.session.completed イベントを使用して注文のフルフィルメントを履行します。

ローコードの組み込み

Checkout は最小限のコーディングしか必要とせず、事前構築済みの機能とカスタマイズオプションを備えているため、ほとんどの実装に適しています。Checkout を統合するには、Checkout Session を作成し、顧客の支払いの詳細を収集します。顧客を Stripe がオンラインで提供する決済ページにリダイレクトして、支払いを回収します。

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

機能

カスタムブランディング

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

カスタムドメイン

Stripe のカスタムドメイン機能を使用する場合は、Stripe がオンラインで提供する Checkout ページを自社カスタムドメインのサブドメインに配置できます。カスタムドメインは有料の機能です。情報については、料金体系と手数料をご覧ください。

Checkout セッション

Checkout セッションは、決済ページで顧客に対して表示される内容をプログラムで表現したものです。Checkout セッションを作成したら、顧客をセッションの URL にリダイレクトして購入を完了してもらいます。購入完了後、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 \
  --data-urlencode success_url="https://example.com/success"

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 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

支払い方法

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

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

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

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

ゲスト顧客

Customer オブジェクトは、ビジネスの顧客を表します。顧客の情報を保存し、サブスクリプションや決済と関連付けます。既存の Customers を使用しない Checkout Sessions や新しい Customers を作成しない Checkout Sessions は、代わりに ゲスト顧客 に関連付けられます。

有効期限

デフォルトでは、Checkout Sessions は 24 時間後に期限切れになります。

Checkout Sessions のカスタム有効期限を設定するには、expires_atパラメーターを設定します。Checkout Sessions の作成から 30 分後から 24 時間後までです。

期限切れ API を使用して、Checkout セッションを期限切れにすることもできます。

取引を完了する

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

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