Checkout Sessions API と Payment Intents API の比較
Checkout Sessions API と Payment Intents API の違いと、Stripe Elements で使用するタイミングについて説明します。
Stripe は、Elements で使用できる 2 つのコア決済 API を提供しており、これを使用して、さまざまなレベルのカスタマイズと決済フローの制御を可能にします。Checkout Sessions API は、カスタムコードを必要としない組み込み機能を備えた一般的な Checkout ワークフローをサポートし、ほとんどの開発者に推奨されます。Payment Intents API を使用すると、カスタムコードを使用して Checkout プロセスをより詳細に制御できますが、導入コードとメンテナンスが必要になります。
メモ
このガイドは、Elements での API の使用に固有のものです。その他のユースケースについては、決済導入の設計 を参照してください。
適切な API を選択する
ビジネスに適した API を理解して、必要な機能にアクセスし、長期的に管理するコードの量を決定することが重要です。Checkout Sessions では、PaymentIntents では利用できない新しい組み込み機能が引き続きサポートされます。PaymentIntents を使用する場合は、コードで同様の機能を手動で構築できます。Adaptive Pricing などの一部の機能では、PaymentIntents を使用して手動で構築するには多大な労力が必要です。
| Checkout Sessions | Payment Intents | |
|---|---|---|
| 推奨されるビジネス | 導入コードの削減、長期間にわたるコードのメンテナンスの削減、Checkout の状態を管理する組み込み機能 (割引、項目、消費税、Adaptive Pricing など) の利用を希望する企業。 | 独自の税金エンジン、サブスクリプションエンジン、プロモーションコードエンジンがあり、組み込み機能なしで独自の Checkout セッションを構築および管理できる柔軟性を必要とするビジネス。 |
| 導入 | コードを使用して Checkout ページを追加し、追加の商品を統合します。たとえば、Payment Intents API では税金 API とリンクの計算を手動で呼び出す必要があるのに対し、automatic_] を設定して Stripe Tax を有効にします。 | Payment Intents API を使用すると、Checkout や決済機能を完全に制御できます。税金、割引、サブスクリプション、通貨換算を使用して最終的な金額を自分で計算できます。 |
| ユーザーインターフェイス |
| Elements |
| 複雑さ | シンプルなユースケースから複雑なユースケースまで、ビジネスの成長に合わせて構築されています。 | オーダーメイドソリューションを必要とする高度で複雑なユースケースを持つ大企業に最適です。 |
機能比較
| 機能 | Checkout Sessions API | Payment Intents API |
|---|---|---|
| デザイン | 項目、税金、配送料を含む決済フローのすべてに使用します。 | カスタムビジネスロジックによる詳細な決済管理を必要とする複雑なユースケースに使用します。 |
| 税金計算 | 組み込み税金計算と Stripe Tax。 | 税金 API を別途導入する必要があります。 |
| Subscriptions | 組み込みサブスクリプション作成。 | サブスクリプション との個別の導入が必要。 |
| クーポンと割引 | 組み込みのクーポンと割引 処理。 | 割引を手動で計算する必要があります。 |
| 送料 | 組み込み配送料金計算。 | 送料を手動で計算する必要があります。 |
| UIの柔軟性 | 決済ページ、組み込みフォーム、Custom UI のホスティング。 | カスタム UI のみ。 |
| 住所情報の収集 | 組み込み顧客、請求先、配送先住所回収機能を搭載。 | 住所を手動で処理する必要があります。 |
| 注文の追跡 | 組み込み注文サマリーと領収書機能を搭載。 | カスタム注文追跡の実装が必要。 |
| 金額の更新 | インベントリと項目の動的な更新。 | 金額を手動で更新する必要があります。 |
| セッション有効期限 | 24 時間後に自動有効期限。 | 自動有効期限なし。 |
| Webhook イベント | 決済ライフサイクル全体の Webhook イベント。 | 決済ステータスイベントのみ。 |