Recolher impostos no Checkout

Quando calcula os impostos, o Stripe Tax usa as informações armazenadas nas APIs Products e Prices para determinar as taxas e regras corretas. Você pode atualizar os produtos e preços do Checkout para incluir:

• tax_behavior: especifica se o preço inclui (inclusive) ou exclui (exclusive) impostos.
• tax_code (_opcional _) - Especifica o código fiscal do produto. Se você não definir um tax_code em um produto, nós aplicamos o código fiscal predefinido do produto. Para saber mais, consulte nossa lista de códigos fiscais.

Quando você define o parâmetro tax_behavior como exclusive, os impostos são adicionados ao subtotal. Isso é comum em mercados dos EUA e vendas B2B (business-to-business). Se você definir tax_behavior como inclusive, o valor pago pelo comprador nunca será alterado (mesmo que a alíquota varie). Essa prática é comum para compradores B2C (business-to-consumer) em mercados fora dos EUA. Se você não quiser definir antecipadamente seus produtos e preços, passe os parâmetros price_data.tax_behavior e product_data.tax_code na 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

Se quiser garantir que o Google Pay seja exibido como forma de pagamento quando o Stripe Tax é usado no Checkout, é preciso coletar o endereço de entrega. O Apple Pay com Stripe Tax é exibido apenas quando o navegador do cliente aceita o Apple Pay versão 12.

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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"