# Stripe Checkout システムを更新して、Managed Payments を使用する 既存の Stripe システムを更新して、Managed Payments を利用する方法をご紹介します。 > #### 利用規約が必要 > > Managed Payments を利用する前に、[ダッシュボード](https://dashboard.stripe.com/settings/managed-payments)にある [Managed Payments 利用規約](https://stripe.com/legal/managed-payments)に同意する必要があります。 [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) の既存のインテグレーションを更新して、Managed Payments を使用します。インテグレーションは、`payment` または `subscription` モードで *Checkout Sessions* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription) を作成し、すでに決済を受け付けている必要があります。 既存の Checkout のシステムがない場合は、代わりに [Managed Payments を設定する](https://docs.stripe.com/payments/managed-payments/set-up.md)をご覧ください。 ### 更新する理由 Managed Paymentsの導入により、Stripeは間接税務コンプライアンス、不正利用防止、顧客取引サポート、注文管理の責任を負うことができます。詳細については、[Managed Paymentsの仕組み](https://docs.stripe.com/payments/managed-payments/how-it-works.md)を参照してください。 ### 既存のサブスクリプション このプレビュー期間中は、Managed Payments Checkout Session を通じて購入された新しいサブスクリプションに対してのみ Managed Payments を有効にできます。既存のサブスクリプションは対象外です。 ## Before you begin - `payment` または `subscription` モードで Checkout Sessions を作成している既存の Stripe Checkout インテグレーション ([ホスト型](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted)または[埋め込み型フォーム](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=embedded-form)) があります。 - [ダッシュボード](https://dashboard.stripe.com/settings/managed-payments)で Managed Payments を有効にします。 - 商品が Managed Payments の[対象要件](https://docs.stripe.com/payments/managed-payments/eligibility.md)を満たしていることを確認してください。Managed Payments で決済を処理するには、顧客が購入するすべての商品が対象要件を満たしている必要があります。 - Checkout Session の作成には、[プレビュー API バージョン](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel) `2025-04-30.preview` 以降を使用します。 ## Managed Payments に商品を設定する 税金を計算するには、Managed Payments では*商品* (Products represent what your business sells—whether that's a good or a service)に*税コード* (A tax code is the category of your product for tax purposes)が設定されている必要があります。[対象の税コード](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes)を参照してください。 ダッシュボードまたは API を使用して、各商品の税コードを設定します。 #### ダッシュボード 商品税コードを更新するには、以下のようにします。 1. **ダッシュボード** > [商品カタログ](https://dashboard.stripe.com/products)に移動します。 1. 更新する商品の横にあるオーバーフローメニュー (⋯) をクリックします。 1. **商品を編集**をクリックします。 1. **商品税コード** を選択します。対象となる税コードには、「Managed Payments の **対象**」というラベルが付けられます。 1. **商品を更新** をクリックします。 #### API 商品税コードを更新するには、以下のようにします。 ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}} \ -u "<>:" \ -d tax_code={{TAX_CODE}} ``` Managed Payments で使用する各商品に、これを繰り返します。 [Checkout Session](https://docs.stripe.com/api/checkout/sessions/create.md) を作成する際に商品をインラインで作成する場合、`tax_code` を`product_data` オブジェクトに含めます。例えば、サブスクリプションを受け付けるか、1 回限りの支払いを受け付けるかによって異なります： #### サブスクリプション ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][product_data][name]=Basic subscription" \ -d "line_items[0][price_data][product_data][tax_code]={{TAX_CODE}}" \ -d "line_items[0][price_data][recurring][interval]=month" \ -d "line_items[0][quantity]=1" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" ``` #### 1 回限りの支払い ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price_data][product_data][name]=1000 tokens" \ -d "line_items[0][price_data][product_data][tax_code]={{TAX_CODE}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Checkout セッション作成時に Managed Payments を有効にする [決済セッション API](https://docs.stripe.com/api/checkout/sessions/create.md) へのサーバーの呼び出しを更新して `managed_payments[enabled]` パラメーターを設定し、[プレビュー API バージョン](https://docs.stripe.com/sdks/versioning.md#public-preview-release-channel)を使用します。 以下に例を示します。 #### サブスクリプション ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "managed_payments[enabled]=true" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" ``` #### 1 回限りの支払い ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "managed_payments[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## サポートされていないパラメーターを削除する [サーバー側] #### サブスクリプション マーチャントオブレコードとして機能するために、Stripe は Checkout Session の一部を制御します。その結果、Managed Payments の使用時に一部のパラメーターが利用できないため、Managed Payments Checkout Session の作成時にはそれらを除去する必要があります。 | カテゴリー | パラメーター | 理由 | | ------------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Adaptive Pricing | `adaptive_pricing` | Managed Payments では Adaptive Pricing が常に有効です。 | | Tax | `automatic_tax` | Managed Payments は税金の計算と源泉徴収を処理します。 | | `tax_id_collection` | | `subscription_data.default_tax_rates` | | 決済手段 | `payment_method_configuration` | Managed Payments は、[動的決済手段](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)を使用して Checkout Session で利用可能な決済手段を制御し、顧客に最も関連性の高い決済手段を表示します。Managed Payments の決済手段の設定方法については、[決済手段の設定](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments)を参照してください。 | | `payment_method_options` | | `payment_method_types` | | 顧客更新 | `customer_update[name]` | Managed Payments では、消費税を計算するために顧客の名前と有効な請求先住所が必要です。Checkout Session の作成時に[既存の顧客](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer)の ID を指定すると、[Customer](https://docs.stripe.com/api/customers/object.md) の名前または請求先住所が変更されるたびに更新されます。 | | `customer_update[address]` | | 配送料 | `shipping_address_collection` | Managed Payments はデジタル商品のみに対応しているため、配送情報が収集されることはありません。 | | `shipping_options` | | Connect | `subscription_data.application_fee_percent` | Managed Payments は Connect の実装には対応していません。 | | `subscription_data.on_behalf_of` | | `subscription_data.transfer_data` | | 販売後 | `subscription_data.invoice_settings` | Managed Payments は、請求や確認メールなど、販売後のアクションを処理します。 | | `invoice_creation` | #### 1 回限りの支払い { % glossary term=“merchant-of-record” %} マーチャント・オブ・レコード { % /glossary % } として動作するために、Stripe は Checkout Session の一部を制御します。その結果、Managed Paymentsの使用時にいくつかのパラメーターが利用できなかったり、Managed Payments Checkout Sessionsの作成時にそれらを除去しなければならないことがあります。 | カテゴリー | パラメーター | 理由 | | ------------------------------------------------------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tax | `automatic_tax` | Managed Payments は税金の計算と源泉徴収を処理します。 | | `tax_id_collection` | | 決済手段 | `excluded_payment_method_types` | Managed Payments は、[動的決済手段](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)を使用して Checkout Session で利用可能な決済手段を制御し、顧客に最も関連性の高い決済手段を表示します。Managed Payments の決済手段の設定方法については、[決済手段の設定](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments)を参照してください。 | | `adaptive_pricing` | | `payment_intent_data.setup_future_usage` | | `payment_method_configuration` | | `payment_method_options.{payment_method}.setup_future_usage` | | `payment_method_types` | | 顧客更新 | `customer_update[name]` | Managed Payments では、消費税を計算するために顧客の名前と有効な請求先住所が必要です。Checkout Session の作成時に[既存の顧客](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer)の ID を指定すると、[Customer](https://docs.stripe.com/api/customers/object.md) の名前または請求先住所が変更されるたびに更新されます。 | | `customer_update[address]` | | 配送料 | `shipping_address_collection` | Managed Payments はデジタル商品のみに対応しているため、配送情報が収集されることはありません。 | | `shipping_options` | | `payment_intent_data.shipping` | | Connect | `payment_intent_data.application_fee_amount` | Managed Payments は Connect の実装には対応していません。 | | `payment_intent_data.on_behalf_of` | | `payment_intent_data.transfer_data` | | `payment_intent_data.transfer_group` | | 販売後 | `invoice_creation` | Managed Payments は、請求書の作成や確認メールといった、販売後のアクションを処理します。 | | `payment_intent_data.statement_descriptor` | | `payment_intent_data.statement_descriptor_suffix` | | `payment_intent_data.receipt_email` | ## テスト 実装が顧客に対して正しく機能するかをテストします。 ### 決済 1. サーバーを起動し、[Checkout の構築](https://docs.stripe.com/payments/managed-payments/set-up.md#build-your-checkout)から決済画面 ([http://localhost:4242/checkout.html](http://localhost:4242/checkout.html など) に移動します。 1. 決済ボタンをクリックすると、Managed Payments の決済ページにリダイレクトされます。 1. 決済ページで、異なる請求先住所を入力して、Managed Payments でさまざまな場所の顧客の税金がどのように計算されるかを確認します。 1. 決済を処理するには、メールアドレス、電話番号、テストカード番号 `4242 4242 4242 4242`、任意のセキュリティコード、有効期限を入力します。 詳細については、[テスト](https://docs.stripe.com/testing.md)をご覧ください。 ### 支払いの詳細 #### Item 1 1. テスト決済を確認したら、**ダッシュボード** > [Transactions](https://dashboard.stripe.com/test/payments) に移動します。 1. テスト決済をクリックすると、決済の詳細が表示されます。このページには、次の情報が表示されます。 - 購入された商品 - 作成された[サブスクリプション](https://docs.stripe.com/api/subscriptions.md) - 作成された[請求書](https://docs.stripe.com/api/invoices.md) - Managed Payments を通じて計算および源泉徴収された税額 - 顧客の明細書に表示される明細書表記 > #### 顧客のオーソリ > > 顧客が Managed Payments を通じてサブスクリプションを購入した場合、その決済手段は Managed Payments による請求に対してのみオーソリされます。Managed Payments 以外の取引でこの決済手段に請求するには、顧客から適切な同意を得てください。 #### Item 2 1. テスト決済を確認したら、**ダッシュボード** > [Transactions](https://dashboard.stripe.com/test/payments) に移動します。 1. テスト決済をクリックすると、決済の詳細が表示されます。このページには、次の情報が表示されます。 - 購入された商品 - 作成された[サブスクリプション](https://docs.stripe.com/api/subscriptions.md) (購入した場合) - 作成された[請求書](https://docs.stripe.com/api/invoices.md) - Managed Payments を通じて計算および源泉徴収された税額 - 顧客の明細書に表示される明細書表記 #### 領収書をプレビューする 1. **Receipt history** で、**View receipt** をクリックします。 1. **Send receipt** をクリックすると、顧客に送信される領収書メールをプレビューできます。 > サンドボックスモードでは、購入後に領収書メールは自動送信されませんが、上記の手順に従って手動で送信できます。 ### Link [Link](https://docs.stripe.com/payments/link.md)は決済時にマーチャントオブレコードとして機能し、[Link website](https://link.com)でサブスクリプション管理と取引サポートを提供します。 決済時の Link の動作をテストするには、初回の Checkout Session で Link アカウントを作成します。Link アカウントを作成したら、同じメールアドレスを使用して別のセッションを試行します。認証するには、テストパスコード `000000` を使用します。 テスト購入は Link アプリには表示されません。本番環境の Checkout Session 中に Link アカウントを作成することで、Link アプリで注文管理ツールをテストできます。 ## Optional: 料金の税金処理を設定する 料金の [tax_behavior](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior) は、設定した料金に税金を追加するか (`tax_behavior: exclusive`)、料金にすでに税を含めるか (`tax_behavior: inclusive`) を指定します。 Managed Payments では、[価格に指定された税務処理](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price)が使用されます。価格への税務処理を指定しない場合、デフォルトでは、Managed Payments は設定された価格に課税します。 デフォルトを変更するには、**ダッシュボード**\>[税金設定](https://dashboard.stripe.com/settings/tax) に移動して、**価格に税金を含める**設定を更新します。