> ## Documentation Index
> Fetch the complete documentation index at: https://www.finseed.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo funciona Finseed con Stripe

> Finseed se conecta con tu cuenta de Stripe para automatizar la generación y envío de facturas Verifactu a la Agencia Tributaria de forma automática.

## Introducción

Los pagos y facturas de Stripe por defecto no cumplen con los requisitos de Verifactu. Para que puedas seguir usando Stripe y cumplir con la normativa, nosotros nos encargamos de convertir la información de Stripe en facturas Verifactu.

A continuación te explicamos cómo funciona la integración para que entiendas qué ocurre por detrás.

## Dos modos de operación según tu caso

Finseed ofrece dos integraciones con Stripe, cada una diseñada para distintas formas de usar Stripe:

### Finseed para Stripe Billing

Si usas las facturas o suscripciones generadas con Stripe, [Finseed para Stripe Billing](#stripe-billing) captura automáticamente todos los datos fiscales de las facturas de Stripe para generar facturas Verifactu completas. Es el método más fiable ya que accede a toda la información necesaria.

### Finseed para Stripe Payments

Si únicamente usas la pasarela de pago o el checkout de Stripe, [Finseed para Stripe Payments](#stripe-payments) recopila la información desde múltiples fuentes (checkout, perfil del customer, metadata) para generar facturas Verifactu. Funciona especialmente bien para [facturas simplificadas](/docs/verifactu/facturas-simplificadas-completas).

## Flujo de una factura de Stripe a Verifactu

<Steps>
  <Step title="Stripe genera una factura o procesa el pago">
    Cuando Stripe crea una factura (Stripe Billing) o procesa un pago exitoso
    (Stripe Payments), nuestro sistema detecta el evento automáticamente mediante
    webhooks.
  </Step>

  <Step title="Recopilamos la información fiscal">
    Según el tipo de integración, capturamos los datos de la factura de Stripe
    o del pago. En Stripe Billing obtenemos información completa de la factura.
    En Stripe Payments recopilamos datos del checkout, del perfil del customer y
    del PaymentIntent.
  </Step>

  <Step title="Finseed genera la factura">
    Creamos una factura conforme a los requisitos de Verifactu basada en la
    información recopilada. Puede ser una factura completa o simplificada, según
    los datos disponibles y tu configuración.
  </Step>

  <Step title="Enviamos la factura a la Agencia Tributaria">
    Subimos automáticamente la factura a la Agencia Tributaria cumpliendo con
    todos los requisitos de Verifactu.
  </Step>

  <Step title="Enviamos la factura al cliente (opcional)">
    Si lo configuras, también enviamos la factura Verifactu a tu cliente por
    email.
  </Step>
</Steps>

## Stripe Billing

Stripe Billing se utiliza cuando gestionas suscripciones o facturación recurrente con Stripe.

**¿Cuándo usar Stripe Billing?**

* Gestionas suscripciones mensuales o anuales.
* Stripe genera sus propias facturas automáticamente.
* Necesitas emitir facturas completas con todos los datos fiscales del cliente.
* Quieres la máxima fiabilidad en la captura de datos para cumplir con Verifactu.

**Cómo funciona:**
Stripe genera una factura cada vez que cobra una suscripción o emite una factura manual. Finseed captura esa factura, extrae todos los datos fiscales (cliente, productos, impuestos, totales) y genera una factura Verifactu equivalente que envía a la Agencia Tributaria.

**Ventajas:**

* Información completa y estructurada de cliente, productos e impuestos.
* Ideal para generar facturas completas con NIF, dirección y todos los requisitos legales.
* Mayor trazabilidad: cada factura de Stripe tiene su factura Verifactu correspondiente.

<Info>
  **Importante**: Si usas Stripe Billing, las facturas originales de Stripe
  deben convertirse en proforma para evitar duplicidades fiscales. Consulta la
  guía de [configuración de facturas proforma](/docs/stripe/configuracion-proforma)
  para más detalles.
</Info>

## Stripe Payments

Stripe Payments se utiliza cuando cobras pagos puntuales mediante Stripe Checkout, Payment Links o integraciones custom con la API de Payments.

**¿Cuándo usar Stripe Payments?**

* Cobras pagos puntuales (no suscripciones recurrentes).
* Usas Stripe Checkout o Payment Links para crear páginas de pago.
* Tienes una integración custom con Payment Elements o la API de Stripe.
* La mayoría de tus clientes son particulares (B2C) y emites facturas simplificadas.

**Cómo funciona:**
Cuando un pago se completa exitosamente, Finseed captura el evento del PaymentIntent y recopila información de múltiples fuentes: primero del checkout de Stripe (si se usó), luego del perfil del customer y finalmente del metadata del PaymentIntent. Con estos datos generamos una factura Verifactu.

**Limitaciones de información:**
La cantidad de datos fiscales disponibles depende de cómo captures el pago:

* **Stripe Checkout o Payment Links**: Nivel de información medio-alto. Puedes capturar líneas de pedido, impuestos y datos del cliente. Si capturas el NIF en el checkout, puedes generar facturas completas.

* **Integraciones custom con Payments API**: Nivel de información bajo. Generalmente solo tienes acceso al importe, email del cliente y método de pago. En estos casos, solo es viable emitir facturas simplificadas.

**Ventajas:**

* Funciona bien para facturas simplificadas (no requiere dirección del destinatario).
* Ideal para B2C donde no necesitas recopilar todos los datos fiscales del cliente.
* Flexible: se adapta a la información disponible en cada pago.

***

Con esta integración, tu cuenta de Stripe queda completamente preparada para cumplir con Verifactu sin intervención manual. Solo necesitas configurar la conexión una vez y el sistema se encarga del resto.