コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

Connect で決済フォームへのリンクを作成

Connect では、連結アカウントに対して決済フォームへのリンクを作成し、必要に応じてその処理の手数料を受け取ることができます。

連結アカウントの決済フォームへリンクを作成すると、支払いを回収するための複数の手段をサポートできます。決済フォームへのリンクは、ダイレクト支払いを使用して連結アカウントに直接作成するができます。また、別の方法として、デスティネーション支払いを使用して連結アカウントへ送金する際にプラットフォームで作成することもできます。こうした決済フォームへのリンクには、プラットフォーム手数料を設定することも可能です。

ダイレクト支払いを使用して決済フォームへのリンクを作成する

連結アカウントに直接請求する決済フォームへのリンクを作成するには、連結アカウントとして認証を受けたときに決済フォームへのリンクを作成します。これを機能させるには、連結アカウントで商品と価格も作成する必要があります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1

ダイレクト支払いを使用する場合、連結アカウントが Stripe 手数料、返金、チャージバックのコストを負担します。

デスティネーション支払いを使用して決済フォームへのリンクを作成する

プラットフォームで支払いを実行し、連結アカウントへの自動送金を作成する決済フォームへのリンクを作成するには、transfer_data[destination] 値として連結アカウント ID を指定して、決済フォームへのリンクを作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

これが機能するためには、プラットフォームアカウントで商品と価格も作成する必要があります。自動送金を使用するとき、プラットフォームは記録対象のビジネスです。

デスティネーション支払いを実行する場合、Payment Links ではプラットフォームアカウントのブランド設定を決済ページに使用します。詳細については、ブランディングをカスタマイズするのセクションをご覧ください。

デスティネーション支払いと on_behalf_of を使用して決済フォームへのリンクを作成する

on_behalf_of パラメーターを連結アカウント ID (デフォルトではプラットフォーム) に設定して、デスティネーション支払いを作成することもできます。on_behalf_of パラメーターは、売上処理加盟店を決定します。これは次の項目に影響します。

  • エンドユーザーに表示される明細書表記
  • エンドユーザーに表示される住所と電話番号
  • 支払いの売上処理通貨
  • 顧客に表示される決済ページのブランディング
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

決済フォームへのリンクで発注された注文のフルフィルメントを実行する

エンドユーザーが決済フォームへのリンクを使用して支払いを完了した後、連結アカウントを有効化して、必要なすべてのフルフィルメントを処理する必要があります。

ダッシュボードで Webhook エンドポイントを構成します。

Stripe ダッシュボードの Webhook ページ

次に、お客様のサーバー上に HTTP エンドポイントを作成し、完了した支払いを監視します。サンプルのエンドポイントシークレットキー (whsec_...) は、必ず各自のキーに置き換えてください。

server.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Using Sinatra.
require 'sinatra'
require 'stripe'

set :port, 4242

# 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'


# 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

詳細については、フルフィルメントガイドをご覧ください。

オプションプラットフォーム手数料を回収する

決済フォームへのリンクで行われたすべての支払いのプラットフォーム手数料をオプションで回収できます。1 回限りの価格が設定されたラインアイテムのみが含まれる決済フォームへのリンクでは、application_fee_amount を定義できます。

決済用リンクに継続価格が含まれている場合、代わりに application_fee_percent を定義できます。これは、小数点以下が最大 2 桁の 0 から 100 の間の負ではない 10 進数である必要があります。サブスクリプションに対して請求される金額は変動することがあるため、サブスクリプションのプラットフォーム手数料はパーセントにする必要があります。サブスクリプションのプラットフォーム手数料として定額を設定することはできません。

次の例は、連結アカウントへのダイレクト支払いの決済フォームへのリンクに対する application_fee_amount を示しています。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d application_fee_amount=10

次の例は、デスティネーション支払いを使用する決済フォームへのリンクの application_fee_amount を示しています。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d application_fee_amount=10 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

オプションブランディングをカスタマイズする

プラットフォームおよび Stripe ダッシュボードの全機能へのアクセス権がある連結アカウントは、ブランディング設定を使用して、支払いページのブランディングをカスタマイズできます。on_behalf_of を指定したデスティネーション支払いとダイレクト支払いの場合、決済用の URL リンクでは連結アカウントのブランディング設定が使用されます。on_behalf_of を指定しないデスティネーション支払いの場合、決済用の URL リンクではプラットフォームアカウントのブランディング設定が使用されます。

プラットフォームは、Account (アカウント) 更新 API エンドポイントを呼び出すことで、Stripe ダッシュボードの全機能へのアクセス権がない連結アカウントのブランディング設定を行うことができます。

Account Update API は、ブランディングに関する次のパラメーターを受け取ります。

  • icon - Checkout ページのヘッダーにあるビジネス名の横に表示されます。
  • logo- 指定した場合、Checkout ページのヘッダーに、アイコンとビジネス名の代わりに表示されます。
  • primary_color - Checkout ページの背景色として使用されます。
  • secondary_color - Checkout ページのボタンの色として使用されます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts/{{CONNECTED_STRIPE_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

オプション税金の計算と徴収を導入する

まず、どの法人に納税義務があるかを判断する必要があります。ビジネスモデルによって、連結アカウントまたはプラットフォームが納税義務を負う法人となります。詳細については、Connect で Stripe Tax を使用するをご覧ください。

このページはお役に立ちましたか。
はいいいえ