Implementación de Suscripciones en TuTiendaWeb: Gestión de Estados y Pagos
Integrar un sistema de pagos recurrentes es uno de los hitos más desafiantes para cualquier plataforma de comercio electrónico. Recientemente, en el proyecto TuTiendaWeb, nos enfrentamos a la necesidad de gestionar suscripciones mediante la API de Mercado Pago, enfocándonos en la trazabilidad de los pagos y la robustez del ciclo de vida del usuario.
El Desafío de los Estados
El problema principal no era solo procesar un cargo, sino mantener una sincronización precisa entre el estado de la suscripción en nuestra base de datos y la realidad del proveedor de pagos. Un error en la confirmación o un webhook perdido podía dejar a un usuario con acceso limitado sin causa justificada.
La Solución: Máquina de Estados
Para resolver esto, implementamos un patrón de máquina de estados. En lugar de cambiar banderas booleanas dispersas por el código, consolidamos la lógica en transiciones explícitas. Esto asegura que el sistema siempre sepa si una suscripción está pending, active o cancelled.
type PaymentStatus = 'pending' | 'active' | 'cancelled';
interface SubscriptionState {
status: PaymentStatus;
updatedAt: string;
}
// Ejemplo de transición controlada
function transition(current: PaymentStatus, action: string): PaymentStatus {
switch (action) {
case 'CONFIRM':
return current === 'pending' ? 'active' : current;
case 'CANCEL':
return 'cancelled';
default:
return current;
}
}
Gestión de Webhooks
La comunicación con servicios externos como Mercado Pago requiere ser defensiva. Aprendimos que confiar ciegamente en el payload del webhook es peligroso. Ajustamos nuestra lógica para validar estrictamente los identificadores provenientes de los parámetros de consulta, evitando procesar notificaciones duplicadas o malintencionadas mediante una verificación de firmas rigurosa.
Aprendizajes Clave
- Atomicidad: Cada confirmación de suscripción debe ser una transacción atómica. Si falla la base de datos, no confirmamos el pago.
- Observabilidad: Implementar estados claros permite que el equipo de soporte identifique rápidamente por qué un usuario no tiene acceso.
- Desacoplamiento: Al utilizar una arquitectura que separa la lógica de negocio de la integración externa, logramos que el módulo de cancelación sea independiente y fácil de mantener.
La estabilidad de nuestra plataforma creció significativamente al tratar las suscripciones no como simples registros, sino como entidades vivas que requieren una gestión de estados robusta.
Generated with Gitvlg.com
