FrancodesystemsFran<code>systems
Pasarelas de pagoIntegración a medida

Integración Holded Redsys

Redsys (TPV virtual o físico) integrado con la facturación de Holded.

HoldedHolded
Redsys

Tiempo de implantación · 4-7 días laborables

Diagnóstico

El problema

Redsys procesa la inmensa mayoría de cobros con tarjeta en España, online y físico. Pero su salida hacia Holded es nula: el banco te manda un listado mensual, y alguien se encarga de cruzarlo con tu facturación para conciliar. Para una tienda física con TPV haciendo 500 cobros/mes esto es un dolor cíclico cada cierre: cuadrar tarjeta-a-tarjeta, perseguir transacciones rechazadas, y atender al banco cuando los importes no cuadran. Si tienes ecommerce + TPV físico, multiplicas el problema. Y si el TPV es de varios bancos, lo pierdes por completo.

Propuesta

La solución

Conciliación automática de cobros del TPV Redsys con facturas en Holded. Cada notificación firmada de Redsys (online OK o presencial OK) se cruza con el pedido o factura correspondiente y se marca como cobrada. Las devoluciones del TPV generan rectificativas Holded. Soporta TPV virtual con cualquier banco español que use Redsys (BBVA, Sabadell, CaixaBank, Santander, Bankinter, Abanca, Unicaja, etc.) y TPV físico que reporte vía Redsys.

Scope

Qué automatizamos

  • Notificación Redsys OK → marcar factura/pedido Holded como cobrada
  • Notificación KO → registro en Holded como intento fallido para dunning
  • Devolución Redsys → factura rectificativa Holded con su importe
  • TPV físico: lote diario de Redsys → conciliación con pedidos del día
  • Multi-comercio (varios FUC/TPV) → series de facturación distintas en Holded
  • Reconciliación con extracto bancario: matching automático Redsys ↔ banco
  • Comisiones del banco (TSI, Visa, MasterCard) → asiento de gasto
  • Tokens de tarjeta para suscripciones → reuso seguro sin almacenar PAN
Quién lo usa

Casos de uso reales

Estos son los perfiles que más nos piden la integración HoldedRedsys y qué consiguen al final.

Caso 01

Tienda física con TPV físico y ecommerce con TPV virtual

Antes: Conciliar TPV físico + ecommerce + Holded cada cierre era una pesadilla de 2 días.

Después: Cobros físicos y online unificados en Holded. Conciliación al céntimo cada día, no cada mes.

Caso 02

Empresa con TPV de dos bancos (Sabadell + CaixaBank)

Antes: Dos sistemas separados, dos series de facturación inventadas a posteriori, descuadres frecuentes.

Después: Cada banco con su serie y conciliación propia. Reporting limpio por banco/comercio.

Caso 03

Suscripción mensual con tokens guardados en Redsys

Antes: Los cobros recurrentes con token Redsys no llegaban automáticamente a Holded.

Después: Cada cobro recurrente exitoso → factura recurrente Holded. Failed → dunning automático.

Antes / Después

Qué cambia exactamente

El día a día sin la integración y con ella, lado a lado.

Sin la integración

  • Conciliación TPV manual cada cierre
  • Multi-banco/multi-FUC sin separación contable clara
  • Devoluciones de tarjeta mal reflejadas
  • Sin trazabilidad entre cobro tarjeta y factura Holded

Con la integración

  • Conciliación al céntimo en tiempo real
  • Cada FUC con su serie y reporting separado
  • Rectificativas automáticas tras devolución TPV
  • Trazabilidad firmada Redsys ↔ factura para auditoría
Arquitectura

Cómo lo construimos

Configuramos la URL de notificación firmada de Redsys hacia nuestro endpoint. Verificamos la firma HMAC SHA-256 con tu clave secreta antes de procesar nada (evita spoofing). El payload se cruza con el pedido o factura Holded por Ds_Order (que mapeamos a tu identificador de factura). Idempotencia con Ds_AuthorisationCode + Ds_Order. Si trabajas con varios FUC (TPV de varios bancos), cada uno tiene su propia clave y endpoint. Toda la trazabilidad firmada queda guardada para auditoría.

flow.ts
webhook redsys.event
queue.enqueue(jobId)
worker.handle() // idempotente
holded.api.call() // retries con backoff
log.emit({ status: 'ok' })
FAQ

Preguntas frecuentes

¿Aplica a TPV físico también?

Sí, mientras el TPV reporte vía Redsys (la mayoría en España lo hacen). Los lotes diarios del TPV físico se cuadran con los pedidos del día en Holded automáticamente.

¿Funciona con cualquier banco?

Sí, con cualquier banco que use Redsys como procesador (BBVA, Sabadell, CaixaBank, Santander, Bankinter, Abanca, Unicaja, Kutxabank, Cajamar, Ibercaja, etc.). La integración es a Redsys, no al banco directo.

¿Verificáis la firma de las notificaciones?

Imprescindible. Verificamos HMAC SHA-256 con tu clave secreta antes de procesar. Sin firma válida, descartamos. Eso evita que un atacante pueda 'inyectar' cobros falsos.

¿Suscripciones con tokens Redsys?

Sí. Los tokens permanentes de Redsys (sin almacenar PAN, que iría contra PCI) permiten cobros recurrentes. Cada exitoso genera factura recurrente en Holded; fallidos disparan dunning.

¿Y el extracto bancario para conciliar?

Si tienes los apuntes bancarios sincronizados con Holded (cualquier banco PSD2), hacemos el matching Redsys ↔ apunte bancario automáticamente. Eso cierra el círculo conciliación-tarjeta-extracto.

¿Cuánto tarda?

Entre 4 y 7 días para un único FUC. Multi-banco con varios FUC añade 2-3 días.

Francodesystems

¿Hablamos de tu integración con Redsys?

Llamada de 30 minutos sin compromiso. Salimos con alcance y precio.