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.

Atributo

Tipo

Descripción

type

string

El tipo de error retornado.

Uno de authentication_error, invalid_request_error, charge_error, idempotency_error, rate_limit_error, api_error.

code

string

Un código corto indicando el error específico. Usualmente disponible en errores que pueden manejarse programáticamente.

messages

array

Un listado de mensajes con detalles sobre el error.

Ejemplo

{
  "type": "charge_error",
  "code": "card_limit_exceeded"
}

Tipos de errores

Tipo	Descripción
`authentication_error`	No te estás autenticando correctamente. Asegúrate de revisar tu API Key.
`invalid_request_error`	Tu solicitud contiene parámetros incorrectos.
`charge_error`	Tu 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_error`	Tu solicitud incluye la cabecera `X-Idempotency` y está siendo reutilizada incorrectamente.
`rate_limit_error`	Estás realizando muchas solicitudes muy rápido.
`api_error`	Ocurrió 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.