Cobrar impuestos

Stripe Tax utiliza la información almacenada en los productos y los precios para calcular los impuestos, como el código fiscal y el comportamiento fiscal. Si no especifica explícitamente estas configuraciones, Stripe Tax utilizará el código fiscal predeterminado elegido en la configuración de Tax.

Para obtener más información, consulta Especificar los códigos fiscales y el comportamiento fiscal de los productos.

Para calcular los impuestos en la sesión de Checkout de un cliente existente, configura el parámetro automatic_tax[enabled] como true al crear la sesión. Puedes basar el cálculo de los impuestos en las direcciones existentes del cliente o en las nuevas direcciones que hayas recopilado durante el proceso de compra:

Usar direcciones existentes del cliente para calcular los impuestos

Si ya has recopilado las direcciones de tus clientes existentes, puedes basar el cálculo de los impuestos en dichas direcciones en lugar de utilizar las direcciones recopiladas durante el proceso de compra:

• ¿Qué dirección del cliente usa Checkout para calcular los impuestos?

  Si está disponible, Checkout utiliza la que ha guardado el cliente dirección de envío para calcular los impuestos. De lo contrario, Checkout utiliza la dirección de facturación que ha guardado el cliente para calcular los impuestos.

• ¿Las direcciones de los clientes tienen que cumplir algún requisito?

  Cuando se usan direcciones existentes para los impuestos, el cliente debe tener guardada una dirección de envío o una dirección de facturación válidas. Puedes ver si las direcciones guardadas de un cliente son válidas o no comprobando su propiedad customer.tax.automatic_tax. Si el valor de customer.tax.automatic_tax es supported o not_collecting, las direcciones guardadas del cliente son válidas y puedes habilitar Stripe Tax en las sesiones de Checkout para ese cliente.

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"

Para los impuestos, utiliza las direcciones recopiladas en el proceso de compra

Puedes configurar Checkout para que guarde las nuevas direcciones de facturación o envío de los clientes. En este caso, Checkout calcula el impuesto utilizando la dirección facilitada durante el proceso de compra.

• ¿Qué dirección usa Checkout para calcular los impuestos?

  Si estás recopilando direcciones de envío, Checkout utiliza la dirección de envío introducida durante la sesión para calcular los impuestos. De lo contrario, Checkout utiliza la dirección de facturación introducida durante la sesión para calcular los impuestos.

• ¿Dónde se guardan las direcciones que se recopilan en el proceso de compra?

  Si estás recopilando direcciones de envío, Checkout guarda la dirección de envío introducida durante la sesión en la propiedad customer.shipping.address del cliente. De lo contrario, el proceso de pago guarda la dirección de facturación introducida durante la sesión en la propiedad customer.address del cliente. En ambos casos, la dirección usada para los impuestos anulará cualquier dirección existente.

Si recopilas direcciones de envío con Checkout, establece la propiedad customer_update[shipping] en auto. Esto te permite copiar la información de envío de Checkout al cliente.

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"

Si no recopilas direcciones de envío con Checkout y quieres usar las direcciones de facturación introducidas durante el proceso de pago para los impuestos, debes guardar la dirección de facturación para el cliente. Establece la propiedad customer_update[address] en auto para que puedas copiar la dirección recién introducida en el cliente correspondiente.

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"

Para ver los resultados del último cálculo de impuestos, la propiedad total_details.amount_tax en el recurso Checkout Session muestra el importe del impuesto calculado. Además, puedes usar el Dashboard para ver el resultado fiscal de cada pago.