INVALID_REQUEST | 400 | El body, un parámetro o una cabecera no cumplen el contrato. | Corregí el request; el campo afectado se describe en message. | No |
CALLBACK_NOT_ALLOWED | 400 | La callbackUrl no está habilitada para tu integración. | Usá la URL exacta que registraste con Orbital, u omití el campo. | No |
UNAUTHORIZED | 401 | Credencial ausente, inválida, revocada o de otro ambiente. | Verificá la cabecera Authorization y que uses la credencial de staging. | No |
FORBIDDEN | 403 | Tu credencial no tiene el scope que exige el endpoint. | Pedí a Orbital que habilite el scope necesario. | No |
SOURCE_ACCOUNT_FORBIDDEN | 403 | La cuenta de origen no está autorizada para tu credencial. | Enviá el ID de la cuenta de tu empresa que recibiste con tu credencial. | No |
NOT_FOUND | 404 | El lote o cash in no existe para tu credencial. | Revisá el id o externalId consultado. | No |
SOURCE_ACCOUNT_NOT_FOUND | 404 | La cuenta de origen no está disponible. | Confirmá el ID de tu cuenta con Orbital. | No |
IDEMPOTENCY_CONFLICT | 409 | Reutilizaste una Idempotency-Key con un body distinto. | Para reintentar, enviá exactamente el mismo body. Para un lote nuevo, usá una clave nueva. | No |
DUPLICATE_EXTERNAL_ID | 409 | Ese externalId ya fue usado: en un lote, con otra clave; en un cash in, con otros datos. | Consultá el existente con GET /disbursements?externalId=… o GET /cash-ins?externalId=… | No |
CASH_IN_ALREADY_PENDING | 409 | Ya tenés un cash in pendiente con el mismo banco, últimos cuatro dígitos, CI o RUC y monto. message indica su externalId. | Esperá a que ese cash in quede CREDITED o REJECTED antes de declarar otro igual, o consultalo con GET /cash-ins?externalId=… | No |
DUPLICATE_PAYMENT_REFERENCE | 409 | El externalId de un pago ya existe, incluso en otro lote. | Asigná referencias de pago únicas. | No |
ACCOUNT_BLOCKED | 409 | La cuenta de tu empresa está bloqueada para nuevos lotes y cash in. | Contactá a Orbital. | No |
MANDATE_LIMIT_EXCEEDED | 409 | El lote supera el monto máximo acordado para tu integración. | Dividí los pagos en lotes más chicos. | No |
SNAPSHOT_CHANGED | 409 | El lote cambió mientras paginabas sus pagos. | Volvé a pedir la primera página sin cursor. | Sí |
PAYLOAD_TOO_LARGE | 413 | El body supera 1 MiB (4 KiB en consulta de alias y cash in). | Reducí el tamaño o la cantidad de pagos. | No |
INSUFFICIENT_OPERATING_BALANCE | 422 | El saldo disponible no cubre el lote completo. No se reservó nada. | Consultá /account y cargá saldo desde el portal empresarial antes de reintentar. | No |
ALIAS_LOOKUP_REJECTED | 422 | El banco no pudo resolver el alias. | No implica que el alias no exista; verificá el valor con el destinatario. | No |
RATE_LIMITED | 429 | Demasiadas solicitudes. | Esperá lo indicado en Retry-After. | Sí |
INTERNAL_ERROR | 500 | Fallo interno con resultado incierto. | Buscá el lote por externalId o repetí el mismo request con la misma clave. | Sí |
SERVICE_UNAVAILABLE | 503 | Servicio no disponible temporalmente. | Reintentá con espera creciente. No asumas saldo cero. | Sí |
ELIGIBILITY_UNAVAILABLE | 503 | No se pudo verificar la elegibilidad del destinatario. No se reservó nada. | Reintentá con espera creciente y el mismo request. | Sí |
CALLBACK_UNAVAILABLE | 503 | Los callbacks todavía no están habilitados para tu integración. | Coordiná la habilitación con Orbital u omití callbackUrl. | No |
ALIAS_LOOKUP_UNAVAILABLE | 503 | La consulta de alias no está disponible temporalmente. | Reintentá más tarde. | Sí |