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