# Criar faturas com o Connect Com o Connect, você pode criar faturas para contas conectadas e, opcionalmente, cobrar tarifas no processo. Ainda não conhece bem o *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)? Confira nosso artigo de [Visão geral](https://docs.stripe.com/connect.md). Você pode criar *faturas* (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) para contas conectadas que usam [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) ou [Destination Charges](https://docs.stripe.com/connect/destination-charges.md). Você também pode cobrar uma tarifa da plataforma sobre essas faturas. > As transações de faturas são baseadas nos [preços do Invoicing](https://stripe.com/invoicing/pricing). ## Criar uma fatura usando Direct Charges Para criar uma fatura que cobre diretamente em uma conta conectada, [crie uma fatura](https://docs.stripe.com/api.md#create_invoice) enquanto estiver [autenticado](https://docs.stripe.com/connect/authentication.md#stripe-account-header) como a conta conectada. Para que isso funcione, a cliente precisa estar definida na conta conectada. #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" ``` Semelhante a [criar uma cobrança direta](https://docs.stripe.com/connect/direct-charges.md#collect-fees) em uma conta conectada, você pode criar uma cliente em uma conta conectada usando a chave publicável da plataforma ou a chave publicável da conta conectada. {% if equals($accountsNamespace, "v1%)}Você também pode criar um token usando os [clientes compartilhados](https://docs.stripe.com/connect/cloning-customers-across-accounts.md). Quando você usa Direct Charges, a conta conectada é responsável pelos custos das tarifas da Stripe, reembolsos e estornos. ## Criar uma fatura usando Destination Charges Para criar uma fatura que faça cobranças na plataforma e crie transferências automáticas para uma conta conectada, [crie uma fatura](https://docs.stripe.com/api.md#create_invoice) e informe o ID da conta conectada como o [valor](https://docs.stripe.com/api/invoices/object.md#invoice_object-transfer_data) `transfer_data[destination]`. #### curl ```bash curl https://api.stripe.com/v1/invoices \ -u <>: \ -d customer={{CUSTOMER_ID}} \ -d "transfer_data[destination]"="{{CONNECTED_ACCOUNT_ID}}" ``` Para que isso funcione, a cliente precisa ser definida na conta da plataforma, e você precisa criar o token da conta conectada usando a chave publicável da plataforma. Para usar transferências automáticas, a plataforma é a empresa registrada. ## Exibir IDs fiscais de contas conectadas e dados da empresa nas suas faturas Algumas regiões possuem requisitos regulatórios para que as empresas exibam seus IDs fiscais e outros dados comerciais em documentos voltados para os clientes Em alguns casos, você pode cumprir esses requisitos exibindo informações sobre uma conta conectada em vez de informações sobre sua plataforma. As etapas a seguir mostram como renderizar o ID fiscal e os dados comerciais de uma conta conectada em e-mails de fatura, PDFs de faturas, páginas de faturas hospedadas e recibos de faturas: 1. Crie IDs fiscais para a sua conta conectada. 1. Defina IDs fiscais padrão para a sua conta conectada. 1. Especifique a conta conectada usando o [parâmetro `on_behalf_of`](https://docs.stripe.com/invoicing/connect.md#on-behalf-of) ou como `issuer` em faturas, assinaturas e cronogramas de assinaturas novos ou existentes. ### Crie IDs fiscais para a sua conta conectada O exemplo abaixo cria um ID fiscal único para a conta conectada. A Stripe armazena o ID fiscal na conta conectada. Para criar mais IDs fiscais, faça outra chamada para o endpoint. ```curl curl https://api.stripe.com/v1/tax_ids \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=eu_vat \ -d value=DE123456789 ``` ### Defina IDs fiscais padrão para a sua conta conectada. A Stripe extrai automaticamente os IDs fiscais da conta do `issuer` da fatura durante a finalização, a menos que `account_tax_ids` já esteja definido nas faturas. Você pode definir os IDs fiscais armazenados na conta conectada como os IDs fiscais padrão dessa conta. O exemplo abaixo define IDs fiscais existentes como IDs fiscais padrão: ```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 ``` ### Defina o emissor para as faturas, assinaturas e cronogramas de assinaturas novos ou existentes como a conta conectada. O exemplo abaixo define `issuer` em uma assinatura existente. Durante a finalização da fatura, as faturas de assinatura puxam os IDs fiscais padrão do emissor: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d "invoice_settings[issuer][type]"=account \ -d "invoice_settings[issuer][account]"="{{CONNECTEDACCOUNT_ID}}" ``` O exemplo abaixo define `issuer` durante a criação da fatura: ```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}}" ``` Como alternativa, o parâmetro `on_behalf_of` também imprime os dados da conta conectada no e-mail, no PDF, na página da fatura hospedada e no recibo da fatura. ### Definir IDs fiscais da conta em faturas, assinaturas e cronogramas de assinaturas novos ou existentes Você pode especificar `account_tax_ids` para faturas, assinaturas e cronogramas de assinaturas para sobrepor os IDs fiscais padrão. O exemplo abaixo define `account_tax_ids` em uma assinatura existente: ```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 ``` O exemplo abaixo define `account_tax_ids` durante a criação da fatura: ```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 ``` ### Criar IDs fiscais armazenados na plataforma para sua conta conectada O ID fiscal criado por você é armazenado na conta da plataforma, e não na conta conectada. O exemplo a seguir cria um ID fiscal único para a conta conectada sem usar o cabeçalho `Stripe-Account`: ```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}}" ``` ## Coletar tarifas da plataforma Na fatura, você pode reter uma tarifa da plataforma. O exemplo a seguir mostra uma [application_fee_amount](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-application_fee_percent) de uma fatura com cobrança direta na conta conectada: #### 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}}" ``` Este exemplo mostra um `application_fee_amount` para uma fatura com uma cobrança de destino: #### 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}}" ``` ## Configurar formas de pagamento de faturas Gerencie as [formas de pagamento](https://docs.stripe.com/connect/payment-methods.md) de fatura que as contas conectadas podem usar. Para ativar uma lista padrão de formas de pagamento: 1. Vá até **Configurações** > **Faturamento** > [Fatura](https://dashboard.stripe.com/settings/billing/invoice). 1. Na seção **Formas de pagamento padrão**, clique no menu suspenso **Configuração de formas de pagamento de contas conectadas**. 1. Selecione **Padrão** para permitir que a Stripe forneça a configuração padrão das formas de pagamento. Suas contas conectadas ainda terão a capacidade de ativar e desativar formas de pagamento individuais depois que você ativar a configuração padrão. Você também pode gerenciar as formas de pagamento de contas conectadas individuais usando a API de [configuração de formas de pagamento](https://docs.stripe.com/api/payment_method_configurations/create.md). Se a sua integração usa [formas de pagamento dinâmicas](https://docs.stripe.com/connect/dynamic-payment-methods.md), você pode criar sua própria configuração de forma de pagamento. Para saber mais, consulte [Várias configurações para suas contas conectadas](https://docs.stripe.com/connect/multiple-payment-method-configurations.md). Se você criar uma configuração de forma de pagamento personalizada, ela será exibida como uma opção no menu suspenso **Configuração de forma de pagamento de contas conectadas**. ## Tornar a conta conectada o comerciante da liquidação Para tornar a conta conectada o comerciante da liquidação, cobre a cliente usando o parâmetro `on_behalf_of` ao criar ou atualizar a fatura. Você precisa definir `on_behalf_of` na API antes de finalizar uma fatura. O Dashboard não tem uma interface para faturas enviadas em nome de contas conectadas. A definição do parâmetro `on_behalf_of` aplica os dados de marca, contato e ID fiscal da conta conectada ao e-mail, PDF, página da fatura hospedada e recibo da fatura. No entanto, quando você usa `on_behalf_of` em uma *área restrita* (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), os e-mails não são enviados, assim como nas faturas padrão enviadas pela API. Durante o teste em uma área restrita, você pode confirmar se a Stripe criou uma fatura verificando a [página Faturas](https://dashboard.stripe.com/test/invoices) do Dashboard. Para coletar pagamentos em nome da conta conectada, ela também precisa ter [funções de conta](https://docs.stripe.com/connect/account-capabilities.md) habilitadas para as formas de pagamento relevantes. Você pode transferir automaticamente pagamentos de faturas criadas em nome da conta conectada usando cobranças de destino. Leia mais sobre o parâmetro `on_behalf_of​` na documentação pertinente do Connect: - Para transferências automáticas para a conta conectada, consulte os detalhes do parâmetro `on_behalf_of` no guia [Criar uma cobrança](https://docs.stripe.com/connect/charges.md#on_behalf_of). - Para saber como transferir pagamentos manualmente, consulte [Disponibilidade de transferência](https://docs.stripe.com/connect/separate-charges-and-transfers.md#transfer-availability). - Veja uma lista dos recursos de conta necessários para cobrar pagamentos em nome de contas conectadas em [Funções de formas de pagamento](https://docs.stripe.com/connect/account-capabilities.md#payment-methods). Este exemplo mostra como usar o parâmetro `on_behalf_of` em uma nova fatura utilizando cobranças e transferências separadas: ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d on_behalf_of="{{CONNECTEDACCOUNT_ID}}" \ -d customer="{{CUSTOMER_ID}}" ``` Semelhante ao caso das Destination Charges, você pode definir um `application_fee_amount` nas faturas. Este exemplo mostra como usar `on_behalf_of` com uma Destination Charge e uma tarifa da plataforma. ```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}}" ``` As faturas criadas em nome de uma conta conectada não aceitam formas de pagamento como transferência bancária, incluindo transferência de crédito ACH e cheques físicos. ## Integre o cálculo e recolhimento de impostos Primeiro, você precisa determinar qual entidade está sujeita a impostos. A entidade responsável pelos impostos pode ser sua conta conectada ou a plataforma, dependendo do seu modelo de negócio. Para saber mais, consulte [Stripe Tax com Connect](https://docs.stripe.com/tax/connect.md). ## Veja também - [Criar cobranças](https://docs.stripe.com/connect/charges.md) - [Compartilhar clientes entre várias contas](https://docs.stripe.com/connect/cloning-customers-across-accounts.md) - [Várias moedas](https://docs.stripe.com/connect/currencies.md)