Pagos y fidelización · Guía práctica
Webhooks de pago repetidos: procesar una operación una sola vez
Diseña el receptor para reconocer eventos ya procesados y separar recepción de ejecución.
Retrospectiva editorial de 2024. Criterios y prácticas compatibles con el contexto tecnológico de ese período. Ver el archivo ↗
La respuesta breve
Diseña el receptor para reconocer eventos ya procesados y separar recepción de ejecución. Un proveedor puede volver a enviar una notificación. El resultado comercial debe mantenerse único aunque el mensaje llegue varias veces o el servicio se reinicie.
El problema en la operación
Confirmar pago puede disparar preparación, correo y otros procesos. Sin control de duplicidad, una notificación repetida multiplica acciones aunque el proveedor solo haya registrado una transacción.
Tres decisiones para resolverlo
- Verifica autenticidad según el proveedor y conserva identificadores del evento y operación.
- Registra recepción antes de ejecutar efectos que necesitan recuperación.
- Diseña cada efecto para reconocer trabajo previo y permitir reintentos seguros.
El error que conviene evitar
No uses únicamente el estado del navegador para confirmar pagos. El flujo autorizado del proveedor debe sostener el cambio de estado y su conciliación.
Cómo comprobar que quedó resuelto
Envía el mismo evento de prueba varias veces y simula interrupción después de recibirlo. Debe existir un solo efecto comercial y evidencia del procesamiento.
Preguntas frecuentes
¿Los eventos siempre llegan en orden?
No debes asumirlo. Revisa las garantías del proveedor y valida el estado de la operación cuando el orden o la información recibida sean insuficientes.
Fuentes para profundizar
Documentación de consulta. Las condiciones de los proveedores pueden cambiar.