Errores y solución de problemas
Referencia rápida de los códigos de error HTTP que puede recibir y cómo resolverlos.
Errores de cliente (4xx)
400 Bad Request
La solicitud tiene un formato inválido o faltan parámetros requeridos.
Casos comunes: omitir include
en el detalle, omitir nombre y
ruc en la búsqueda, o enviar
un código de producto inválido.
401 Unauthorized
No se envió el header
Authorization: Bearer pk_....
Solución: Envíe su llave API como Bearer token en cada solicitud.
402 Payment Required
No tiene saldo prepago suficiente para completar la solicitud.
Solución: Recargue saldo desde su panel.
403 Forbidden
La llave fue rechazada por la capa de autenticación.
Solución: Verifique que está usando una llave activa generada en su cuenta y que la copió completa.
404 Not Found
La entidad con el ID proporcionado no existe.
Solución: Verifique el id usando el endpoint de búsqueda.
Errores de servidor (5xx)
500 Internal Server Error
Error interno del servidor. Si persiste, contáctenos. Estas solicitudes no se cobran.
503 Service Unavailable
El servicio está temporalmente fuera de línea. Reintente en unos minutos.
Anterior: ← Sandbox vs API