Webhooks y eventos
Contratos de eventos entrantes y de entrega, reintentos e idempotencia, no solo la higiene de las claves API.
Orden de eventos frente a registro en libro mayor
Los eventos DLR y MO fuera de orden no deben romper las reglas de débito prepago; la secuencia de llegada no es la ley del dinero.
Operaciones de consumo de webhooks a escala
Colas, retroceso exponencial y propiedad de DLQ cuando la tasa de eventos de webhook supera la fase piloto: un producto de ritmo de consumo que finanzas y producto pueden abrir sin depender de héroes.
Un webhook duplicado no debe crear un segundo débito
Ruta de fallo: los reintentos y repeticiones se mantienen idempotentes en el dinero prepago y la bandeja de entrada: un ID de evento, una fila de débito, una línea de bandeja.
Puerta de firma y ventana de reintento
Puerta de producción: verifica la firma y delimita la ventana de reintento antes de que cualquier webhook se convierta en dinero o verdad de estado; los eventos sin firma o caducados fallan de forma segura.
Contrato de webhook antes del primer envío
Ruta del comprador: acuerde la URL firmada, los tipos de evento y la clave de idempotencia antes del primer envío prepagado.