VALIDATA Developers

API

Errores

Todos los errores usan channel.error.v1:

{
  "schema_version": "channel.error.v1",
  "error": { "code": "IDEMPOTENCY_CONFLICT", "retry_class": "DO_NOT_RETRY" },
  "correlation_ref": "cor_…"
}

field aparece cuando el error apunta a un campo concreto (order.total, por ejemplo). Guarda correlation_ref para soporte. Nunca se devuelven datos de otros comercios ni detalles internos.

retry_class#

ClaseQué hacer
DO_NOT_RETRYNo reintentes sin cambiar la solicitud.
RETRY_SAME_KEYReintenta con la misma Idempotency-Key y el mismo cuerpo.
RETRY_AFTEREspera Retry-After segundos.
POLL_READBACK_ONLYConsulta el readback; no reenvíes.

Códigos#

HTTPCódigoReintento
400INVALID_REQUESTDO_NOT_RETRY
400UNKNOWN_FIELDDO_NOT_RETRY
400FORBIDDEN_FIELDDO_NOT_RETRY
400IDEMPOTENCY_KEY_REQUIREDDO_NOT_RETRY
400MALFORMED_HEADERDO_NOT_RETRY
401INVALID_CREDENTIALSDO_NOT_RETRY
401SIGNATURE_INVALIDDO_NOT_RETRY
401TIMESTAMP_OUT_OF_WINDOWDO_NOT_RETRY
403INTEGRATION_REVOKEDDO_NOT_RETRY
403INSUFFICIENT_SCOPEDO_NOT_RETRY
403CHANNEL_NOT_ENABLEDDO_NOT_RETRY
404RESOURCE_NOT_FOUNDDO_NOT_RETRY
405METHOD_NOT_ALLOWEDDO_NOT_RETRY
409IDEMPOTENCY_CONFLICTDO_NOT_RETRY
409OPERATION_PENDINGPOLL_READBACK_ONLY
413PAYLOAD_TOO_LARGEDO_NOT_RETRY
415UNSUPPORTED_MEDIA_TYPEDO_NOT_RETRY
423VALIDATIONS_EXHAUSTEDDO_NOT_RETRY
429RATE_LIMITEDRETRY_AFTER
503SERVICE_UNAVAILABLERETRY_SAME_KEY

503 incluye plazo vencido, fallas de dependencias y estados que el servicio no puede decidir con seguridad. No consume cupo.

CHANNEL_NOT_ENABLED también se devuelve cuando el comercio todavía no está habilitado en la modalidad que usas (ver canales).