Inicio
Documentación
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Posibles errores - Status y errores - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Posibles errores

Consulta la lista de posibles errores devueltos por la API y cómo corregirlos.

Tipo de ErrorStatusCódigoDescripción y soluciones posibles
Error de solicitud400json_syntax_errorAsegúrate de que la solicitud tenga una estructura JSON válida, con claves y valores adecuados.
Error de solicitud400required_propertiesAlgunas propiedades obligatorias están ausentes. Verifica la solicitud y asegúrate de incluir todas las propiedades requeridas según la documentación de la API.
Error de solicitud400unsupported_propertiesAlgunas propiedades informadas no son soportadas por la API. Revisa la solicitud y elimina o corrige las propiedades no soportadas.
Error de solicitud400minimum_propertiesNo se ha cumplido el número mínimo de propiedades requeridas. Agrega las propiedades necesarias para completar la solicitud.
Error de solicitud400property_typeEl tipo de la propiedad informada es inválido. Asegúrate de que el valor enviado en la solicitud corresponda al tipo esperado.
Error de solicitud400property_valueEl valor de la propiedad informada es inválido. Verifica el valor enviado y haz los ajustes para que corresponda a los valores permitidos.
Error de solicitud400maximum_itemsSe ha excedido el número máximo de ítems permitidos. Reduce la cantidad de ítems enviados para que no sobrepase el máximo permitido.
Error de solicitud400minimum_itemsNo se ha cumplido el número mínimo de ítems requerido. Agrega más ítems a la solicitud para cumplir con los requisitos de la API.
Error de solicitud400invalid_path_paramVerifica si el ID proporcionado como parámetro es válido.
Error de solicitud400invalid_propertiesAlgunas propiedades informadas son inválidas o están mal formadas. Revisa las propiedades enviadas y verifica si están de acuerdo con las especificaciones de la API.
Error de solicitud400empty_required_headerUno o más headers obligatorios están vacíos. Verifica la solicitud y asegúrate de que todos los headers requeridos están presentes y debidamente completados.
Error de solicitud400order_builder_without_transactionsNo hay una transacción asociada a la order. Asegúrate de incluir al menos una transacción para la creación de la order.
Error de solicitud400invalid_order_mode_for_operationEl modo informado no es válido para esta operación. Verifica si estás utilizando el modo correcto según la operación deseada.
Error de solicitud400invalid_order_typeEl tipo de la order es inválido. Verifica si el tipo utilizado es válido para la operación.
Error de solicitud400invalid_transaction_idEl ID de la transacción es inválido. Asegúrate de que el ID es correcto.
Error de solicitud400exceeded_number_of_transactionsOcurrió un error en la solicitud. La order acepta un máximo de dos transacciones. Elimine las transacciones excedentes.
Error de solicitud400invalid_email_for_sandboxEl formato de correo electrónico no es válido para el entorno de sandbox, debe contener "@testuser.com".
Error de procesamiento402failedHubo un error en el procesamiento de alguna de las transacciones. Verifica el mensaje devuelto para más información.
Error de solicitud404order_not_foundLa order no fue encontrada. Verifica si el ID informado es correcto.
Error de solicitud404transaction_not_foundLa transacción no fue encontrada. Verifica si el ID informado es correcto.
Error de solicitud409cannot_refund_orderAsegúrate de que la order esté en un estado que permita la realización de un reembolso.
Error de solicitud409cannot_capture_orderVerifica si el estado de la order permite la captura y que esta haya sido creada con el campo processing_mode definido como "automatic".
Error de solicitud409cannot_cancel_orderAsegúrate de que la order esté en un estado que permita su cancelación.
Error de solicitud409already_queued_order_for_deviceYa existe una order en espera para el dispositivo informado. No es posible crear una nueva order del tipo "point" mientras una anterior está pendiente de ser procesada. Espera el procesamiento de la order actual antes de intentar nuevamente.
Error de Idempotencia409idempotency_key_already_usedLa clave X-Idempotency-Key proporcionada ya ha sido utilizada. Cada clave de idempotencia debe ser única para garantizar que la operación se realice una única vez. Utiliza una nueva clave para la próxima solicitud.
Error de solicitud409operation_not_supportedLa operación solicitada no es soportada. Verifica si la operación que estás tratando de realizar es válida para el contexto actual.
Error de solicitud409order_already_refundedLa order informada ya fue reembolsada. No es posible procesar un reembolso en una order que ya tiene este estado.
Error de solicitud409order_already_cancelledLa order informada ya fue cancelada. No es posible realizar operaciones en una order que ya se encuentra cancelada.
Error de Idempotencia423resource_lockedLa clave de idempotencia está temporalmente bloqueada. Espera unos instantes y trata de ejecutar la solicitud nuevamente.
Error de Idempotencia500idempotency_validation_failedOcurrió un error interno en el servidor. Intenta reenviar la solicitud con una clave de idempotencia nueva y única para evitar conflictos. Si el problema persiste, comunícate con Soporte y proporciona el x-request-id junto a más detalles sobre la operación realizada.
Error de la API500internal_errorOcurrió un error interno en el servidor. Por favor, intenta nuevamente más tarde. Si el problema persiste, comunícate con Soporte y proporciona el x-request-id junto a más detalles sobre la operación realizada.

Para obtener más información sobre cómo enviar las solicitudes, requerimientos y validaciones necesarias, consulta nuestra Referencia de API para Pagos online y Pagos presenciales.