# Connect で決済フォームへのリンクを作成 Connect では、連結アカウントに対して決済フォームへのリンクを作成し、必要に応じてその処理の手数料を受け取ることができます。 *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) については、[概要](https://docs.stripe.com/connect.md)記事をご覧ください。 連結アカウントへの支払い用の決済用リンクを作成できます。決済用リンクは [すべての決済タイプ](https://docs.stripe.com/connect/charges.md) をサポートし、プラットフォームがプラットフォーム手数料を徴収できます。 ## ダイレクト支払いを使用して決済フォームへのリンクを作成する #### ダッシュボード 1. ダッシュボードで、[Payment Links](https://dashboard.stripe.com/payment-links/create/standard-pricing) ページを開き、**+新規** をクリックします。 1. **決済ページ**タブで、既存の商品を選択するか、**+ 新しい商品を追加**をクリックします。 1. **決済ページ**タブで、**オプション**と**詳細オプション**を使用して決済用リンクをカスタマイズします。 1. **決済後**タブで、**連結アカウントと決済を分割**を選択します。次に、連結アカウントを選択し、プラットフォーム手数料の金額を入力します。1 回限りの決済の場合、手数料は固定金額です。継続課金の場合、手数料は割合です。 1. **リンクを作成**をクリックします。 顧客がこの決済用リンクを通じて商品を購入すると、連結アカウントは支払いから [プラットフォーム手数料](https://docs.stripe.com/connect/payment-links.md#collecting-fees) を差し引いた金額を受け取り、プラットフォーム手数料はプラットフォーム残高に入金されます。 #### Payment Links API ダイレクト支払いを使用する決済用リンクを作成するには、まず連結アカウントとして [認証](https://docs.stripe.com/connect/authentication.md#stripe-account-header) された状態で [商品](https://docs.stripe.com/api.md#create_product) と [価格](https://docs.stripe.com/api.md#create_price) を作成する必要があります。次に、連結アカウントとしても認証された状態で [決済用リンクを作成](https://docs.stripe.com/api.md#create_payment_link) します。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" ``` ダイレクト支払いを使用する場合、連結アカウントが Stripe 手数料、返金、チャージバックのコストを負担します。 ## デスティネーション支払いを使用して決済フォームへのリンクを作成する #### ダッシュボード 1. ダッシュボードで、[Payment Links](https://dashboard.stripe.com/payment-links/create/standard-pricing) ページを開き、**+新規** をクリックします。 1. **決済ページ**タブで、既存の商品を選択するか、**+ 新しい商品を追加**をクリックします。 1. **決済ページ**タブで、**オプション**と**詳細オプション**を使用して決済用リンクをカスタマイズします。 1. **決済後**タブで、**連結アカウントと決済を分割**を選択します。次に、連結アカウントを選択し、プラットフォーム手数料の金額を入力します。1 回限りの決済の場合、手数料は固定額です。継続課金の場合、手数料は割合です。プラットフォームが負担する Stripe 手数料をカバーできる十分な金額にする必要があります。**選択したアカウントに代わって決済を行う**のチェックを外したままにしてください。 1. **リンクを作成**をクリックします。 顧客がこの決済用リンクを通じて商品を購入すると、プラットフォームが決済を受け取ります。資金は連結アカウントに自動的に送金され、[プラットフォーム手数料](https://docs.stripe.com/connect/payment-links.md#collecting-fees) はプラットフォーム残高に残ります。 #### Payment Links API プラットフォームで決済を行い、連結アカウントへの自動送金を作成する決済用リンクを作成するには、最初にプラットフォームアカウントで [商品](https://docs.stripe.com/api.md#create_product) と [価格](https://docs.stripe.com/api.md#create_price) を作成する必要があります。次に、連結アカウント ID を `transfer_data[destination]` [値](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-transfer_data) として指定しながら、[決済用リンクを作成](https://docs.stripe.com/api.md#create_payment_link)します。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` 自動送金を使用する場合、プラットフォームは*マーチャントオブレコード* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account)です。 決済用リンクを使用してデスティネーション支払いを作成する場合、決済ページではプラットフォームのブランド設定が使用されます。詳細については、[ブランディングのカスタマイズ](https://docs.stripe.com/connect/payment-links.md#customize-branding) のセクションをご覧ください。 ## デスティネーション支払いと on_behalf_of を使用して決済フォームへのリンクを作成する #### ダッシュボード 1. ダッシュボードで、[Payment Links](https://dashboard.stripe.com/payment-links/create/standard-pricing) ページを開き、**+新規** をクリックします。 1. **決済ページ**タブで、既存の商品を選択するか、**+ 新しい商品を追加**をクリックします。 1. **決済ページ**タブで、**オプション**と**詳細オプション**を使用して決済用リンクをカスタマイズします。 1. **決済後**タブで、**連結アカウントと決済を分割**を選択し、適切な連結アカウントを選択します。 1. **ビジネスで保持すべき金額**で、プラットフォーム手数料の金額を入力します。1 回限りの決済の場合、手数料は固定金額です。継続課金の場合、手数料は割合です。 1. **選択したアカウントに代わって決済を行う**を選択して、連結アカウントを [売上処理加盟店](https://docs.stripe.com/connect/destination-charges.md#settlement-merchant) として指定します。 1. **リンクを作成**をクリックします。 #### Payment Links API 連結アカウント ID に `on_behalf_of` パラメーターを設定することで、連結アカウントを売上処理加盟店としてデスティネーション支払いを作成することもできます。売上処理加盟店は以下に影響します。 - エンドユーザーに表示される明細書表記 - エンドユーザーに表示される住所と電話番号 - 支払いの売上処理通貨 - 顧客に表示される決済ページのブランディング ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "on_behalf_of={{CONNECTEDACCOUNT_ID}}" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## 支払いと送金別方式による決済を作成する 資金を連結アカウントに送金することを明示的に制御する場合は、たとえば、1 回の決済の資金を複数の連結アカウント間で分割する場合、支払いと送金別方式を使用して決済用リンクを作成できます。これらの決済は、資金を連結アカウントに自動的に送金しません。 #### ダッシュボード 1. ダッシュボードで、[Payment Links](https://dashboard.stripe.com/payment-links/create/standard-pricing) ページを開き、**+新規** をクリックします。 1. **決済ページ**タブで、既存の商品を選択するか、**+ 新しい商品を追加**をクリックします。 1. **決済ページ**タブで、**オプション**と**詳細オプション**を使用して決済用リンクをカスタマイズします。 1. **決済後**タブで、**連結アカウントと決済を分割**を選択解除したままにします。 1. **リンクを作成**をクリックします。 1. 連結アカウントへの入金の準備ができたら、連結アカウントの詳細ページの**残高**セクションに移動して、**資金送金**をクリックします。 1. 連結アカウントに送金する金額を入力します。[プラットフォーム手数料](https://docs.stripe.com/connect/payment-links.md#collecting-fees) を請求するには、送金する金額を手数料の金額だけ減らします。 #### Payment Links API API を使用して、支払いと送金別方式を使用する決済用リンクを作成することはできません。 ## 決済フォームへのリンクで発注された注文のフルフィルメントを実行する エンドユーザーが決済フォームへのリンクを使用して支払いを完了した後、連結アカウントを有効化して、必要なすべての*フルフィルメント* (Fulfillment is the process of providing the goods or services purchased by a customer, typically after payment is collected)を処理する必要があります。 [ダッシュボード](https://dashboard.stripe.com/account/webhooks)で *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) エンドポイントを構成します。 ![Stripe ダッシュボードの Webhook ページ](https://b.stripecdn.com/docs-statics-srv/assets/account_webhooks.03b71cec87ef2093fe0caa92e5bfce44.png) 次に、お客様のサーバー上に HTTP エンドポイントを作成し、完了した支払いを監視します。サンプルのエンドポイントシークレットキー (`whsec_...`) は、必ず各自のキーに置き換えてください。 #### Ruby ```ruby # Using Sinatra. require 'sinatra' require 'stripe' set :port, 4242 # Don't put any keys in code. See https://docs.stripe.com/keys-best-practices. # Find your keys at https://dashboard.stripe.com/apikeys. client = Stripe::StripeClient.new('<>') # If you are testing your webhook locally with the Stripe CLI you # can find the endpoint's secret by running `stripe listen` # Otherwise, find your endpoint's secret in your webhook settings in # the Developer Dashboard endpoint_secret = 'whsec_...' post '/webhook' do payload = request.body.read sig_header = request.env['HTTP_STRIPE_SIGNATURE'] event = nil # Verify webhook signature and extract the event. # See https://stripe.com/docs/webhooks#verify-events for more information. begin event = Stripe::Webhook.construct_event( payload, sig_header, endpoint_secret ) rescue JSON::ParserError => e # Invalid payload. status 400 return rescue Stripe::SignatureVerificationError => e # Invalid Signature. status 400 return end if event['type'] == 'checkout.session.completed' session = event['data']['object'] connected_account_id = event['account'] handle_completed_checkout_session(connected_account_id, session) end status 200 end def handle_completed_checkout_session(connected_account_id, session) # Fulfill the purchase puts 'Connected account ID: ' + connected_account_id puts session.to_s end ``` 詳細については、[フルフィルメントガイド](https://docs.stripe.com/checkout/fulfillment.md)をご覧ください。 ## Optional: プラットフォーム手数料を回収する 決済用リンクを使用して行われる決済ごとにプラットフォーム手数料を任意で徴収できます。 #### ダッシュボード 1 回限りの決済の場合、手数料は、同じ決済用リンクを通じて行われる決済ごとに定額です。数量、割引、税金によって変わることはありません。 継続課金の場合、手数料は、同じ決済用リンクを通じて行われた各支払いの取引総額に対する一定の割合です。 プラットフォーム手数料は、プラットフォームが負担する Stripe 手数料をカバーできる十分な金額にする必要があります。 1. **決済後**タブで、**連結アカウント決済を分割**を選択します。 1. **ビジネスで保持すべき金額** にプラットフォーム手数料の金額または割合を入力します。 1. 決済を連結アカウントと分割するように決済用リンクを設定したら、**+ リンクを作成**をクリックして URL を生成します。 顧客が決済用リンクを使用して決済した後、資金フローは決済方式によって異なります。 - **ダイレクト支払い:** Stripe は連結アカウントの残高に全額を加算し、そこから Stripe 手数料を差し引きます。その後、Stripe は連結アカウントの残高からプラットフォーム手数料の金額をプラットフォームアカウントの残高に送金します。 - **間接決済:** Stripe はプラットフォームアカウントの残高に全額を加算し、そこから Stripe 手数料を差し引きます。その後、Stripe はプラットフォーム残高からプラットフォーム手数料を差し引いた金額を連結アカウントの残高に送金します。 #### Payment Links API 1 回限りの価格の項目のみを含む決済用リンクでは、[application_fee_amount](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-application_fee_amount) を定義できます。1 回限りの決済のプラットフォーム手数料として割合を設定することはできません。 決済用リンクに継続価格が含まれている場合、代わりに [application_fee_percent](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-application_fee_percent) を定義できます。これは、小数点以下が最大 2 桁の 0 から 100 の間の負ではない 10 進数である必要があります。サブスクリプションに対して請求される金額は変動することがあるため、サブスクリプションのプラットフォーム手数料はパーセントにする必要があります。サブスクリプションのプラットフォーム手数料として定額を設定することはできません。 次の例は、連結アカウントへのダイレクト支払いの決済用リンクでの [application_fee_amount](https://docs.stripe.com/api/payment-link/object.md#payment_link_object-application_fee_amount) を示しています。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d application_fee_amount=10 ``` 次の例は、デスティネーション支払いを使用する決済フォームへのリンクの `application_fee_amount` を示しています。 ```curl curl https://api.stripe.com/v1/payment_links \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d application_fee_amount=10 \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ## Optional: ブランディングをカスタマイズする プラットフォームおよび *Stripe ダッシュボードの全機能へのアクセス権* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API)がある連結アカウントは、[ブランディング設定](https://dashboard.stripe.com/account/branding)を使用して、支払いページのブランディングをカスタマイズできます。`on_behalf_of` を指定したデスティネーション支払いとダイレクト支払いの場合、決済用の URL リンクでは連結アカウントのブランディング設定が使用されます。`on_behalf_of` を指定しないデスティネーション支払いの場合、決済用の URL リンクではプラットフォームアカウントのブランディング設定が使用されます。 プラットフォームは、Stripe ダッシュボードの全機能にアクセスできない連結アカウントのブランディング設定を、`Account` の[ブランディングプロパティを更新](https://docs.stripe.com/api/accounts/update/api/accounts/update.md?api-version=2025-11-17.preview#update_account-settings-branding#update_account-settings-branding)することで構成できます。 - `icon` - Checkout ページのヘッダーにあるビジネス名の横に表示されます。 - `logo`- 指定した場合、Checkout ページのヘッダーに、アイコンとビジネス名の代わりに表示されます。 - `primary_color` - Checkout ページの背景色として使用されます。 - `secondary_color` - Checkout ページのボタンの色として使用されます。 ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \ -u "<>:" \ -d "settings[branding][icon]=file_123" \ -d "settings[branding][logo]=file_456" \ --data-urlencode "settings[branding][primary_color]=#663399" \ --data-urlencode "settings[branding][secondary_color]=#4BB543" ``` ## Optional: 税金の計算と徴収を導入する まず、どの法人に納税義務があるかを判断する必要があります。ビジネスモデルによって、連結アカウントまたはプラットフォームが納税義務を負う法人となります。詳細については、[Connect で Stripe Tax を使用する](https://docs.stripe.com/tax/connect.md)をご覧ください。