Errores

Conoce cómo identificar y resolver los posibles errores al generar una Devolución de Efectivo.

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 detailsen 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.