Nuestra API utiliza códigos de respuestas HTTP standard para indicar el éxito o fallo de una solicitud.

Códigos en el rango 2xx se consideran exitosos. Códigos en el rango 4xx indican un error en la información provista, tal como un parámetro faltante. Códigos en el rango 5xx indican un error de servidor.

Algunos errores 4xx incluyen un código de error indicando que ocurre con la solicitud.

El objeto error

Cada respuesta fallida de parte de nuestra API responderá con un objeto error, el que te ayudará a entender mejor que ocurrió con la solicitud.

AtributoTipoDescripción
typestringEl tipo de error retornado.

Uno de authentication_error, invalid_request_error, charge_error, idempotency_error, rate_limit_error, api_error.
codestringUn código corto indicando el error específico. Usualmente disponible en errores que pueden manejarse programáticamente.
messagesarrayUn listado de mensajes con detalles sobre el error.

Tipos de errores

TipoDescripción
authentication_errorNo te estás autenticando correctamente. Asegúrate de revisar tu API Key.
invalid_request_errorTu solicitud contiene parámetros incorrectos.
charge_errorTu solicitud fue rechazada por problemas en el pago. Usualmente contiene detalles de motivo, por ejemplo la falta de fondos en el método de pago.
idempotency_errorTu solicitud incluye la cabecera X-Idempotecy y está siendo reutilizada incorrectamente.
rate_limit_errorEstás realizando muchas solicitudes muy rápido.
api_errorOcurrió un error temporal de servidor. Estos errores son poco comunes y tratamos de mantenerlos al mínimo, pero si te encuentras con uno debieras reintentar enviar la solicitud.