Connect を使用して請求書を作成する

You can create invoices for connected accounts that use direct charges or destination charges. You can also take an application fee on these invoices.

ダイレクト支払いを使用して請求書を作成する

To create an invoice that directly charges on a connected account, create an invoice while authenticated as the connected account. For this to work, the customer must be defined on the connected account.

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

As with creating a direct charge on a connected account, you can create a customer on a connected account by using either the platform’s publishable key or the connected account’s publishable key. You can also create a token by using shared customers. When you use direct charges, the connected account is responsible for the cost of the Stripe fees, refunds, and chargebacks.

デスティネーション支払いを使用して請求書を作成する

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

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}"

For this to work, the customer must be defined on the platform account, and you must create the connected account token by using the platform’s publishable key. When using automatic transfers, the platform is the business of record.

連結アカウントの納税者番号とビジネスの詳細を請求書に表示する

一部の地域では、規制要件により、顧客向け文書に納税者番号やその他の事業情報を表示することが、加盟店に義務付けられています。

場合によっては、プラットフォームに関する情報の代わりに、連結アカウントに関する情報を表示することで、これらの要件を満たすことができます。次の手順は、連結アカウントの納税者番号とビジネスの詳細を、請求書メール、請求書 PDF、オンライン請求書ページ、領収書に表示する方法を表したものです。

1. 連結アカウントの納税者番号を作成します。
2. 連結アカウントのデフォルトの納税者番号を設定します。
3. 既存または新規の請求書、サブスクリプション、サブスクリプションスケジュールで on_behalf_of パラメーターを使用するか、issuer として連結アカウントを指定します。

連結アカウントの納税者番号を作成

次の例のように、連結アカウントに対して 1 つの納税者番号を作成します。Stripe は納税者番号を連結アカウントに保存します。追加の納税者番号を作成するには、エンドポイントをもう一度呼び出します。

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=eu_vat \
  -d value=DE123456789

連結アカウントのデフォルトの納税者番号を設定

請求書に account_tax_ids がすでに設定されていない限り、Stripe では請求書 issuer のアカウントからデフォルトの納税者番号を自動的に取得します。

連結アカウントに保存されている納税者番号を、そのアカウントのデフォルトの納税者番号として設定できます。次の例では、既存の納税者番号をデフォルトの納税者番号として設定しています。

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[invoices][default_account_tax_ids][0]"=atxi_123 \
  -d "settings[invoices][default_account_tax_ids][1]"=atxi_456

既存または新規のインボイス、サブスクリプション、サブスクリプションスケジュールの発行者を連結アカウントとして設定

次の例では既存のサブスクリプションで issuer を設定します。インボイスの最終処理で、サブスクリプションのインボイスは発行者のデフォルトの納税者番号を取り込みます。

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
"{{CONNECTED_ACCOUNT_ID}}"

次の例では請求書の作成時に issuer を設定します。

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}"

または、on_behalf_of パラメーターを使用すると、連結アカウントの詳細が請求書メール、請求書 PDF、オンライン請求書ページ、および領収書にも印刷されます。

既存または新規の請求書、サブスクリプション、サブスクリプションスケジュールにアカウントの納税者番号を設定する

請求書、サブスクリプション、サブスクリプションスケジュールに account_tax_ids を指定して、デフォルトの納税者番号を上書きできます。次の例では既存のサブスクリプションで account_tax_ids を設定します。

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "invoice_settings[account_tax_ids][0]"=txi_123 \
  -d "invoice_settings[account_tax_ids][1]"=txi_456

次の例では請求書の作成時に account_tax_ids を設定します。

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "account_tax_ids[0]"=txi_123 \
  -d "account_tax_ids[1]"=txi_456

連結アカウントのプラットフォームに保存された納税者番号を作成する

作成した納税者番号は、連結アカウントではなくプラットフォームアカウントに保存されます。次の例のように、Stripe-Account ヘッダーを使用せずに、連結アカウントに対して 1 つの納税者番号を作成します。

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=eu_vat \
  -d value=DE123456789 \
  -d "owner[type]"=account \
  -d "owner[account]"=
"{{CONNECTED_ACCOUNT_ID}}"

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

請求書では、必要に応じてプラットフォーム手数料を差し引くことができます。以下の例は、連結アカウントへのダイレクト支払いの請求書に対する application_fee_amount を示しています。

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

次の例は、デスティネーション支払いを使用する請求書の application_fee_amount を示しています。

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}"

請求書決済手段の設定

連結アカウントで使用できる請求書決済手段を管理します。決済手段のデフォルトリストを有効にするには、以下のようにします。

1. 設定> 請求> 請求書に移動します。
2. デフォルトの決済手段セクションで、連結アカウントの決済手段設定ドロップダウンをクリックします。
3. デフォルトを選択して、Stripe が決済手段のデフォルト設定を提供できるようにします。

デフォルト設定を有効にした後も、連結アカウントは個別の決済手段を有効または無効にすることができます。また、決済手段設定 API を使用して、連結アカウントの個別の決済手段を管理することもできます。

導入で動的な決済手段を使用している場合は、独自の決済手段設定を作成できます。詳細については、Connect アカウントの複数の設定をご覧ください。カスタム決済手段設定を作成すると、連結アカウントの決済手段設定ドロップダウンにオプションとして表示されます。

連結アカウントを売上処理加盟店にする

To make the connected account the settlement merchant, charge the customer using the on_behalf_of parameter when you create or update the invoice. You must set on_behalf_of in the API before finalizing an invoice—the Dashboard doesn’t have an interface for invoices you send on behalf of connected accounts.

on_behalf_of パラメーターを設定すると、連結アカウントのブランディング、連絡先情報、アカウントの納税者番号が、請求書メール、請求書 PDF、オンライン請求書ページ、領収書に適用されます。ただし、サンドボックスで on_behalf_of を使用すると、API で送信する標準の請求書と同様に、メールの送信は行われません。サンドボックスでのテスト中に、ダッシュボードの請求書ページを確認することで、Stripe が請求書を作成したかどうかを確認できます。

連結アカウントの代わりに支払いを回収するには、連結アカウントで該当する決済手段のアカウントケイパビリティも有効になっている必要があります。デスティネーション支払いを使用すると、連結アカウントの代理で作成されたインボイスの支払いを自動的に送金できます。on_behalf_of​ パラメーターの詳細については、関連する Connect のドキュメントをご覧ください。

• 連結アカウントへの自動送金については、支払いの作成ガイドの on_behalf_of パラメーターの詳細をご覧ください。
• 支払いを手動で送金する方法については、送金利用の可否をご覧ください。
• 連結アカウントに代わって支払いを回収するために必要なアカウントのケイパビリティのリストについては、決済手段のケイパビリティをご覧ください。

以下の例は、支払いと送金別方式を使用して、新しい請求書に on_behalf_of パラメーターを使用する方法を示しています。

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}"

As with standard destination charges, you can set an application_fee_amount on invoices. This example shows how to use on_behalf_of with a destination charge and application fee.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d application_fee_amount=10 \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}"

Invoices created on behalf of a connected account don’t support bank transfers payment methods, such as ACH Credit Transfer and paper checks.

税金の計算と徴収を導入する

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

参照情報

• 支払いを作成する
• アカウント間で顧客を共有する
• 複数の通貨