# 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) の詳細については、Stripe の[概要](https://docs.stripe.com/connect.md)記事をご確認ください。 [ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)または[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)を使用する連結アカウントの*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)を作成できます。これらの請求書にプラットフォーム手数料を課すこともできます。 > 定期支払いの取引は、[Invoicing の料金体系](https://stripe.com/invoicing/pricing)に基づきます。 ## ダイレクト支払いを使用して請求書を作成する 連結アカウントに直接請求する請求書を作成するには、連結アカウントとして[認証](https://docs.stripe.com/connect/authentication.md#stripe-account-header)されているときに[請求書を作成](https://docs.stripe.com/api.md#create_invoice)します。これを機能させるには、連結アカウントで顧客が定義されている必要があります #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" ``` 連結アカウントでの[ダイレクト支払いの作成](https://docs.stripe.com/connect/direct-charges.md#collect-fees)と同様、プラットフォームの公開可能キーまたは連結アカウントの公開可能キーを使用して、連結アカウントに顧客を作成できます。[共有顧客](https://docs.stripe.com/connect/cloning-customers-across-accounts.md)を使用してトークンを作成することもできます。ダイレクト支払いを使用するときは、連結アカウントが Stripe 手数料、返金、およびチャージバックのコストに関する責任を負います。 ## デスティネーション支払いを使用して請求書を作成する プラットフォームで支払いを実行し、連結されたアカウントへの自動送金を作成する請求書を作成するには、`transfer_data[destination]` [値](https://docs.stripe.com/api/invoices/object.md#invoice_object-transfer_data)として連結されたアカウント ID を指定して、[請求書を作成](https://docs.stripe.com/api.md#create_invoice)します。 #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" ``` これが機能するためには、プラットフォームアカウントで顧客が定義され、かつプラットフォームの公開可能キーを使用して、連結アカウントのトークンが作成されている必要があります。顧客に請求する場合は、その顧客がプラットフォームアカウント内に存在する必要があります。自動送金を使用する場合、プラットフォームが記録上の事業者になります。 ## 連結アカウントの納税者番号とビジネスの詳細を請求書に表示する 一部の地域では、事業者が顧客向けの書類に納税者 ID やその他の事業の詳細を表示する場合に規制要件を設けています。 場合によっては、プラットフォームに関する情報の代わりに、連結アカウントに関する情報を表示することで、これらの要件を満たすことができます。次の手順は、連結アカウントの納税者番号とビジネスの詳細を、請求書メール、請求書 PDF、オンライン請求書ページ、領収書に表示する方法を表したものです。 1. 連結アカウントの納税者番号を作成します。 1. 連結アカウントのデフォルトの納税者番号を設定します。 1. 既存または新規の請求書、サブスクリプション、サブスクリプションスケジュールで [`on_behalf_of` パラメーター](https://docs.stripe.com/invoicing/connect.md#on-behalf-of)を使用するか、`issuer` として連結アカウントを指定します。 ### 連結アカウントの納税者番号を作成 次の例のように、連結アカウントに対して 1 つの納税者番号を作成します。Stripe は納税者番号を連結アカウントに保存します。追加の納税者番号を作成するには、エンドポイントをもう一度呼び出します。 ```curl curl https://api.stripe.com/v1/tax_ids \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=eu_vat \ -d value=DE123456789 ``` ### 連結アカウントのデフォルトの納税者番号を設定 請求書に `account_tax_ids` がすでに設定されていない限り、Stripe では請求書 `issuer` のアカウントからデフォルトの納税者番号を自動的に取得します。 連結アカウントに保存されている納税者番号を、そのアカウントのデフォルトの納税者番号として設定できます。次の例では、既存の納税者番号をデフォルトの納税者番号として設定しています。 ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "settings[invoices][default_account_tax_ids][0]"=atxi_123 \ -d "settings[invoices][default_account_tax_ids][1]"=atxi_456 ``` ### 既存または新規のインボイス、サブスクリプション、サブスクリプションスケジュールの発行者を連結アカウントとして設定 次の例では既存のサブスクリプションで `issuer` を設定します。インボイスの最終処理で、サブスクリプションのインボイスは発行者のデフォルトの納税者番号を取り込みます。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "invoice_settings[issuer][type]"=account \ -d "invoice_settings[issuer][account]"="{{CONNECTEDACCOUNT_ID}}" ``` 次の例では請求書の作成時に `issuer` を設定します。 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer="{{CUSTOMER_ID}}" \ -d "issuer[type]"=account \ -d "issuer[account]"="{{CONNECTEDACCOUNT_ID}}" \ -d "transfer_data[destination]"="{{CONNECTEDACCOUNT_ID}}" ``` または、`on_behalf_of` パラメーターを使用すると、連結アカウントの詳細が請求書メール、請求書 PDF、オンライン請求書ページ、および領収書にも印刷されます。 ### 既存または新規の請求書、サブスクリプション、サブスクリプションスケジュールにアカウントの納税者番号を設定する 請求書、サブスクリプション、サブスクリプションスケジュールに `account_tax_ids` を指定して、デフォルトの納税者番号を上書きできます。次の例では既存のサブスクリプションで `account_tax_ids` を設定します。 ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "invoice_settings[issuer][type]"=account \ -d "invoice_settings[issuer][account]"="{{CONNECTEDACCOUNT_ID}}" \ -d "invoice_settings[account_tax_ids][]"=txi_123 \ -d "invoice_settings[account_tax_ids][]"=txi_456 ``` 次の例では請求書の作成時に `account_tax_ids` を設定します。 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer="{{CUSTOMER_ID}}" \ -d "issuer[type]"=account \ -d "issuer[account]"="{{CUSTOMERACCOUNT_ID}}" \ -d "transfer_data[destination]"="{{CUSTOMERACCOUNT_ID}}" \ -d "account_tax_ids[]"=txi_123 \ -d "account_tax_ids[]"=txi_456 ``` ### 連結アカウントのプラットフォームに保存された納税者番号を作成する 作成した納税者番号は、連結アカウントではなくプラットフォームアカウントに保存されます。次の例のように、`Stripe-Account` ヘッダーを使用せずに、連結アカウントに対して 1 つの納税者番号を作成します。 ```curl curl https://api.stripe.com/v1/tax_ids \ -u "<>:" \ -d type=eu_vat \ -d value=DE123456789 \ -d "owner[type]"=account \ -d "owner[account]"="{{CONNECTEDACCOUNT_ID}}" ``` ## プラットフォーム手数料を回収する 請求書では、必要に応じてプラットフォーム手数料を差し引くことができます。以下の例は、連結アカウントへのダイレクト支払いの請求書に対する [application_fee_amount](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-application_fee_percent) を示しています。 #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d application_fee_amount="10" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" ``` 次の例は、デスティネーション支払いを使用する請求書の `application_fee_amount` を示しています。 #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d application_fee_amount="10" \ -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" ``` ## 請求書決済手段の設定 連結アカウントで使用できる請求書[決済手段](https://docs.stripe.com/connect/payment-methods.md)を管理します。決済手段のデフォルトリストを有効にするには、以下のようにします。 1. **設定**\> **請求**\> [請求書](https://dashboard.stripe.com/settings/billing/invoice)に移動します。 1. **デフォルトの決済手段**セクションで、**連結アカウントの決済手段設定**ドロップダウンをクリックします。 1. **デフォルト**を選択して、Stripe が決済手段のデフォルト設定を提供できるようにします。 デフォルト設定を有効にした後も、連結アカウントは個別の決済手段を有効または無効にすることができます。また、[決済手段設定](https://docs.stripe.com/api/payment_method_configurations/create.md) API を使用して、連結アカウントの個別の決済手段を管理することもできます。 導入で[動的な決済手段](https://docs.stripe.com/connect/dynamic-payment-methods.md)を使用している場合は、独自の決済手段設定を作成できます。詳細については、Connect アカウントの[複数の設定](https://docs.stripe.com/connect/multiple-payment-method-configurations.md)をご覧ください。カスタム決済手段設定を作成すると、**連結アカウントの決済手段設定**ドロップダウンにオプションとして表示されます。 ## 連結アカウントを売上処理加盟店にする 連結アカウントを売上処理加盟店にするには、請求書を作成または更新する際に 顧客に `on_behalf_of` パラメーターを使用して請求します。請求書を確定する前に API で `on_behalf_of` を設定する必要があります。ダッシュボードには、連結アカウントの代理で請求書を作成・送信するための UI はダッシュボードにありません。 `on_behalf_of` パラメーターを設定すると、連結アカウントのブランディング、連絡先情報、アカウントの納税者番号が、請求書メール、請求書 PDF、オンライン請求書ページ、領収書に適用されます。ただし、*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)で `on_behalf_of` を使用すると、API で送信する標準の請求書と同様に、メールの送信は行われません。サンドボックスでのテスト中に、ダッシュボードの[請求書ページ](https://dashboard.stripe.com/test/invoices)を確認することで、Stripe が請求書を作成したかどうかを確認できます。 連結アカウントの代わりに支払いを回収するには、連結アカウントで該当する決済手段の[アカウントケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md)も有効になっている必要があります。デスティネーション支払いを使用すると、連結アカウントの代理で作成されたインボイスの支払いを自動的に送金できます。`on_behalf_of​` パラメーターの詳細については、関連する Connect のドキュメントをご覧ください。 - 連結アカウントへの自動送金については、[支払いの作成](https://docs.stripe.com/connect/charges.md#on_behalf_of)ガイドの `on_behalf_of` パラメーターの詳細をご覧ください。 - 支払いを手動で送金する方法については、[送金利用の可否](https://docs.stripe.com/connect/separate-charges-and-transfers.md#transfer-availability)をご覧ください。 - 連結アカウントに代わって支払いを回収するために必要なアカウントのケイパビリティのリストについては、[決済手段のケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md#payment-methods)をご覧ください。 以下の例は、支払いと送金別方式を使用して、新しい請求書に `on_behalf_of` パラメーターを使用する方法を示しています。 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d on_behalf_of="{{CONNECTEDACCOUNT_ID}}" \ -d customer="{{CUSTOMER_ID}}" ``` 標準のデスティネーション支払いと同様に、請求書に `application_fee_amount` を設定できます。この例は、デスティネーション支払いとプラットフォーム手数料を指定して `on_behalf_of` を使用する方法を示しています。 ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d on_behalf_of="{{CONNECTEDACCOUNT_ID}}" \ -d application_fee_amount=10 \ -d "transfer_data[destination]"="{{CONNECTEDACCOUNT_ID}}" \ -d customer="{{CUSTOMER_ID}}" ``` 連結アカウントの代理で作成された請求書は、ACH クレジットトランスファーや小切手などの銀行振込による決済手段に対応していません。 ## 税金の計算と徴収を導入する まず、どの法人に納税義務があるかを判断する必要があります。ビジネスモデルによって、連結アカウントまたはプラットフォームが納税義務を負う法人となります。詳細については、[Connect で Stripe Tax を使用する](https://docs.stripe.com/tax/connect.md)をご覧ください。 ## 参照情報 - [支払いを作成する](https://docs.stripe.com/connect/charges.md) - [アカウント間で顧客を共有する](https://docs.stripe.com/connect/cloning-customers-across-accounts.md) - [複数の通貨](https://docs.stripe.com/connect/currencies.md)