Connect を使用してインボイスを作成する
連結アカウントの請求書を作成できます。これは支払い回収で複数の方法をサポートします。請求書は、ダイレクト支払いを使用して連結アカウントに直接作成することも、デスティネーション支払いを使用して連結アカウントへの送金とともにプラットフォームで作成することもできます。これらの請求書に、プラットフォーム手数料を設定することもできます。
注
Invoice transactions are based on Invoicing pricing.
ダイレクト支払いを使用してインボイスを作成する
連結アカウントに直接請求する請求書を作成するには、連結アカウントとして認証されているときにインボイスを作成します。これを機能させるには、連結アカウントでその顧客が定義されている必要があります。
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 を指定して、Create invoice (インボイスの作成)を実行します。
これが機能するためには、プラットフォームアカウントで顧客が定義され、かつプラットフォームの公開可能キーを使用して、連結アカウントのトークンが作成されている必要があります。顧客に請求する場合は、その顧客がプラットフォームアカウント内に存在する必要があります。自動送金を使用する際は、プラットフォームが記録対象のビジネスになります。
Display Connected Account Tax IDs and Business Details on your Invoices
Certain regions have regulatory requirements for merchants to show their tax IDs and other business details on customer-facing documents.
In some cases, you can fulfill these requirements by displaying information about a connected account instead of information about your platform. The following steps show how to render a connected account’s tax ID and business details on invoice emails, invoice PDFs, Hosted Invoice Pages, and invoice receipts:
- Create tax IDs for your connected account.
- Set default tax IDs for your connected account.
- Specify the connected account either using the
on_behalf_of
parameter or as theissuer
on existing or new invoices, subscriptions, and subscription schedules.
Create tax IDs for your connected account
The following example creates a single tax ID for the connected account. Stripe stores the tax ID on the connected account. To create additional tax IDs, call the endpoint again.
Set default tax IDs for your connected account
Stripe automatically pulls default tax IDs from the invoice issuer
’s account during finalization unless account_tax_ids
is already set on the invoices.
You can set the tax IDs stored on the connected account as the default tax IDs for that account. The following example sets existing tax IDs as default tax IDs:
Set issuer on existing or new invoices, subscriptions, and subscription schedules as the connected account
The following example sets issuer
on an existing subscription. During invoice finalization, subscription invoices pull in the issuer’s default tax IDs:
The following example sets issuer
during invoice creation:
Alternatively, the on_behalf_of
parameter also prints a connected account’s details on the invoice email, invoice PDF, Hosted Invoice Page, and invoice receipt.
Set account tax IDs on existing or new invoices, subscriptions, and subscription schedules
You can specify account_tax_ids
for invoices, subscriptions, and subscription schedules to override the default tax IDs. The following example sets account_tax_ids
on an existing subscription:
The following example sets account_tax_ids
during invoice creation:
Create tax IDs stored on the platform for your connected account
The tax ID you create is stored on the platform account instead of the connected account. The following example creates a single tax ID for the connected account without using the Stripe-Account
header:
プラットフォーム手数料を回収する
インボイスでは、必要に応じてプラットフォーム手数料を差し引くことができます。次の例は連結アカウントでダイレクト支払いを使用するインボイスの application_fee_amount を示しています。
次の例は、デスティネーション支払いを使用するインボイスの application_fee_amount
を示しています。
連結アカウントを売上処理加盟店にする
連結アカウントを売上処理加盟店にするには、インボイスを作成または更新する際に on_behalf_of
パラメーターを使用して顧客に請求します。インボイスを確定する前に API で on_behalf_of
を設定する必要があります。ダッシュボードには、連結アカウントの代理としてインボイスを送信するためのインターフェイスがありません。
Setting the on_behalf_of
parameter applies the branding, contact information, and account tax ID of the connected account to the invoice email, invoice PDF, Hosted Invoice Page, and invoice receipt. However, when you use on_behalf_of
in test mode, emails aren’t sent—just like standard invoices sent via API. In test mode, you can verify that Stripe created an invoice by checking the Invoices page of the Dashboard.
連結アカウントに代わって支払いを回収するには、連結アカウントでも、関連する支払い方法のアカウントのケイパビリティが有効になっている必要があります。連結アカウントに代わって作成したインボイスに対する支払いは、デスティネーション支払いを使用して自動的に送金することができます。on_behalf_of
パラメーターの詳細については、関連する Connect ドキュメントをご覧ください。
- 連結アカウントへの自動送金については、支払いの作成ガイドの
on_behalf_of
パラメーターの詳細をご覧ください。 - For information on how to transfer payments manually, refer to Transfer availability.
- 連結アカウントに代わって支払いを回収するために必要なアカウントのケイパビリティのリストについては、支払い方法のケイパビリティをご覧ください。
以下の例は、支払いと送金別方式を使用して、新しいインボイスに on_behalf_of
パラメーターを使用する方法を示しています。
標準のデスティネーション支払いと同様に、インボイスに application_fee_amount
を設定できます。この例は、デスティネーション支払いとプラットフォーム手数料を指定して on_behalf_of
を使用する方法を示しています。
Invoices created on behalf of a connected account don’t support bank transfers payment methods, such as ACH Credit Transfer and paper checks.
Integrate tax calculation and collection
You need to first determine which entity is liable for tax. The entity that’s liable for tax might be your connected account or the platform, depending on your business model. To learn more, see Stripe Tax with Connect.