コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

Stripe Checkout システムを更新して、Managed Payments を使用する公開プレビュー

既存の Stripe システムを更新して、Managed Payments を利用する方法をご紹介します。

利用規約が必要

Managed Payments を利用する前に、ダッシュボードにある Managed Payments 利用規約に同意する必要があります。

Stripe Checkout の既存のインテグレーションを更新して、Managed Payments を使用します。インテグレーションは、payment または subscription モードで Checkout Sessions を作成し、すでに決済を受け付けている必要があります。

既存の Checkout のシステムがない場合は、代わりに Managed Payments を設定するをご覧ください。

更新する理由

Managed Paymentsの導入により、Stripeは間接税務コンプライアンス、不正利用防止、顧客取引サポート、注文管理の責任を負うことができます。詳細については、Managed Paymentsの仕組みを参照してください。

既存のサブスクリプション

このプレビュー期間中は、Managed Payments Checkout Session を通じて購入された新しいサブスクリプションに対してのみ Managed Payments を有効にできます。既存のサブスクリプションは対象外です。

はじめに

  • payment または subscription モードで Checkout Sessions を作成している既存の Stripe Checkout インテグレーション (ホスト型または埋め込み型フォーム) があります。
  • ダッシュボードで Managed Payments を有効にします。
  • お客様の製品が Managed Payments の資格要件を満たしていることを確認します。Managed Paymentsで決済を処理するには、顧客が購入するすべての製品が資格を満たしている必要があります。
  • API バージョン 2025-03-31.basil 以降を使用していることを確認してください。

Managed Payments に商品を設定する

Managed Payments で税金を計算するには、商品に税コードが設定されている必要があります。対象の税コードを確認するには、Managed Payments の仕組みをご覧ください。

ダッシュボードまたは API を使用して、各商品の税コードを設定します。

商品税コードを更新するには、以下のようにします。

  1. ダッシュボード > 商品カタログに移動します。
  2. 更新する商品の横にあるオーバーフローメニュー () をクリックします。
  3. 商品を編集をクリックします。
  4. 商品税コード を選択します。対象となる税コードには、「Managed Payments の 対象」というラベルが付けられます。
  5. 商品を更新 をクリックします。

Managed Payments で使用する各商品に、これを繰り返します。

Checkout Session を作成する際に商品をインラインで作成する場合、tax_code をproduct_data オブジェクトに含めます。例えば、サブスクリプションを受け付けるか、1 回限りの支払いを受け付けるかによって異なります：

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Checkout セッション作成時に Managed Payments を有効にする

サーバーから Checkout Session API 呼び出しを更新し、managed_payments[enabled] パラメーターを設定し、バージョンヘッダーに ;managed_payments_preview=v1 を含めてください。

以下に例を示します。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2026-01-28.clover; managed_payments_preview=v1" \
  -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"

サポートされていないパラメーターを削除する
サーバー側

マーチャントオブレコードとして機能するために、Stripe は Checkout Session の一部を制御します。その結果、Managed Payments の使用時に一部のパラメーターが利用できないため、Managed Payments Checkout Session の作成時にはそれらを除去する必要があります。

カテゴリーパラメーター理由
Taxautomatic_taxManaged Payments は税金の計算と源泉徴収を処理します。
tax_id_collection
subscription_data.default_tax_rates
決済手段payment_method_configurationManaged Payments は、動的決済手段を使用して Checkout Session で利用可能な決済手段を制御し、顧客に最も関連性の高い決済手段を表示します。Managed Payments の決済手段の設定方法については、決済手段の設定を参照してください。
payment_method_options
payment_method_types
顧客更新customer_update[name]Managed Payments では、消費税を計算するために顧客の名前と有効な請求先住所が必要です。Checkout Session の作成時に既存の顧客の ID を指定すると、Customer の名前または請求先住所が変更されるたびに更新されます。
customer_update[address]
配送料shipping_address_collectionManaged Payments はデジタル商品のみに対応しているため、配送情報が収集されることはありません。
shipping_options
Connectsubscription_data.application_fee_percentManaged Payments は Connect の実装には対応していません。
subscription_data.on_behalf_of
subscription_data.transfer_data
販売後subscription_data.invoice_settingsManaged Payments は、請求書の作成や確認メールといった、販売後のアクションを処理します。

テスト

実装が顧客に対して正しく機能するかをテストします。

決済

  1. サーバーを起動し、Checkout の構築から決済画面 ([http://localhost:4242/checkout.html](http://localhost:4242/checkout.html など) に移動します。
  2. 決済ボタンをクリックすると、Managed Payments の決済ページにリダイレクトされます。
  3. 決済ページで、異なる請求先住所を入力して、Managed Payments でさまざまな場所の顧客の税金がどのように計算されるかを確認します。
  4. 決済を処理するには、メールアドレス、電話番号、テストカード番号 4242 4242 4242 4242、任意のセキュリティコード、有効期限を入力します。

詳細については、テストをご覧ください。

支払いの詳細

  1. テスト支払いを確定したら、ダッシュボード>Payments リスト に移動します。
  2. テスト決済をクリックすると、決済の詳細が表示されます。このページには、次の情報が表示されます。
    • 購入された商品
    • 作成されたサブスクリプション
    • 作成された請求書
    • Managed Payments を通じて計算および源泉徴収された税額
    • 顧客の明細書に表示される明細書表記

顧客のオーソリ

サブスクリプションに関連付けられている決済手段は、Managed Payments によってのみ請求オーソリされます。Managed Payments 以外の取引に使用するには、顧客の承認を得る必要があります。

領収書をプレビューする

  1. Checkout サマリー の 請求書 をクリックします。
  2. 領収書を送信 をクリックすると、顧客に送信される領収書メールをプレビューできます。領収書をダウンロードすることもできます。

メモ

サンドボックスでは、購入後に領収書メールが自動的に送信されることはありませんが、上記の手順を使用して手動で送信できます。

Link

Link は Checkout 時のマーチャントオブレコードとして機能し、Link.com でサブスクリプション管理と取引サポートを提供します。

Link をテストするには、以下の手順に従います。

  1. 決済ページを開きます

  2. 決済ボタンをクリックします。

  3. 決済ページのテストに使用したものと同じメールアドレスを入力します。

  4. ポップアップモーダルで、テストパスコード 000000 を使用して認証します。

    初回の決済時に 情報を保存して決済をスピードアップする チェックボックスを選択した場合は、Link アカウントに保存された 4242 テストカードも表示されます。

オプション料金の税金処理を設定する

料金の tax_behavior は、設定した料金に税金を追加するか (tax_behavior: exclusive)、料金にすでに税を含めるか (tax_behavior: inclusive) を指定します。

Managed Payments では、価格に指定された税務処理が使用されます。価格への税務処理を指定しない場合、デフォルトでは、Managed Payments は設定された価格に課税します。

デフォルトを変更するには、ダッシュボード>税金設定 に移動して、価格に税金を含める設定を更新します。