# Checkout 移行ガイド Stripe の最新の組み込みに移行する方法をご紹介します。 ![](https://b.stripecdn.com/docs-statics-srv/assets/migration.4db0b4061fb36d6a43762c3f23ef9c00.png) レガシーバージョンの Checkout では、顧客にモーダルダイアログを表示し、そこでカード情報を収集して、貴社のウェブサイトにトークンまたはソースを返していました。これに対して、[Payment Links](https://docs.stripe.com/payment-links.md) と新バージョンの [Checkout](https://docs.stripe.com/payments/checkout.md) は、Stripe がオンラインで提供する、支払いまたは*サブスクリプション* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis)を作成するための洗練された決済ページです。どちらの連携機能も、Apple Pay、Google Pay、動的な *3D セキュア* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments)、*Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients)、既存の*顧客* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)の再利用など多くの機能に対応しています。Payment Links や Checkout がユースケースに合わない場合は、[他の決済連携を比較](https://docs.stripe.com/payments/online-payments.md#compare-features-and-availability)することもできます。 ## Before you begin Stripe の [SDK](https://docs.stripe.com/sdks.md) を使用している場合は、最新バージョンにアップグレードしてください。 ## ビジネスモデルを選択する レガシーバージョンの Checkout からに移行するには、お客様のビジネスモデルに最もよく適合するガイドを使用してください。各ガイドでは、推奨される組み込みパスがサンプルコードとともに示されています。 - [動的な商品カタログおよび料金体系](https://docs.stripe.com/payments/checkout/migration.md#api-products) 大規模な商品カタログを所有している場合や、動的に生成されるラインアイテム (寄付や税金など) への対応が必要な場合。 - [動的なサブスクリプション](https://docs.stripe.com/payments/checkout/migration.md#api-subscriptions) SaaS プロバイダとしてユーザに請求を行い、高度な機能への対応が必要な場合。 - [Connect プラットフォームとマーケットプレイス](https://docs.stripe.com/payments/checkout/migration.md#connect) サービスプロバイダと顧客をつなぐマーケットプレイスを運営している場合。 - [将来の利用に備えて支払い方法を保存する](https://docs.stripe.com/payments/checkout/migration.md#setup-mode) アフターサービスの提供後に顧客に請求を行うビジネスを運営している場合。 - [固定価格によるシンプルな商品カタログ](https://docs.stripe.com/payments/checkout/migration.md#simple-products) 数点の商品を事前設定済みの価格で販売している場合。 - [シンプルなサブスクリプション](https://docs.stripe.com/payments/checkout/migration.md#simple-subscriptions) SaaS プロバイダとして、月額のサブスクリプションプランを提供している場合。 関連する移行ガイドに従う際に、特定のパラメータおよび設定オプションのマッピングを示した[変換表](https://docs.stripe.com/payments/checkout/migration.md#parameter-conversion)を参照することもできます。 ## 動的な商品カタログおよび料金体系 金額やラインアイテムが動的に決定される商品を販売している場合 (大規模な商品カタログを所有していたり、寄付を目的とする場合など) は、[1 回限りの支払いの受け付け](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout)をご覧ください。 レガシーバージョンの Checkout では、クライアント側でトークンまたはソースを作成し、それをサーバに渡して支払いを作成していたかもしれません。現行バージョンの Checkout ではこのフローは逆になります。まずサーバー側でセッションを作成し、顧客を Checkout にリダイレクトします。支払い後に、顧客はお客様のアプリケーションに再度リダイレクトされます。 ### 移行前 レガシーバージョンの Checkout では、動的な金額と明細を表示して、顧客からカード情報を収集していました。 ```html
``` 次に、生成されたトークンやソースをサーバに送信し、それに請求していました。 #### curl ```bash curl https://api.stripe.com/v1/customers \ -u <>: \ -d "email"="customer@example.com" \ -d "source"="{{STRIPE_TOKEN}}" curl https://api.stripe.com/v1/charges \ -u <>: \ -d "customer"="{{CUSTOMER_ID}}" \ -d "description"="Custom t-shirt" \ -d "amount"="{{ORDER_AMOUNT}}" \ -d "currency"="usd" ``` ### 移行後 ウェブサイトにサーバー側のエンドポイントを呼び出す決済ボタンを追加して [Checkout セッション](https://docs.stripe.com/api/checkout/sessions/create.md)を作成します。 ```html Buy cool new product
``` Checkout セッションは、顧客が支払いフォームにリダイレクトされた際に表示される内容をプログラムで示したものです。以下のようなオプションを使用して設定できます。 - 請求する[ラインアイテム](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) - 使用する通貨 支払いを完了した後に顧客をリダイレクトするウェブサイト上のページの URL を `success_url` に含めます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][currency]"=usd \ -d "line_items[0][price_data][product_data][name]"="Custom t-shirt" \ -d "line_items[0][price_data][unit_amount]"=2000 \ -d "line_items[0][quantity]"=1 \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` Checkout セッションを作成したら、レスポンスで返された [URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) に顧客をリダイレクトします。支払い後に購入した商品のフルフィルメントを行う必要がある場合は、[Checkout および Payment Link の支払いのフルフィルメント](https://docs.stripe.com/checkout/fulfillment.md)をご覧ください。 ## 動的なサブスクリプション 動的に決定されるサブスクリプションサービスを提供している場合や、その他の高度な機能のサポートが必要な場合は、[サブスクリプションの設定](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md)をご覧ください。 レガシーバージョンの Checkout では、クライアント側でトークンまたはソースを作成し、それをサーバに渡して支払いを作成していたかもしれません。現行バージョンの Checkout ではこのフローは逆になります。まずサーバー側でセッションを作成し、顧客を Checkout にリダイレクトします。支払いが成功すると、顧客はお客様のアプリケーションに再度リダイレクトされます。 ### 移行前 レガシーバージョンの Checkout では、サブスクリプション情報を表示して、顧客からカード情報を収集していました。 ```html
``` 次に、生成されたトークンやソースをサーバに送信し、顧客およびサブスクリプションを作成していました。 #### curl ```bash curl https://api.stripe.com/v1/customers \ -u <>: \ -d "email"="customer@example.com" \ -d "source"="{{STRIPE_TOKEN}}" curl https://api.stripe.com/v1/subscriptions \ -u <>: \ -d "customer"="{{CUSTOMER_ID}}" \ -d "items[0][price]"="{PRICE_ID}" \ -d "trial_period_days"=30 ``` ### 移行後 ウェブサイトにサーバー側のエンドポイントを呼び出す決済ボタンを追加して [Checkout セッション](https://docs.stripe.com/api/checkout/sessions/create.md)を作成します。 ```html Subscribe to cool new service
``` Checkout セッションは、顧客が支払いフォームにリダイレクトされた際に表示される内容をプログラムで示したものです。以下のようなオプションを使用して設定できます。 - 請求する[ラインアイテム](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) - 使用する通貨 支払いを完了した後に顧客をリダイレクトするウェブサイト上のページの URL を `success_url` に含めます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d "subscription_data[trial_period_days]"=30 \ -d mode=subscription \ --data-urlencode success_url="https://example.com/success" ``` Checkout セッションを作成したら、レスポンスで返された [URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) に顧客をリダイレクトします。顧客とサブスクリプションが作成されると、顧客は `success_url` にリダイレクトされます。支払い後に購入したサービスのフルフィルメントを行う必要がある場合は、[Checkout および Payment Link の支払いのフルフィルメント](https://docs.stripe.com/checkout/fulfillment.md)をご覧ください。 ## Connect プラットフォームとマーケットプレイス お客様が Connect プラットフォームまたはマーケットプレイスを運営していて、連結アカウントに関連する支払いを作成する場合には、現行バージョンの Checkout を使用することを検討してください。 以下の例では、Checkout Sessions API を使用したダイレクト支払いの処理について説明しています。また、Checkout と Connect を[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md?platform=web&ui=stripe-hosted)および[支払いと送金別方式](https://docs.stripe.com/connect/separate-charges-and-transfers.md?platform=web&ui=stripe-hosted)で使用することもできます。 ### 移行前 レガシーバージョンの Checkout では、クライアント側で顧客からカード情報を収集していました。 ```html
``` 次に、生成されたトークンやソースをサーバに送信し、連結アカウントに代わって請求を行っていました。 #### curl ```bash curl https://api.stripe.com/v1/charges \ -u <>: \ -d "source"="{{TOKEN_ID}}" \ -d "description"="10 cucumbers from Roger\"s Farm" \ -d "amount"=2000 \ -d "currency"="usd" \ -d "application_fee_amount"=200 \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" ``` ### 移行後 ウェブサイトにサーバー側のエンドポイントを呼び出す決済ボタンを追加して [Checkout セッション](https://docs.stripe.com/api/checkout/sessions/create.md)を作成します。 ```html Roger's Farm
``` Checkout セッションは、顧客が支払いフォームにリダイレクトされた際に表示される内容をプログラムで示したものです。以下のようなオプションを使用して設定できます。 - 請求する[ラインアイテム](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) - 使用する通貨 支払いを完了した後に顧客をリダイレクトするウェブサイト上のページの URL を `success_url` に含めます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "line_items[0][price_data][currency]"=usd \ --data-urlencode "line_items[0][price_data][product_data][name]"="Cucumbers from Roger's Farm" \ -d "line_items[0][price_data][unit_amount]"=200 \ -d "line_items[0][quantity]"=10 \ -d "payment_intent_data[application_fee_amount]"=200 \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` Checkout セッションを作成したら、レスポンスで返された [URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) に顧客をリダイレクトします。支払い後に購入した商品またはサービスのフルフィルメントを行う必要がある場合は、[Checkout および Payment Link の支払いのフルフィルメント](https://docs.stripe.com/checkout/fulfillment.md)をご覧ください。 ## 将来の利用に備えて支払い方法を保存する 顧客に対して即時請求を行わないサービスを提供している場合は、[将来の支払いを設定する](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout)をご覧ください。 レガシーバージョンの Checkout では、クライアント側でトークンまたはソースを作成し、それをサーバに渡して今後の使用に備えて保存していたかもしれません。現行バージョンの Checkout ではこのフローは逆になります。まずサーバー側でセッションを作成し、顧客を Checkout にリダイレクトします。支払いが成功すると、顧客はお客様のアプリケーションに再度リダイレクトされます。 ### 移行前 レガシーバージョンの Checkout では、支払い情報を表示して、顧客からカード情報を収集していました。 ```html
``` 次に、結果として得られたトークンまたはソースをサーバに送信し、最終的に支払いを作成していました。 #### curl ```bash curl https://api.stripe.com/v1/customers \ -u <>: \ -d "email"="customer@example.com" \ -d "source"="{{STRIPE_TOKEN}}" curl https://api.stripe.com/v1/charges \ -u <>: \ -d "customer"="{{CUSTOMER_ID}}" \ -d "description"="Cleaning service" \ -d "amount"="{{ORDER_AMOUNT}}" \ -d "currency"="usd" ``` ### 移行後 ウェブサイトにサーバー側のエンドポイントを呼び出す決済ボタンを追加して [Checkout セッション](https://docs.stripe.com/api/checkout/sessions/create.md)を作成します。 ```html Cleaning service
``` Checkout セッションは、顧客が支払いフォームにリダイレクトされた際に表示される内容をプログラムで示したものです。以下のようなオプションを使用して設定できます。 - 請求する[ラインアイテム](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items) - 使用する通貨 支払いの設定を完了した後に顧客をリダイレクトするウェブサイト上のページの URL を `success_url` に含めます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=setup \ -d currency=usd \ --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" ``` Checkout セッションを作成したら、レスポンスで返された [URL](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-url) に顧客をリダイレクトして、決済手段の詳細を収集します。顧客は、フローを完了すると `success_url` にリダイレクトされます。支払いを回収する準備ができたら、Checkout セッションから [SetupIntent を取得](https://docs.stripe.com/payments/checkout/save-and-reuse.md?payment-ui=stripe-hosted#retrieve-checkout-session)し、それを使用して取引を準備します。 ## 固定価格によるシンプルな商品カタログ 固定料金の商品 (T シャツや電子書籍など) を販売している場合は、[決済用のリンク](https://docs.stripe.com/payment-links/create.md)に関するガイドをご覧ください。レガシーバージョンの Checkout を使用して、クライアント側でトークンまたはソースを作成し、それをサーバーに渡して請求を作成していた可能性があります。 ### 移行前 レガシーバージョンの Checkout では、金額と明細を表示して、顧客からカード情報を収集していました。 ```html
``` 次に、生成されたトークンやソースをサーバに送信し、顧客および請求を作成していました。 #### Curl ```bash curl https://api.stripe.com/v1/customers \ -u <>: \ -d "email"="{{STRIPE_EMAIL}}" \ -d "source"="{{STRIPE_TOKEN}}" curl https://api.stripe.com/v1/charges \ -u <>: \ -d "customer"="{{CUSTOMER_ID}}" \ -d "description"="T-shirt" \ -d "amount"=500 \ -d "currency"="usd" ``` ### 移行後 アイテムを表す[商品](https://docs.stripe.com/api/products.md)と[価格](https://docs.stripe.com/api/prices.md)を作成します。次の例では、Product インラインを作成します。これらのオブジェクトは、[ダッシュボード](https://dashboard.stripe.com/test/products)で作成することもできます。 ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=500 \ -d "product_data[name]"=T-shirt ``` 商品と価格を使用して、ダッシュボードで[決済用のリンク](https://dashboard.stripe.com/payment-links/create) を作成します。リンクを作成したら、**購入ボタン** をクリックしてデザインを設定し、ウェブサイトにコピーアンドペーストできるコードを生成します。 #### HTML ```html

Purchase your new kit

``` ## シンプルなサブスクリプション シンプルなサブスクリプションサービス (ソフトウェアへの月次アクセスなど) を提供している場合は、[決済用のリンク](https://docs.stripe.com/payment-links/create.md)に関するガイドをご覧ください。レガシーバージョンの Checkout を使用して、クライアント側でトークンまたはソースを作成し、それをサーバーに渡して顧客とサブスクリプションを作成していた可能性があります。 ### 移行前 レガシーバージョンの Checkout では、サブスクリプション情報を表示して、顧客からカード情報を収集していました。 ```html
``` 次に、生成されたトークンやソースをサーバに送信し、顧客およびサブスクリプションを作成していました。 #### Curl ```bash curl https://api.stripe.com/v1/customers \ -u <>: \ -d "email"="{{STRIPE_EMAIL}}" \ -d "source"="{{STRIPE_TOKEN}}" curl https://api.stripe.com/v1/subscriptions \ -u <>: \ -d "customer"="{{CUSTOMER_ID}}" \ -d "items[][price]"="{PRICE_ID}" \ -d "items[][quantity]"=1 ``` ### 移行後 サブスクリプションを表す[商品](https://docs.stripe.com/api/products.md)と[価格](https://docs.stripe.com/api/prices.md)を作成します。次の例では、Product インラインを作成します。これらのオブジェクトは、[ダッシュボード](https://dashboard.stripe.com/test/products)で作成することもできます。 ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d unit_amount=2000 \ -d "recurring[interval]"=month \ -d "product_data[name]"="Gold Tier" ``` 商品と価格を使用して、ダッシュボードで[決済用のリンク](https://dashboard.stripe.com/payment-links/create) を作成します。リンクを作成したら、**購入ボタン** をクリックしてデザインを設定し、ウェブサイトにコピーアンドペーストできるコードを生成します。 #### HTML ```html

Purchase your new kit

``` ## パラメータの変換 現行バージョンの Checkout は、レガシーバージョンの Checkout のほとんどの機能に対応していますが、同じAPI を共有しているわけではありません。次の表は、レガシーバージョンと現行バージョンのパラメーターおよび設定オプションの対応関係を示しています。設定オプションの一覧については、[Checkout セッション](https://docs.stripe.com/api/checkout/sessions.md) をご覧ください。 | レガシーバージョン | 現行バージョン | 組み込みのヒント | | -------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `allowRememberMe` | サポート対象外 | [Checkout セッション](https://docs.stripe.com/api/checkout/sessions/create.md)を作成する際に `customer` パラメーターを指定して、既存の顧客を再利用します。[Link](https://docs.stripe.com/payments/link/checkout-link.md) を有効にして、顧客が支払い情報を安全に保存し、再利用できるようにすることも可能です。 | | `amount` | すべての `line_items` の金額の合計として自動計算されます | 合計金額は Checkout に渡すラインアイテムの合計です。 | | `billingAddress` | `Session.billing_address_collection` | Checkout は、不正使用の防止または規制への準拠を目的として要求されたときに、請求先住所を自動的に収集します。このパラメータを `required` に設定すると、請求先住所が常に収集されます。 | | `closed` | 顧客が決済を閉じる場合は、ブラウザタブを閉じます。 | | `currency` | `Session.currency` | | | `description` | `Session.line_items.description` または `product.description` | 価格を指定すると、Checkout は支払いの発生頻度についての記述を自動的に計算して表示します。`Session.line_items` を指定すると、Checkout は各ラインアイテムの `name` を表示します。 | | `email` | `Session.customer_email` | 顧客のメールアドレスがすでにわかっている場合は、Checkout セッションを作成する際に、[customer_email](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_email) を事前入力できます。 | | `image` | **ビジネスブランディング**: ダッシュボードでブランドロゴまたはアイコンをアップロードします。 **商品画像**: 各ラインアイテムの画像を `product.images` で指定します。 | Checkout はお客様のビジネスの[ブランディング](https://docs.stripe.com/payments/checkout/customization/appearance.md#branding)と、販売する商品用に専用の画像を使用します。Checkout はデフォルトでビジネス名の横にビジネスロゴを表示し、ビジネスアイコンにフォールバックします。 | | `key` | Checkout にパラメータは渡されなくなりました | | | `locale` | `Session.locale` | Checkout Session の作成時に、サポートされている[ロケール](https://docs.stripe.com/payments/checkout/customization/policies.md#localization)を指定できます。 | | `name` | `Session.line_items` で指定された価格の `product.name` | 価格を指定した場合、Checkout はその価格と関連付けられている商品の名前を表示します。`Session.line_items` を指定した場合、Checkout は各ラインアイテムの `name` を表示します。 | | `panelLabel` | `submit_type` | Checkout により、販売する商品に応じてボタンのテキストを自動的にカスタマイズできます。1 回限りの支払いの場合は、[submit_type](https://docs.stripe.com/payments/checkout/customization/policies.md#submit-button) を使用して、ボタンのテキストをカスタマイズします。 | | `shippingAddress` | `session.shipping_address_collection` | 配送先の `allowed_countries` の配列を渡すことにより、[配送先住所情報を収集](https://docs.stripe.com/payments/collect-addresses.md?payment-ui=checkout)します。 | | `token` または `source` | `success_url` | 支払い完了時の JavaScript のコールバックはなくなりました。顧客は別のページで支払いを行っているため、支払い完了後に顧客をリダイレクトするように `success_url` を設定します。 | | `zipCode` | Checkout により自動的に収集されます | 不正使用の防止または規制への準拠を目的として要求される場合、Checkout は郵便番号を自動的に収集します。 | ## See also - [決済手段をさらに追加する](https://docs.stripe.com/payments/payment-methods/overview.md) - [住所と電話番号を収集する](https://docs.stripe.com/payments/collect-addresses.md)