Ir a contenido
Crea una cuenta
 o
Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuenta
Iniciar sesión
ResumenActualiza tu integración
Pagos electrónicos
ResumenEncuentra tu caso de usoUse Managed Payments
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
Más allá de los pagos

Cobra impuestos

Cómo cobrar impuestos por pagos únicos en Stripe Checkout.

Stripe Tax te permite calcular los impuestos de tus pagos únicos y recurrentes al usar Checkout. Puedes habilitar Stripe Tax para que calcule automáticamente los impuestos de todas las compras y suscripciones de Checkout.

Crea una sesión de Checkout

Después de actualizar los productos y precios, ya tienes todo listo para empezar a calcular impuestos en tus sesiones de Checkout. Puedes crear sesiones para compras únicas y recurrentes.

Para calcular los impuestos de los nuevos clientes, Checkout valida y utiliza la dirección de envío o de pago provista. En el caso de los clientes existentes, para calcular los impuestos, Checkout valida y usa la dirección de envío o de pago asociada al cliente. Si capturas una nueva dirección de pago o de envío de un cliente existente, Checkout no reemplazará automáticamente la información anterior de pago o de envío, sino que deberás pedir el cambio de dirección del cliente en forma expresa.

Apple Pay y Google Pay

Si deseas asegurarte de que Google Pay se ofrezca como método de pago mientras usas Stripe Tax en el proceso de compra, debes solicitar una dirección de envío o proporcionar a un cliente existente una dirección de envío guardada. Apple Pay con Stripe Tax solo se muestra cuando el navegador del cliente admite la versión 12 de Apple Pay o posterior.

Calcula impuestos para clientes nuevos

Si al crear la sesión, no especificas que el cliente ya existe, Checkout creará un nuevo cliente y automáticamente guardará la dirección de pago y los datos de envío. Checkout utiliza la dirección de envío para determinar la ubicación del cliente y calcular los impuestos. Si no recopilas los datos de envío, Checkout utilizará la dirección de pago.

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"

OpcionalActualiza los productos y precios

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 especificas explícitamente estas configuraciones, Stripe Tax utilizará el código fiscal predeterminado seleccionado en la Configuración de impuestos.

Para obtener más información, consulta Especificar códigos de impuestos de productos y comportamiento impuestos.

OpcionalCalcula impuestos para clientes existentes

Para calcular impuestos en la sesión de Checkout de un cliente existente, establece el parámetro automatic_tax[enabled] en true al crear la sesión. Para el cálculo de impuestos, puedes tomar las direcciones del cliente ya existentes o las nuevas recopiladas durante el proceso de compra:

Usa las direcciones existentes del cliente para calcular impuestos

Si ya recopilaste las direcciones de los clientes existentes, puedes basar los cálculos de impuestos en esas direcciones y no en las direcciones recopiladas durante el proceso de compra:

  • ¿Qué dirección del cliente utiliza Checkout para el cálculo de impuestos?

    Para calcular los impuestos, Checkout utiliza la dirección de envío que tienes guardada. Si no está disponible, Checkout utilizará la dirección de pagos guardada del cliente.

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

    Si usas las direcciones existentes para el cálculo de impuestos, el cliente debe tener una dirección de envío o una dirección de pagos válida guardada. Para comprobar si las direcciones guardadas de un cliente son válidas, puedes revisar la propiedad customer.tax.automatic_tax. Si el valor customer.tax.automatic_tax es supported o not_collecting, las direcciones guardadas del cliente son válidas y podrás habilitar Stripe Tax en las sesiones de Checkout de ese 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"

Usa las direcciones recopiladas durante el proceso de compra para el cálculo de impuestos

Puedes configurar Checkout para guardar las nuevas direcciones de pago o de envío del cliente. En este caso, Checkout calcula los impuestos utilizando las direcciones introducidas durante el proceso de compra.

  • ¿Qué dirección utiliza Checkout para el cálculo de impuestos?

    Si recopilas la dirección de envío, Checkout utiliza la dirección de envío introducida durante la sesión para calcular los impuestos. Si no está disponible, Checkout utilizará la dirección de pagos introducida durante la sesión.

  • ¿Dónde se guardan las direcciones recopiladas durante el proceso de compra?

    Si recopilas las direcciones de envío, Checkout guardará la dirección de envío introducida durante la sesión en la propiedad customer.shipping.address del cliente. Si no está disponible, Checkout guardará la dirección de pagos introducida durante la sesión en la propiedad customer.address del cliente. En ambos casos, la dirección utilizada para el cálculo de impuestos anulará las direcciones existentes.

Si recopilas direcciones de envío con Checkout, establece la propiedad customer_update[shipping] en auto. De esta manera, podrás copiar los datos de envío y pasarlos de Checkout al 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"

Si no recopilas direcciones de envío con Checkout y quieres usar las direcciones de pagos introducidas durante el proceso de compra para el cálculo de impuestos, debes guardar la dirección de pagos en el cliente. Establece la propiedad customer_update[address] en auto para poder copiar la dirección recién introducida y pasarla al cliente correspondiente.

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"

OpcionalRevisa la respuesta

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

¿Te fue útil esta página?
SíNo