# Managed Payments で決済用リンクを使用する デジタル製品をグローバルに販売し、Stripe が間接税務コンプライアンス、不正利用対策、不審請求の申し立て管理、顧客取引サポートを代行します。 Managed Payments を有効にして[決済用リンク](https://docs.stripe.com/payment-links.md)を作成すれば、デジタル商品の決済を即座に回収できます。決済用リンクは、コードを記述せずに[ダッシュボード](https://dashboard.stripe.com/payment-links)で、または [Payment Links API](https://docs.stripe.com/api/payment-link.md) を使用して作成できます。[Managed Payments の仕組み](https://docs.stripe.com/payments/managed-payments/how-it-works.md)について詳しく見る。 ## Before you begin - 商品が Managed Payments の[利用資格要件](https://docs.stripe.com/payments/managed-payments/eligibility.md#product-eligibility)を満たしていることを確認します。顧客が購入を希望するすべての商品が利用資格を満たしている場合にのみ、Managed Payments を有効にした決済用リンクを作成できます。 - [ダッシュボード](https://dashboard.stripe.com/settings/managed-payments)で Managed Payments を有効にします。 ## 決済用リンクを作成 #### ダッシュボード 1. ダッシュボードの [Payment Links](https://dashboard.stripe.com/payment-links) ページで、**新規** をクリックします (またはプラス記号 (**+**) をクリックして、**決済用リンク** を選択します)。 1. 既存の商品を選択するか、新しい商品を追加するか、顧客が支払う金額を選択できるようにします。 1. 選択した商品に、Managed Payments の対象となる商品カテゴリーがあることを確認してください。 1. **Enable Managed Payments (Managed Payments を有効にする)** が選択されていることを確認します。 1. **リンクを作成**をクリックします。 > Stripe iOS アプリで Managed Payments を有効にした決済用リンクの作成はサポートされていません。代わりにウェブ版のダッシュボードを使用してください。 #### API [Payment Links API](https://docs.stripe.com/api/payment-link.md) で Managed Payments を使用するには、API バージョン `2025-03-31.basil` [以降](https://docs.stripe.com/changelog.md)を使用する必要があります。 #### 商品またはサブスクリプション ### 商品を作成する **商品と価格** を使用して、1 回限りの商品またはサブスクリプションを販売できます。そのためには、商品を作成してから価格を設定します。[Managed Payments の対象](https://docs.stripe.com/payments/managed-payments/eligibility.md#eligible-tax-codes)となる税コードを含める必要があります。 ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ --data-urlencode "name=Hamlet (e-book)" \ -d "description=A Shakespearean tragedy" \ -d tax_code={{TAX_CODE}} \ -d "default_price_data[unit_amount]=1000" \ -d "default_price_data[currency]=usd" ``` ### 決済用リンクを作成する Managed Payments を有効にして決済用リンクを作成するには、`managed_payments[enabled]` パラメーターを [Payment Links API](https://docs.stripe.com/api/payment-link.md) エンドポイントに [line_items](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items) とともに渡します。各明細項目には [price](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-price) と [quantity](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-quantity) が含まれます。定額料金の場合は、最大 20 個の明細項目を追加できます。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "managed_payments[enabled]=true" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" ``` 決済用リンクの作成時に [price_data](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items-price_data) を使用して商品と価格を作成できます。 決済用リンクを使用してサブスクリプションを作成するには、[type=recurring](https://docs.stripe.com/api/prices/object.md#price_object-type) を `line_items` に指定して価格を設定します。[subscription_data](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-subscription_data) を使用して、トライアルを含む、決済用リンクから作成されるサブスクリプションの設定を指定します。 #### 顧客が価格を選択する ### 変動価格を作成する [変動料金](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#variable-pricing)を設定して、顧客が商品の支払金額を選択できるようにします。商品は、[Managed Payments の対象](https://docs.stripe.com/payments/managed-payments/eligibility.md#product-eligibility)となるデジタル商品である必要があります。 ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d currency=usd \ -d "custom_unit_amount[enabled]=true" \ -d "product={{PRODUCT_ID}}" ``` ### 決済用リンクを作成 `managed_payments[enabled`] パラメーターを [Payment Links API](https://docs.stripe.com/api/payment-link.md) エンドポイントに [line_items](https://docs.stripe.com/api/payment_links/payment_links/create.md#create_payment_link-line_items) とともに渡して、決済用リンクを作成します。顧客定義の価格には 1 つの項目を含めることができます。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "managed_payments[enabled]=true" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" ``` ### 決済用リンクを共有する 各決済用リンクには、メール、ソーシャルメディア、ウェブサイトのリンク、アプリ、その他のチャネルを通じて顧客と共有できる URL が含まれます。 ## 既存の Payment Links API 連携を更新して、Managed Payments を使用する 上記の手順に従って、Managed Payments を有効にした新しい決済リンクを作成します。 ### サポート対象外のパラメーターを削除 マーチャントオブレコードとして機能するために、Stripe は決済セッションの一部を制御します。その結果、Managed Payments の使用時には一部のパラメーターが利用できないため、Managed Payments を有効にして payment links を作成する場合は、それらを削除する必要があります。 | カテゴリー | パラメーター | 理由 | | ------------------------------------------------------------ | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 税金 | `automatic_tax` | Managed Payments は税金の計算と源泉徴収を処理します。 | | `tax_id_collection` | | 決済手段 | `payment_method_types` | Managed Payments は、[動的決済手段](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)を使用して決済用リンクで利用可能な決済手段を制御し、顧客に最も関連性の高い決済手段を表示します。Managed Payments の決済手段の設定方法については、[決済手段の設定](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments)を参照してください。 | | 配送 | `shipping_address_collection` | Managed Payments はデジタル商品のみに対応しているため、配送情報が収集されることはありません。 | | `shipping_options` | | Connect | `application_fee_amount` | Managed Payments は Connect の実装には対応していません。 | | `application_fee_percent` | | `on_behalf_of` | | `transfer_data` | | `payment_intent_data.transfer_group` | | 販売後 | `subscription_data.invoice_settings` | Managed Payments は、請求や確認メールなど、販売後のアクションを処理します。 | | `invoice_creation` | | 明細書表記 | `payment_intent_data.statement_descriptor` | Managed Payments は、ビジネスに代わって明細書表記を管理します。 | | `payment_intent_data.statement_descriptor_suffix` | | `consent_collection.payment_method_reuse_agreement.position` | | 送信ボタンのオプション (制限あり) | `submit_type='donate'` | Managed Payments は、寄付やサービスの販売をサポートしていません。残りの [submit_type](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-submit_type) オプションはサポートされています。 | | `submit_type='book'` | | カスタマイズ | `custom_text` | Managed Payments は、カスタムテキストをサポートしない標準化された決済画面を提供します。 | ## 決済用リンクの編集 決済用リンクの作成後は、そのリンクの Managed Payments の状態を変更できません。 - 既存の決済用リンクで Managed Payments を有効にすることはできません。Managed Payments を使用するには、新しい決済用リンクを作成する必要があります。 - Managed Payments を有効にして決済用リンクを作成した後は、そのリンクで Managed Payments を無効にすることはできません。代わりに、Managed Payments を有効にせずに新しい決済用リンクを作成する必要があります。 ## テスト 実装が顧客に対して正しく機能するかをテストします。 ### 決済 1. 決済用リンクの URL に移動して決済画面を読み込みます。 1. 決済ページで、異なる請求先住所を入力して、Managed Payments でさまざまな場所の顧客の税金がどのように計算されるかを確認します。 1. 決済を処理するには、任意のCVCと将来の日付の有効期限を指定して、テスト用カード番号 `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 は、[価格で指定された tax behavior](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price) を使用します。価格の tax behavior を指定しない場合、Managed Payments はデフォルトで、設定した価格に税金を上乗せします。 デフォルトを変更するには、ダッシュボードの [Tax settings](https://dashboard.stripe.com/settings/tax) ページに移動し、**価格に税金を含める**設定を更新します。