Errores

Todos los errores de la API de Cashela responden success: false con un message legible. Los errores de validación (422) añaden errors, que asocia cada campo no válido con sus mensajes; los errores de dominio pueden añadir un code estable.

{
  "success": false,
  "message": "Unauthorized."
}

Comunes a todos los productos

HTTP	Mensaje	Qué hacer
401	Unauthorized.	Revisa la clave y su estado en el Portal de Desarrolladores. Faltan credenciales o son incorrectas, son del otro entorno, o la clave está deshabilitada, revocada o vencida.
403	IP address is not allowed.	La clave tiene lista blanca de IPs y la petición llegó desde otra dirección.
403	Insufficient permissions.	La clave no puede usar ese endpoint. Contacta con soporte.
422	Mensajes por campo en errors	Corrige los campos. No se creó nada.
429	—	Espera los segundos de Retry-After y reintenta con espera progresiva.
500 / 503	—	Reintenta más tarde. Si persiste, contacta con soporte con tu X-Trace-Id.

Por producto

• Pay-In: formato completo, estados HTTP y todos los códigos en Errores de Pay-In.
• Pay-Out: ver la guía de Pay-Out.

Lee code cuando venga, pero no dependas de él. Registra siempre el X-Trace-Id que enviaste junto con la respuesta.