Introducción
Cómo funciona la validación COD
El recorrido de una validación#
- Autenticación. Tu credencial identifica a qué comercio, tienda e integración pertenece la llamada. Ver Autenticación.
- Idempotencia. Cada pedido lleva una
Idempotency-Key: reintentar no cobra ni decide dos veces. - Cupo. Antes de evaluar se comprueba que el comercio tenga validaciones disponibles. Ver Cuotas.
- Evaluación. Se combinan la Huella del comprador, la regla COD de pago y flete y la política del comercio.
- Respuesta. Recibes la decisión original, la política aplicada y la acción siguiente.
- Consumo. Solo una decisión real consume una validación.
Un teléfono que no se puede normalizar no consume cupo: la respuesta es status: INVALID_PHONE y next_action: ASK_VALID_PHONE.
Si algo falla#
El servicio falla cerrado: si no puede decidir con seguridad, responde un error (por ejemplo 503) en lugar de inventar una decisión, y no consume cupo. La clase de reintento de cada error está en Errores.