Pular para o conteúdo
Criar conta
 ou
Entrar
O logotipo da documentação da Stripe
/
Criar conta
Login
Visão geralAtualize sua integração
Pagamentos online
Visão geralEncontre seu caso de usoUse Managed Payments
Formas de pagamento
Interfaces de pagamento
Cenários de pagamento
Pagamentos presenciais
Muito mais que pagamentos

Colete impostos

Aprenda a recolher impostos de pagamentos avulsos no Stripe Checkout.

O Stripe Tax permite que você calcule os impostos sobre pagamentos avulsos e recorrentes quando usa o Checkout. Você pode habilitar o Stripe Tax para calcular automaticamente os impostos em todas as compras e assinaturas do Checkout.

Criar uma sessão do Checkout

Depois de atualizar os produtos e preços, está tudo pronto para você começar a calcular impostos nas sessões do Checkout. É possível criar sessões para compras avulsas e recorrentes.

Para calcular o imposto para novos clientes, o Checkout valida e usa o endereço de entrega ou cobrança informado. Para clientes existentes, o Checkout calcula o imposto validando e usando o endereço de entrega ou cobrança do cliente associado. Se você capturar um novo endereço de cobrança ou entrega para um cliente existente, o Checkout não substituirá automaticamente os dados de cobrança ou entrega anteriores. É preciso solicitar explicitamente que o endereço do cliente seja alterado.

Apple Pay e Google Pay

Para garantir que o Google Pay seja oferecido como forma de pagamento ao usar o Stripe Tax no checkout, você precisa solicitar a recolha de um endereço de entrega ou fornecer a um cliente existente um endereço de entrega salvo. O Apple Pay com Stripe Tax é exibido somente quando o navegador do cliente é compatível com o Apple Pay versão 12 ou superior.

Calcular impostos para novos clientes

Se você não informar um cliente existente ao criar uma sessão do Checkout, o próprio Checkout vai criar um cliente e salvar automaticamente o endereço de cobrança e os dados de entrega. O Checkout usa o endereço de entrega informado durante a sessão para determinar a localização do cliente e calcular os impostos. Se você não coletar os dados de entrega, o Checkout usará o endereço de cobrança.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

OpcionalAtualize produtos e preços

O Stripe Tax usa informações armazenadas em produtos e preços para calcular impostos, como código fiscal e comportamento fiscal. Se você não especificar essas configurações explicitamente, o Stripe Tax usará o código fiscal padrão selecionado em Configurações de impostos.

Para obter mais informações, consulte Especificar códigos de imposto sobre produtos e comportamento tributário.

OpcionalCalcular impostos para clientes atuais

Para calcular os impostos na sessão do Checkout de um cliente existente, defina o parâmetro automatic_tax[enabled] como true ao criar a sessão. Os impostos podem ser calculados com base nos endereços existentes do cliente ou nos novos endereços que você coletou durante o checkout:

Usar endereços existentes do cliente para calcular os impostos

Se você já coletou os endereços dos clientes existentes, pode usá-los como base para o cálculo dos impostos, em vez dos endereços coletados durante o checkout:

  • Quais endereços do cliente são usados pelo Checkout para calcular impostos?

    Se disponível, o Checkout usa o endereço de entrega salvo do cliente para calcular os impostos. Caso contrário, o Checkout usa o endereço de cobrança salvo do cliente.

  • Os endereços do cliente precisam cumprir algum requisito?

    Se você usar endereços existentes para calcular impostos, o cliente deve ter um endereço de entrega ou faturamento salvo. Para saber se os endereços salvos de um cliente são válidos, verifique a propriedade customer.tax.automatic_tax. Se customer.tax.automatic_tax é supported ou not_collecting, os endereços salvos do cliente são válidos e você pode ativar o Stripe Tax nas sessões do Checkout para esse cliente.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Usar endereços coletados durante o checkout para calcular impostos

Você pode configurar o Checkout para salvar os novos endereços de cobrança ou entrega de um cliente. Nesse caso, o Checkout calcula os impostos usando o endereço informado durante o checkout.

  • Qual endereço é usado pelo Checkout para calcular impostos?

    Se você coleta endereços de entrega, o Checkout usa os endereços de entrega informados durante a sessão para calcular os impostos. Caso contrário, o Checkout usa o endereço de cobrança informado durante a sessão.

  • Onde são salvos os endereços coletados durante o checkout?

    Se você coleta endereços de entrega, o Checkout salva os endereços de entrega informados durante a sessão na propriedade customer.shipping.address do cliente. Caso contrário, o Checkout salva o endereço de cobrança informado durante a sessão na propriedade customer.address do cliente. Nos dois casos, os endereços usados para calcular os impostos substituirão qualquer endereço existente.

Se você estiver coletando endereços de entrega com o Checkout, defina a propriedade customer_update[shipping] como auto. Assim, você consegue copiar as informações de entrega do Checkout para o cliente.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Se você não coleta endereços de entrega com o Checkout e quer usar endereços de cobrança informados durante o checkout para calcular os impostos, salve o endereço de cobrança no cliente. Defina a propriedade customer_update[address] como auto para copiar o endereço inserido para o cliente informado.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "customer_update[shipping]"=auto \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

OpcionalVerificar a resposta

Para ver os resultados do último cálculo de impostos, a propriedade total_details.amount_tax do recurso de sessão do Checkout mostra o valor calculado dos impostos. Você também pode usar o Dashboard para ver os impostos calculados para cada pagamento.

Esta página foi útil?
SimNão