Errores

Por medio de nuestro API, podrás ser notificado con toda la información en caso de cualquier error al momento de crear cualquier llamada a nuestro servicio.

Objeto Error

Atributos

TipoDescripción
typearrayContiene el tipo de error y el código del error.
log_idstringEl id del log de la petición http registrando este error.
datahashEl objeto modificado por esta petición, en caso de processing_error por ejemplo, los cargos todavía se crean.
detailsarrayLista detallada de los errores.
messagestringMensaje legible para humanos el cual provee más detalles sobre el error. Este mensaje debe ser desplegado al usuario y está disponible en inglés y español. Para cargos de tarjeta, el mensaje puede ser mostrado al usuario.
debug_messagestringMensaje legible para humanos el cual provee más detalles sobre el error. Este mensaje debe ser usado internamente para depuración y solo está disponible en inglés. Para cargos de tarjeta, el mensaje puede ser mostrado al usuario.
codestring (optional)Un código corto y específico detallando processing_error.
paramsstring (optional)El parámetro al cual este error está relacionado. Puedes usar este error para subrayar campos de texto erróneos.
begin
  order = Conekta::Order.create(order_data_with_charges.
          merge(customer_info: customer_info))
rescue Conekta::Error => error
  for error_detail in error.details do
    puts error_detail.message
  end
end

Error Types

TipoDescripción
api_errorHTTP 500Error inesperado por parte de Conekta. Este error puede ser capturado con la clase ApiError.
authentication_errorHTTP 401La llave usado en esta petición era inválida or no tiene permisos para ejecutar esta petición. Este error puede ser capturado con la clase AuthenticationError.
conlict_errorHTTP 409Un conflict de versiones ocurrió, lo más probable es que la versión que pasaste en las encabezados de la petición era incorrecta.
malformed_request_errorHTTP 400El JSON del cuerpo de tu petición era inválida o la codificación de caracteres en tu petición es incorrecta. Este error puede ser capturado con la clase MalFormedRequestError .
parameter_validation_errorHTTP 422Algun parámetro de tu petición falta o tiene valores inválidos, consulta el atributo details en tu petición para ver cuales campos fueron inválidos y por qué. Este error puede ser capturado con la clase ParameterValidationError .
precondition_required_errorHTTP 412Falta ejecutar algunos pasos antes de procesar esta llamada. Por ejemplo, si estas creando un order, la suma de los line_items tiene que estar mayor a 0 antes de cobrarle, consulta el atributo details en tu petición para ver cuales campos fueron inválidos y por qué.
processing_errorHTTP 402Un error rutinario durante el procesamiento de tarjetas, ocurre cuando procesen tarjetas y los fondos no pueden ser cobrados. Este error puede ser capturado con la clase ProcessingError .
resource_not_found_errorHTTP 404El objecto sobre cual quisieras ejecutar este petición no existe. Ocurre normalmente cuando las llaves de la petición corresponden a otra cuenta o no tienen permisos para buscar este objecto. Este error puede ser capturado con la clase ResourceNotFoundError .

📘

Nota

La descripción de los códigos es general. Cada una de las entidades (Charges, Companies, Customers, etc.) descritas en esta API Reference, contiene el response (Código JSON) devuelto para cada error correspondiente. Ingresa a la sección de cada entidad para consultarlos.

Métodos

TipoDescripción
getConektaMessage()objectEste metodo nos proporciona un arreglo con el objeto que regresa la api cuando se genera un error, Este objeto contiene todos los atributos mencionados antes, todos los objetos estan mapeados en las posiciones del arreglo, estas posiciones estan compuestas por dos arreglos principales que son detailscon errores de validacion y un segundo type con el codigo de error y el tipo de error.

Clases

TipoDescripción
HandlerExceptionLa clase Handler maneja y crea instancias de los errores mapeados en base a la respuesta de la api.