by Piensa ITIdempotencia y reintentos
Envía la cabecera Idempotency-Key para que un reintento nunca envíe un mensaje dos veces, y conoce cómo reintenta Deliver.
Clave de idempotencia
Envía la cabecera Idempotency-Key (o el campo idempotencyKey), de hasta 128 caracteres, con un identificador del envío en tu sistema: por ejemplo midivisa:factura:SETP990000123.
Si ya existe un mensaje con esa clave, POST /v1/messages responde 200 con el mismo mensaje y no lo reenvía. Un mensaje nuevo responde 202.
Usa una clave con sentido en tu sistema
Un número de factura o el id de un evento sirve más que un valor aleatorio: si tu proceso se reinicia, vuelve a generar la misma clave.
Reintentos de tu lado
Reintenta los errores temporales (500, 503 y, cuando se apliquen límites de envío, 429) o las fallas de red con esperas crecientes y la misma clave de idempotencia. No reintentes los demás 4xx: no van a cambiar. Ver Errores.
Reintentos de Deliver
Una vez aceptado un mensaje, si el envío falla de forma temporal Deliver reintenta a los 1, 5, 15 y 60 minutos. Si el último intento falla, el mensaje queda en estado failed. Consulta el resultado con GET /v1/messages/{id}.