# Colete impostos Aprenda a recolher impostos de pagamentos avulsos no Stripe Checkout. # Página hospedada > This is a Página hospedada for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=stripe-hosted. 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 Você pode criar sessões do Checkout 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d "automatic_tax[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: Atualize produtos e preços O Stripe Tax usa informações armazenadas em *produtos* (Products represent what your business sells—whether that's a good or a service) e *preços* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) para calcular impostos, como *código fiscal* (A tax code is the category of your product for tax purposes) e *comportamento fiscal* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive")). 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](https://dashboard.stripe.com/settings/tax). Para obter mais informações, consulte [Especificar códigos de imposto sobre produtos e comportamento tributário](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md). ## Optional: Calcular 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](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) salvo do cliente para calcular os impostos. Caso contrário, o Checkout usa o [endereço de cobrança](https://docs.stripe.com/api/customers/object.md#customer_object-address) 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](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) ou [faturamento](https://docs.stripe.com/api/customers/object.md#customer_object-address) salvo. Para saber se os endereços salvos de um cliente são válidos, verifique a propriedade [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 \ --data-urlencode "success_url=https://example.com/success" ``` ### 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), o Checkout salva os endereços de entrega informados durante a sessão na propriedade [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-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](https://docs.stripe.com/api/customers/object.md#customer_object-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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 \ --data-urlencode "success_url=https://example.com/success" ``` 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: Verificar a resposta Para ver os resultados do último cálculo de impostos, a propriedade [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) do recurso de sessão do Checkout mostra o valor calculado dos impostos. Você também pode usar o [Dashboard](https://dashboard.stripe.com/) para ver os impostos calculados para cada pagamento. # Página integrada > This is a Página integrada for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=embedded-form. 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Optional: Atualize produtos e preços O Stripe Tax usa informações armazenadas em *produtos* (Products represent what your business sells—whether that's a good or a service) e *preços* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) para calcular impostos, como *código fiscal* (A tax code is the category of your product for tax purposes) e *comportamento fiscal* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive")). 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](https://dashboard.stripe.com/settings/tax). Para obter mais informações, consulte [Especificar códigos de imposto sobre produtos e comportamento tributário](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md). ## Optional: Calcular 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](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) salvo do cliente para calcular os impostos. Caso contrário, o Checkout usa o [endereço de cobrança](https://docs.stripe.com/api/customers/object.md#customer_object-address) 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](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) ou [faturamento](https://docs.stripe.com/api/customers/object.md#customer_object-address) salvo. Para saber se os endereços salvos de um cliente são válidos, verifique a propriedade [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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_page \ --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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection), o Checkout salva os endereços de entrega informados durante a sessão na propriedade [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-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](https://docs.stripe.com/api/customers/object.md#customer_object-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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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_page \ --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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Optional: Verificar a resposta Para ver os resultados do último cálculo de impostos, a propriedade [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) do recurso de sessão do Checkout mostra o valor calculado dos impostos. Você também pode usar o [Dashboard](https://dashboard.stripe.com/) para ver os impostos calculados para cada pagamento.