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

Managed Payments を設定する公開プレビュー

Managed Payments を使用して決済を受け付ける方法をご紹介します。

利用規約が必要

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

Managed Payments を使用して、デジタル製品のグローバル決済を受け付けます。Managed Payments では、Stripe が代理でマーチャントオブレコードとして機能します。詳しくは、Managed Payments の仕組みをご覧ください。

はじめに

  • 商品が Managed Payments の対象要件を満たすことを確認します。Managed Payments で決済を処理するには、顧客が購入するすべての商品が対象である必要があります。
  • ダッシュボードで Managed Payments を有効にします。
  • 開発環境を設定します。
  • API バージョン 2025-03-31.basil 以降を使用していることを確認してください。

商品および価格を作成する

サブスクリプションや一括払いを受け付けることができます：

Stripeでは、商品を使用して、販売するさまざまな商品やサービスを表現します。例えば、ベーシックやプレミアムなど複数のサブスクリプションの段階がある場合、段階ごとに別々の商品を作成します。

料金では、顧客に請求する商品の代金とその請求頻度を指定します。1 つの商品に複数の料金を設定できます。たとえば、Basic サブスクリプションに 2 つの料金、月額 10 USD と年額 100 USD を設定できます。また料金によって、月額 10 USD や月額 15 CAD など、それぞれ異なる通貨オプションを定義することもできます。

販売する商品を作成し、各商品の料金を作成するには、ダッシュボードまたは API を使用します。

新しい商品と料金を作成する

以下の手順に従って、新しい商品を作成し料金を割り当ててください。

  1. ダッシュボード > 商品カタログに移動します。
  2. 商品を作成 をクリックします。
  3. 商品名、説明 を入力して、商品税コード を選択します。
    • 選択する税コードは、Managed Payments の対象である必要があります。対象となる税コードには、「Managed Payments の 対象」というラベルが付けられます。
  4. 料金に、金額 と 通貨 を入力します。
  5. このサブスクリプションの顧客への請求頻度に基づき 請求期間 を設定します。
  6. 右側のプレビューペインを使用して、所在地に基づく顧客の支払い税額を確認します。
  7. 商品を追加をクリックします。
  8. 販売するすべての商品に、この手順を繰り返します。

既存の商品に料金を追加する

既存の商品に別料金を追加するには、以下のようにします。

  1. 商品カタログを開きます。
  2. 料金を追加する商品をクリックします。
  3. 料金体系 セクションの + ボタンをクリックします。
  4. 上記のように料金を設定します。
  5. 料金を作成 をクリックします。

決済フローを構築する
クライアント側

Stripe Checkout を使用すると、Stripe 上のオンライン決済ページで顧客の決済を受け付けられます。顧客を決済ページにリダイレクトする責任は、貴社が負います。決済が完了すると、Stripe は顧客を貴社サイトにリダイレクトします。詳細については、Checkout の仕組みをご覧ください。

決済フローを構築するには、決済ボタンと成功ページをサイトに追加する必要があります。

購入ボタンを追加する

ウェブサイトに、サーバー上のエンドポイントを呼び出す決済ボタンを追加します。以下に例を挙げます。

checkout.html
<html>
  <head>
    <title>Subscribe to our cool new service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

顧客がこのボタンをクリックすると、Stripe 上のオンライン決済フページにリダイレクトされます。

成功ページを追加する

次に、正常に決済した後に顧客に表示される、成功ページを作成します。この成功ページを貴社サイトでホストしてください。以下に例を挙げます。

success.html
<html>
  <head><title>Thanks for subscribing!</title></head>
  <body>
    <h1>Thanks for subscribing!</h1>
    <p>
      We appreciate your business!
      If you have any questions, please email us at
      <a href="mailto:orders@example.com">orders@example.com</a>.
    </p>
  </body>
</html>

オーソリされた支払いを完了すると、顧客はこのページにリダイレクトされます。

キャンセルページを追加する (オプション)

また、顧客が決済プロセスを終了したかどうかを確認するための、キャンセルページを作成することもできます。以下に例を挙げます。

cancel.html
<html>
  <head>
    <title>Checkout canceled</title>
  </head>
  <body>
    <p>Not ready to subscribe yet? No problem, we'll be here when you are!</p>
  </body>
</html>

決済ページで「戻る」ボタンをクリックすると、顧客はこのページにリダイレクトされます。

サーバーを設定する
サーバー側

Stripe は Checkout セッションを使用して、顧客が決済フォームにリダイレクトされた際に表示される内容を表示します。Checkout セッションは、請求する項目や受け付ける通貨などのオプションを使用して設定できます。

Checkout セッションを作成する

作成した価格の 1 つを項目として使用して、Checkout Session を作成します。mode を サブスクリプション に設定し、success_url を成功ページの URL に設定します。Managed Payments を有効にするには、managed_payments[enabled] を true に設定し、バージョンヘッダーに ;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://localhost:4242/success"

エンドポイントを作成する

Checkout セッションを作成するエンドポイントをサーバーに追加します。エンドポイントパスは、決済ボタンの action 属性と一致する必要があります。

Checkout セッションを作成したら、レスポンスで返された URL に顧客をリダイレクトします。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# This example sets up an endpoint using the Sinatra framework.

require 'json'
require 'sinatra'
require 'stripe'

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

Stripe.api_version = '2026-01-28.clover; managed_payments_preview=v1;'

post '/create-checkout-session' do
  session = Stripe::Checkout::Session.create({
    line_items: [{
      price: '{{PRICE_ID}}',
      quantity: 1
    }],
    mode: 'subscription',
    managed_payments: {enabled: true},
    success_url: 'http://localhost:4242/success'
  })

  redirect session.url, 303
end

エンドポイントをテストする

ウェブサーバー (localhost:4242 など) を起動し、次のコマンドを実行して、エンドポイントがアクセス可能であることを確認します。

Command Line
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""

端末に次のようなレスポンスが表示されます。

Command Line
HTTP/1.1 303 See Other
Location: https://checkout.stripe.com/c/pay/cs_test_...
...

支払い後のイベントを処理する

顧客が Checkout セッションの支払いを完了すると、Stripe は checkout.session.completed イベントを送信します。ダッシュボードの Webhook ツールを使用するか、Webhook ガイドに従ってこれらのイベントを受信して処理します。

顧客が成功ページにリダイレクトされるのを待たずに、これらのイベントをリッスンします。成功ページを、決済後にアクションを起動するためだけに、使用することは避けてください。

非同期型のイベントをリッスンするようシステムを設定すると、1 回の実装で異なるタイプの決済手段を正しく処理できるようになります。詳細については、Checkout の注文のフルフィルメントを履行するをご覧ください。

Checkout で支払いを回収する際には、以下のイベントを処理します。

イベント説明
checkout.session.completed顧客が Checkout セッションを正常に完了すると送信されます。
checkout.session.async_payment_succeededACH Direct Debt など、遅延型の決済手段による支払いが成功した場合に送信されます。
checkout.session.async_payment_failedACH Direct Debt など、遅延型の決済手段による支払いが失敗した場合に送信されます。

テスト

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

決済

  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 は設定された価格に課税します。

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

参照情報