Criar faturas com o Connect

Exiba apenas o conteúdo v1

Você pode criar faturas para contas conectadas que usam Direct Charges ou Destination Charges. Você também pode cobrar uma tarifa da plataforma sobre essas faturas.

Criar uma fatura usando Direct Charges

Para criar uma fatura que cobre diretamente em uma conta conectada, crie uma fatura enquanto estiver autenticado como a conta conectada. Para que isso funcione, a cliente precisa estar definida na conta conectada.

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

Semelhante a criar uma cobrança direta 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. 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 e informe o ID da conta conectada como o valor transfer_data[destination].

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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 têm requisitos regulatórios para que os comerciantes mostrem seus IDs fiscais e outros detalhes comerciais em documentos destinados aos 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.
2. Defina IDs fiscais padrão para a sua conta conectada.
3. Especifique a conta conectada usando o parâmetro 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 https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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 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

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 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}}"

O exemplo abaixo define issuer durante a criação da fatura:

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}}"

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

O exemplo abaixo define account_tax_ids durante a criação da fatura:

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

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 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}}"

Coletar tarifas da plataforma

Na fatura, você pode reter uma tarifa da plataforma. O exemplo a seguir mostra uma application_fee_amount de uma fatura com cobrança direta na conta conectada:

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}}
"

Este exemplo mostra um application_fee_amount para uma fatura com uma cobrança de destino:

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}}"

Configurar formas de pagamento de faturas

Gerencie as formas de pagamento 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.
2. Na seção Formas de pagamento padrão, clique no menu suspenso Configuração de formas de pagamento de contas conectadas.
3. 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.

Se a sua integração usa formas de pagamento dinâmicas, você pode criar sua própria configuração de forma de pagamento. Para saber mais, consulte Várias configurações para suas contas conectadas. 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, 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 do Dashboard.

Para coletar pagamentos em nome da conta conectada, ela também precisa ter funções de conta 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.
• Para saber como transferir pagamentos manualmente, consulte Disponibilidade de transferência.
• Veja uma lista dos recursos de conta necessários para cobrar pagamentos em nome de contas conectadas em Funções de formas de pagamento.

Este exemplo mostra como usar o parâmetro on_behalf_of em uma nova fatura utilizando cobranças e transferências separadas:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
"{{CONNECTED_ACCOUNT_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 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}}"

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.

Veja também

• Criar cobranças
• Compartilhar clientes entre várias contas
• Várias moedas