Por el equipo VIXI · Revisado el
Por dónde empezar
Confirma que los dos registros representan la misma transacción antes de llamarlos duplicados. Después sigue cada sistema que puede enviar esa venta a HYROS. El solapamiento entre checkout y procesador, los reintentos y los distintos eventos de un mismo pago necesitan correcciones diferentes.
Cada síntoma necesita una comprobación distinta
| Qué observas | Qué investigar | Evidencia que comparar |
|---|---|---|
| Dos ventas HYROS para un pedido pagado | Integraciones superpuestas de checkout, procesador o desarrollo propio. | Transacción, importe, hora y recorrido de entrega de ambos registros. |
| Registros adicionales al reintentar un flujo | Si el primer intento sí llegó al destino. | Ejecución del flujo, respuesta y venta existente en HYROS. |
| El evento de factura y el de pago crean ventas | Si dos tipos de evento describen el mismo pago. | La transacción comercial y el mapeo de cada tipo de evento. |
| El mismo cliente vuelve a comprar | Una renovación, parcialidad o compra independiente legítima. | Identificadores distintos y reglas acordadas de suscripción. |
1. Confirma la duplicación con una transacción
Empieza por un pedido pagado y localiza los registros que parecen repetirlo. Relaciona la transacción de origen con cada registro de destino. Un email idéntico, una hora cercana o un importe repetido son pistas, pero no bastan para demostrar duplicación.
Una renovación o parcialidad puede pertenecer al mismo cliente y ser una venta nueva legítima. Registra estos casos por separado para que la corrección no suprima ingresos futuros. Guarda identificadores y capturas en el registro privado de la auditoría.
2. Mapea todos los sistemas que envían la venta
Lista las conexiones del checkout y procesador, los flujos API, las importaciones manuales y cualquier otro emisor del setup real. Documenta el disparador, evento comercial, destino y responsable de cada uno.
La guía de Stripe de HYROS advierte que conectar tanto el checkout como su procesador puede duplicar ventas. Comprueba si ambos recorridos envían ese mismo pago antes de modificar alguna conexión.
Elige la fuente prevista junto con el equipo responsable. Revisa qué productos y métodos de pago cubre. Quitar una conexión sin ese inventario puede interrumpir eventos válidos que solo pasan por ella.
Referencia: HYROS: Stripe y fuentes de pago superpuestas ↗
3. Revisa los reintentos de webhooks y n8n
Stripe documenta que un evento webhook puede llegar más de una vez. Recomienda registrar los IDs procesados; cuando eventos separados describen el mismo objeto y tipo de evento, también se comparan esos campos. Esto describe el manejo de webhooks y no garantiza que todas las integraciones HYROS apliquen la misma deduplicación.
En un flujo personalizado, documenta cómo una transacción comercial corresponde a una venta prevista. El ID de entrega identifica un mensaje; el del pedido o pago identifica un objeto del negocio. Define la regla de deduplicación según la venta y preserva los pagos recurrentes legítimos.
Un timeout no demuestra que HYROS haya rechazado la solicitud. Revisa el destino antes de repetir el flujo. En código propio, utiliza el comportamiento de reintentos documentado por el destino y un registro persistente cuando haga falta; no dependas de recordar qué ejecuciones se repitieron.
Referencia: Stripe: manejo de eventos webhook duplicados ↗
4. Verifica la corrección y separa la limpieza histórica
Define la prueba y cómo revertir el cambio antes de editar la integración activa. Usa el entorno de pruebas compatible cuando exista, o una transacción expresamente autorizada. Registra qué configuración cambió y cuándo.
Detener el emisor adicional no demuestra que se hayan corregido registros duplicados anteriores. Confirma los registros afectados y el método de corrección compatible con el responsable de la cuenta o soporte HYROS antes de editar ventas históricas. Conserva un registro de cada corrección.
- Un pago nuevo autorizado produce una sola venta prevista.
- Un reintento controlado del mismo evento no añade otra venta.
- Una renovación o segunda compra distinta sigue apareciendo.
- El importe, moneda y relación con la transacción permanecen correctos.
Preguntas frecuentes
¿Puedo deduplicar por email del cliente?
El email no identifica una transacción. Un cliente puede realizar varias compras, parcialidades o renovaciones. Usa la transacción real y el comportamiento documentado de la integración.
¿Corregir duplicados en Meta también corrige las ventas HYROS?
Son destinos distintos. Comprueba los registros y la deduplicación en cada uno; una prueba correcta en un destino no demuestra que el otro esté bien.
¿Desactivar una integración elimina duplicados anteriores?
No lo des por hecho. Verifica primero la entrega de eventos nuevos y después revisa la corrección histórica como una tarea separada, autorizada y documentada.
REVISA TU CONFIGURACIÓN
Convierte la duda en un próximo paso claro.
Comparte tu web o funnel y el problema que observas. El equipo enviará tu reporte inicial gratuito por email en 24 horas. Identificamos qué se pudo comprobar y qué requiere evidencia adicional.
Pedir mi reporte HYROS gratuitoLa auditoría profunda de $499 USD y la implementación tienen un alcance separado. VIXI es una agencia independiente especializada en HYROS.