Errores

Por medio de nuestra Direct API, podrás ser notificado con toda la información en caso de cualquier error al momento de crear cualquier solicitud de Devolución en Efectivo.

{
    "details": [
        {
            "debug_message": "The \"allowed_payout_methods\" is missing.",
            "message": "El parametro \"allowed_payout_methods\" es requerido.",
            "param": "allowed_payout_methods",
            "code": "conekta.errors.parameter_validation.allowed_payout_methods.missing"
        }
    ],
    "object": "error",
    "type": "parameter_validation_error",
    "log_id": "6334dc60cae77f0001abe0c0"
}

Parámetros

Parámetro	Descripción	Tipo
type	Contiene el tipo de error y el código del error.	string
log_id	El id del log de la petición http está registrado en este error.	string
details	Lista detallada de los errores.	array
message	Mensaje 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.	string
debug_message	Mensaje 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.	string
code	Un código corto y específico detallando processing_error.	string
params	El parámetro al cual este error está relacionado. Puedes usar este error para subrayar campos de texto erróneos.	string

Descripción de errores

Tipo	HTTP Code	Descripción
api_error	500	Error inesperado por parte de Conekta.
authentication_error	401	La llave usada en esta petición era inválida o no tiene permisos para ejecutar esta petición.
conflict_error	409	Se genera por un conflicto de versiones, lo más probable es que la versión que se envía en los encabezados de la petición sea incorrecta.
malformed_request_error	400	El JSON del cuerpo de la petición era inválida o la codificación de caracteres en la petición es incorrecta.
parameter_validation_error	422	Algún parámetro de la petición falta o tiene valores inválidos, consulta el atributo details en la petición para ver cuáles campos fueron inválidos y por qué.
processing_error	402	Se genera cuando existe un error en el proceso de retiro, puede ser por falta de balance o error de comunicación interna.
resource_not_found_error	404	El valor a ejecutar en la petición no existe. Ocurre normalmente cuando las llaves de la petición corresponden a otra cuenta o no tienen permisos para buscar este objeto.

Errores de tipo: processing_error

Existen casos especiales en los que un tipo de error puede tener diferentes descripciones de error, el detalle se puede encontrar dentro del parámetro message ó debug_message.

Mensaje	Descripción
Hubo un problema al procesar la petición. ("Cannot create balance retention")	No tiene saldo suficiente para realizar una referencia de devolución.
Hubo un problema al procesar la petición. (El monto no puede contener decimales. Vuelve a intentar la operación con un monto cerrado.)	No se puede realizar una devolución con decimales
El monto a reembolsar debe ser menor o igual al monto disponible para reembolso del cargo. ("The amount to be refunded must be less than or equal to the available refund amount for the charge.")	El monto de la devolución que se desea generar sumado de las devoluciones cobradas por el cliente, más las pendientes de cobro superan el monto del cargo
No es posible hacer una devolución por un pago efectuado hace más de 90 días. ("The refund cannot be performed because the charge was paid 90 days ago")	El cargo tiene más de 90 días de haberse pagado
Las devoluciones en efectivo están deshabilitadas para esta compañía. ("Cash refunds are disabled for this company.")	No tiene el producto habilitado
El monto a reembolsar debe ser mayor o igual a $3000 MXN. ("The amount to be refunded must be greater than or equal to $3000 MXN.")	El monto de la devolución no supera el mínimo ($30 MXN).
El monto a reembolsar debe ser menor o igual al monto del cargo. ("The amount to be refunded must be less than or equal to the amount of the charge.")	El monto de la devolución supera el monto del cargo (Ej. $500.00 MXN).
El monto a reembolsar debe ser menor o igual a $300000 MXN. ("The amount to be refunded must be less than or equal to $300000 MXN.")	El monto de la devolución supera el máximo ($3,000.00 MXN).
El estado del cargo no es reembolsable.("The charge status is not refundable.")	El cargo no se encuentra en estado pagado.