Errores y códigos

Formato de error

Todos los errores usan el mismo sobre:

{
  "error": true,
  "message": "Saldo insuficiente",
  "data": [],
  "results": 0
}

Código	Significado	¿Reintentar?
`200`	Operación exitosa.	—
`400`	Datos inválidos, saldo insuficiente o venta rechazada por el proveedor.	Solo con datos corregidos (en ventas, con folio nuevo).
`401`	Falta la API Key o es inválida, revocada o expirada.	No, hasta corregir la clave.
`403`	La clave no tiene permiso, o la organización, línea, producto o canal API no están habilitados.	No, hasta que se habilite.
`404`	Recurso no encontrado (por ejemplo, folio inexistente).	—
`409`	Conflicto: folio ya utilizado.	No; consulta el folio.
`429`	Límite de peticiones excedido.	Sí, después de esperar.
`500`	Error interno.	En ventas, consulta el folio primero.
`502`	El proveedor no confirmó el resultado de la venta.	No; consulta el folio.
`503`	Producto, monto o proveedor no disponible en este momento.	Sí, más tarde o con otro monto.

Alcance	Límite	Ventana	Se cuenta por	`message` al exceder
Toda la API (`/api/v1/*`)	500	1 minuto	IP de origen	`Rate-limit superado, debe esperar`
`POST /tae/do-transaction`	1000	1 minuto	Organización	`Demasiadas transacciones en poco tiempo, intenta de nuevo en un momento`

Cada respuesta incluye los encabezados estándar (IETF draft-7):

RateLimit-Policy: 500;w=60
RateLimit: limit=500, remaining=0, reset=17

El campo code de una venta (en Realizar venta y en Consultar transacción) usa códigos normalizados por Orion, independientes del proveedor:

`code`	Estado	¿Se cobró?
`00`	Exitosa.	Sí
`04`	Rechazada por el proveedor.	No
`25`	En proceso o pendiente de conciliación.	Saldo apartado hasta resolverse

Al reportar un problema, incluye siempre: