Saltar al contenido principal
Stripe Billing incluye su propio portal de clientes, pero las facturas que muestra son las de Stripe, no facturas Verifactu con validez legal en España. Un cliente que solo tiene acceso a ese portal no puede descargar sus facturas con validez fiscal. EasyVerifactu te permite dar a cada cliente acceso de autoservicio a las facturas Verifactu que generamos a partir de sus pagos o facturas de Stripe. Hay dos formas de hacerlo, según cuánto control quieras sobre la experiencia.

​
Dos formas de hacerlo

Elige según dónde quieras que el cliente vea sus facturas:
  • Portal del cliente. Una página alojada por EasyVerifactu. Generas un enlace firmado desde tu servidor y se lo envías al cliente; al abrirlo, ve la lista de sus facturas y descarga cada una en PDF. No tienes que construir ninguna interfaz. Es la opción más rápida de implementar.
  • Listar las facturas con la API. Integras las facturas en tu propia interfaz: tu área de cliente, tu aplicación o un email. Tu servidor pide a la API las facturas de cada cliente y un enlace de descarga para cada una, y tú decides cómo y dónde mostrarlas.
A continuación se detalla cada opción.

​
Antes de empezar

La llamada a la API se autentica con una clave API. Si aún no tienes una, créala antes de continuar:
  1. Ve a Configuración > Claves API.
  2. Pulsa Nueva clave y dale un nombre descriptivo.
  3. Copia la clave en el momento. Solo se muestra una vez.
La clave está limitada a un entorno: una clave de test (ev_test_…) solo ve clientes de test y una clave de producción (ev_live_…) solo ve clientes reales. Haz siempre las llamadas desde tu servidor y guarda la clave como un secreto, nunca en código del lado del cliente. El proceso completo está en Claves API.

​
Portal del cliente

El portal del cliente es una página alojada en EasyVerifactu desde la que cada cliente ve y descarga sus facturas Verifactu, sin credenciales ni contraseñas. Tú generas el enlace, se lo entregas y caduca al cabo de una hora.
  1. Identifica al cliente por su id de Stripe. El external_customer_id que pide la API es el id del cliente en Stripe (cus_…), el mismo que ya usas en tu integración.
  2. Genera el enlace desde tu servidor. Llama a POST /v1/customer_portal/sessions con ese id y tu clave API, y obtén la URL del portal.
  3. Entrega el enlace al cliente. Sustituye el enlace al portal de Stripe, o añádelo junto a él, en el email de confirmación, tu área de cliente o donde lo muestres hoy.
curl https://api.finseed.es/v1/customer_portal/sessions \
  -X POST \
  -H "Authorization: Bearer ev_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "external_customer_id": "cus_9aZ" }'
La respuesta incluye la URL del portal y su fecha de caducidad: 
{
  "url": "https://app.easyverifactu.com/app/customer-portal/eyJ…",
  "expires_at": "2026-06-01T10:30:00Z"
}
Genera el enlace siempre bajo demanda, nunca lo almacenes como URL permanente. El flujo completo, lo que ve el cliente y las consideraciones de seguridad están en la guía del portal del cliente. Si tu entorno tiene más de una integración, añade también integration_id para indicar a qué integración pertenece el cliente; con una sola integración puedes omitirlo. Los detalles están en la guía del portal del cliente.

​
Listar las facturas con la API

Si prefieres mostrar las facturas dentro de tu propia interfaz, pídelas a la API y obtén un enlace de descarga para cada una. Todo ocurre entre tu servidor y EasyVerifactu, con tu clave API.
  1. Lista las facturas del cliente. Llama a GET /v1/invoices filtrando por external_customer_id, el id del cliente en Stripe (cus_…). La respuesta trae una página con el número, la fecha, el estado y los importes de cada factura.
  2. Obtén el enlace de descarga. Para cada factura, llama a GET /v1/invoices/{id}/download. Recibirás un download_url firmado, válido durante 24 horas, que puedes entregar al navegador para descargar el PDF.
curl 'https://api.finseed.es/v1/invoices?external_customer_id=cus_9aZ' \
  -H "Authorization: Bearer ev_live_…"
La lista viene paginada por cursor: sigue el campo next_url de la respuesta para recorrer el resto de páginas. Los detalles están en Pagination. Tu clave API ve todas las facturas de tu entorno, no solo las de un cliente. Antes de mostrar una factura a un usuario que ha iniciado sesión, comprueba en tu aplicación que esa factura le pertenece.

​
Facturas anteriores de Stripe

Cuando empiezas a usar EasyVerifactu ya tienes un historial de facturas que solo existían en Stripe. Por defecto, el portal de EasyVerifactu también muestra a cada cliente esas facturas anteriores de Stripe, las que emitiste antes de empezar a emitir facturas Verifactu con EasyVerifactu. Así el cliente mantiene en un único sitio todo su historial: las facturas antiguas de Stripe y las nuevas facturas Verifactu. Las dos aparecen en la misma lista. El cliente ve un listado único de sus facturas, sin una sección aparte de Stripe y sin saber qué sistema generó cada una. Solo mostramos las facturas anteriores. En cuanto emitimos la factura Verifactu oficial de una factura de Stripe, el portal solo muestra la factura Verifactu, nunca las dos a la vez. En concreto, mostramos las facturas de Stripe con fecha anterior a la primera factura que EasyVerifactu emitió para esa integración. Al pulsar en una factura anterior, el cliente descarga el PDF original de Stripe. Si ese PDF no está disponible, abrimos la página de la factura alojada por Stripe, donde el cliente puede descargarla. Esta opción está activada por defecto. Puedes desactivarla por cada integración de Stripe. En la aplicación, entra en los ajustes de la integración, abre Configuración de Stripe y desactiva la opción para mostrar las facturas anteriores de Stripe en el portal de clientes. Si la desactivas, el portal muestra solo las facturas Verifactu. Esta opción solo aparece en las integraciones de tipo Stripe Invoices, no en las de Stripe Payments.

​
Genera el código con IA

Pega este prompt en tu asistente de código para implementar cualquiera de las dos formas:

Copia este prompt en tu asistente de código para dar a tus clientes de Stripe acceso a sus facturas Verifactu.