Cómo crear módulo conector de Mercado Libre

Introducción

Este artículo detalla cómo configurar, autenticar e integrar la API de Mercado Libre en Skyone Studio utilizando la opción de crear módulo.

¿Qué es la API de Mercado Pago?

La API de Mercado Pago utiliza una arquitectura RESTful para permitir la interacción programática con la plataforma de pagos. La comunicación se realiza a través del protocolo HTTPS, con un intercambio de datos estandarizado en formato JSON. Las operaciones disponibles en el módulo ejecutan internamente las llamadas a las rutas de la API, sin necesidad de interacción directa con los endpoints.

Capacidades principales:

• Procesamiento de pagos: Creación y gestión de pagos mediante tarjeta de crédito, PIX, boleto y otros medios locales, como el PSE (Colombia).

• Gestión de tiendas físicas y QR Code: Administración de la estructura de tiendas (Stores), cajas (POS) y generación de QR Codes dinámicos o estáticos para pagos presenciales.

• Integración con terminales (Point): Gestión de dispositivos Point, cambio de modos de operación y creación de intenciones de pago.

• Checkout Pro y Bricks: Creación de preferencias de pago para checkout web y gestión de componentes de interfaz de usuario (Bricks).

• Gestión de clientes y tarjetas: Almacenamiento seguro de datos de clientes y tokenización de tarjetas para compras futuras (One-Click).

Conceptos Fundamentales

La estructura de Mercado Pago se divide entre el ambiente "Online" (Checkout API/Pro) y el ambiente "Físico" (QR Code/Point).

Estructura de Datos y Jerarquía

Para manipular los datos con éxito, es fundamental comprender cómo se estructura la información:

• Collector (Usuario/Vendedor): Representa la cuenta de Mercado Pago que recibe los fondos. Muchas operaciones requieren el userId (ID del colector) para identificar al propietario de la tienda o del pago.

• Store (Tienda Física) & POS (Punto de Venta): Utilizados principalmente en integraciones de QR Code y terminales Point.

  • POS: Representa la caja o terminal dentro de la tienda, identificado por pos_id o external_pos_id.

  • Store: Representa el establecimiento físico (dirección, horario), identificada por store_id o external_store_id.

• Preference (Preferencia de Pago): Objeto central de Checkout Pro que contiene toda la información de la venta (ítems, valores, pagador, URLs de retorno) y genera el enlace para el comprador.

• Payment (Pago): El registro financiero de la transacción. Posee estados (ej: approved, pending, rejected) y puede ser capturado o reembolsado.

• Checkouts Los checkouts son opciones de flujo de Mercado Pago que se eligen al crear la aplicación en la plataforma

  • Checkout API (Transparente): Permite crear pagos directamente vía backend utilizando el endpoint /v1/payments. Requiere que el integrador manipule datos sensibles tokenizados (como card_token_id) y ofrece control total sobre la interfaz sin redireccionamiento visible. Exige la verificación de la empresa en la plataforma.

  • Checkout Pro (Redireccionamiento): Esto funciona mediante la creación de Preferencias (intención de compra) mediante el punto de acceso /checkout/preferences. Al crear una preferencia, el integrador envía los detalles de la compra, como artículos, valores y pagador, y recibe una URL para redirigir al usuario al entorno seguro de Mercado Pago. Este modelo gestiona automáticamente la selección de múltiples métodos de pago, como saldo de cuenta, tarjetas y recibos bancarios, en una única interfaz proporcionada por Mercado Pago.

  • Checkout Bricks: Aparece como una capa modular que puede interactuar tanto con el modelo de Preferencias de Checkout Pro como con la creación directa de Pagos API de Checkout, permitiendo la construcción de interfaces modulares prediseñadas.

Prerrequisitos e Configuración en Mercado Pago

Para iniciar el desarrollo, son necesarios los siguientes elementos:

• Cuenta activa en Mercado Pago: Acceso al Dashboard.

• Aplicación Creada: Una aplicación creada en el área de "Tus Integraciones" para obtener las credenciales.

Tipos de autenticación compatibles

La API de Mercado Pago admite la autenticación con OAuth2 y token de portador.

Obtención de credenciales

Para obtener sus credenciales, siga estos pasos:

1. Acceda al panel de desarrollador de Mercado Pago.

2. Seleccione su aplicación.

3. Vaya a Credenciales de producción (o prueba).

4. Copie el Access Token

Configuración de la cuenta en Skyone Studio

Para conectar os módulos, é necessário criar a conta de autenticação correta.

Configuración Bearer Token

1. En Skyone Studio, cree un módulo llamado Mercado Pago.

2. En el módulo Mercado Pago, en la sección Configuración, seleccione las siguientes opciones:

   • Conectividad: REST

   • Tipo de autenticación: Bearer Token

   • Cuenta conectada: Haga clic en Agregar cuenta conectada

3. Complete los campos como se indica a continuación:

   1. Nombre de la cuenta: Defina un nombre identificable.

   2. Host: https://api.mercadopago.com

   3. Puerto: 443

   4. Token: Ingrese el Access Token (Bearer) obtenido del panel.

4. Haga clic en Crear cuenta.

Operaciones Disponibles

A continuación, se enumeran las operaciones (endpoints) asignadas a este conector, organizadas por contexto de uso.

Gestión de QR Code y Tiendas (QR Dynamic/Attended & Store/POS)

Estas operaciones permiten crear infraestructura para pagos en persona y generar códigos QR.

Nombre de la Operación	Método HTTP	Descripción de la función
QR - Attended-Store & POS Management-Stores-Create Store	POST	Crea una tienda física para la cuenta del usuario (se permiten varias tiendas).
QR - Attended-Store & POS Management-Stores-Update Store	PUT	Actualiza los datos de una tienda física.
QR - Attended-Store & POS Management-Stores-GET Store by ID	GET	Recupera la información de una tienda física por ID.
QR - Attended-Store & POS Management-Stores-Delete Store	DELETE	Elimina la tienda física del usuario identificada por ID.
QR - Attended-Store & POS Management-Stores-Search Store by External_ID	GET	Busca una tienda por ID externo.
QR- Dynamic-Store & POS Management-Stores-Create Store	POST	Crea una tienda física para el usuario.
QR- Dynamic-Store & POS Management-Stores-Update Store	PUT	Actualiza la información de una tienda física.
QR- Dynamic-Store & POS Management-Stores-GET Store by ID	GET	Recupera toda la información de una tienda física a partir de su ID.
QR- Dynamic-Store & POS Management-Stores-Delete Store	DELETE	Elimina la tienda del usuario.
QR- Dynamic-Store & POS Management-Stores-Search Store by External_ID	GET	Recupera la información de la tienda por External_ID.
QR - Attended-Store & POS Management-POS-Create POS	POST	Crea un punto de venta con un código QR único.
QR - Attended-Store & POS Management-POS-Update POS	PUT	Actualiza los datos de un punto de venta identificado por ID.
QR - Attended-Store & POS Management-POS-GET POS by ID	GET	Devuelve toda la información de un punto de venta por ID.
QR - Attended-Store & POS Management-POS-DELETE POS	DELETE	Elimina un punto de venta por ID.
QR - Attended-Store & POS Management-POS-Search POS by External POS ID	GET	Recupera la información del POS por ID externo.
QR- Dynamic-Store & POS Management-POS-Create POS	POST	Crea un punto de venta con un código QR único.
QR- Dynamic-Store & POS Management-POS-Update POS	PUT	Actualiza los datos del punto de venta.
QR- Dynamic-Store & POS Management-POS-GET POS by ID	GET	Recupera toda la información de un punto de venta por ID.
QR- Dynamic-Store & POS Management-POS-DELETE POS	DELETE	Elimina el punto de venta por ID.
QR- Dynamic-Store & POS Management-POS-Search POS by External POS ID	GET	Busca el POS por ID del punto de venta externo.
QR- Dynamic-Orders-Create Dinamic QR	POST	Crea un código QR dinámico para el punto de venta de un cobrador.
QR- Dynamic-Orders-Create order to static QR	PUT	Crea una orden de pago mediante un código QR estático en el POS del cobrador.
QR - Attended-Orders-Create Order	PUT	Crea una orden de pago para un producto o servicio y vincúlala con el punto de venta.
QR - Attended-Orders-GET Order by External POS ID	GET	Consulta el pedido por ID del POS externo.
QR - Attended-Orders-Delete Order by External POS ID	DELETE	Elimina el pedido con ID de usuario e ID del POS externo.

Integración Point (Máquinas de Tarjetas)

Operaciones enfocadas en la gestión de dispositivos físicos de Puntos y sus transacciones.

Nombre de la Operación	Método HTTP	Descripción de la función
Point-Devices-Get paged devices list	GET	Lista dispositivos, con posibilidad de filtrar por ID del punto de venta y/o tienda.
Point-Devices-Change operating mode	PATCH	Cambia el modo de operación del dispositivo a PDV o STANDALONE.
Point-Transaction Intents-Create payment intent	POST	Crea una intención de pago para un dispositivo.
Point-Transaction Intents-Find information payment intent	GET	Recupera información y el estatus final de una intención de pago.
Point-Transaction Intents-Cancel payment intent	DELETE	Cancela la intención de pago de un dispositivo.
Point-Store & POS Management-Stores-Create Store	POST	Crea una tienda física para ventas presenciales.
Point-Store & POS Management-Stores-Update Store	PUT	Actualiza los datos de una tienda física.
Point-Store & POS Management-Stores-GET Store by ID	GET	Ver información detallada de una tienda física por su ID.
Point-Store & POS Management-Stores-Delete Store	DELETE	Elimina una tienda física identificada por el ID.
Point-Store & POS Management-Stores-Search Store by External_ID	GET	Busca la información de la tienda por el ID externo asociado al usuario.
Point-Store & POS Management-POS-Create POS	POST	Crea un punto de venta en la tienda, generando un código QR único.
Point-Store & POS Management-POS-Update POS	PUT	Actualiza la información de un punto de venta.
Point-Store & POS Management-POS-GET POS by ID	GET	Consulta información de un punto de venta por su ID.
Point-Store & POS Management-POS-DELETE POS	DELETE	Elimina el POS por su ID.
Point-Store & POS Management-POS-Search POS by External POS ID	GET	Busca el POS por el ID externo del punto de venta.
Point-Payments & Refunds-Refund Payment (Total)	POST	Reembolsa íntegramente un pago.
Point-Payments & Refunds-Refund Payment (Partial)	POST	Procesa el reembolso parcial de un pago.
Point-Payments & Refunds-Get Payment by ID	GET	Consulta los detalles de un pago por su ID.
Point-Payments & Refunds-Get Payment by External Reference	GET	Consulta un pago por referencia externa.

Pagos y Reembolsos (General)

Operaciones para consultar, revertir y gestionar los pagos realizados.

Nombre de la Operación	Método HTTP	Descripción de la función
QR - Attended-Payments & Refunds-Get Payment by ID	GET	Consulta la información de un pago por su ID.
QR - Attended-Payments & Refunds-Get Payment by External Reference	GET	Consulta un pago por el código de referencia externo.
QR - Attended-Payments & Refunds-Refund Payment (Total)	POST	Realiza el reembolso total de un pago específico.
QR - Attended-Payments & Refunds-Refund Payment (Partial)	POST	Reembolsa parcialmente un pago específico.
QR- Dynamic-Payments & Refunds-Get Payment by ID	GET	Retorna todas as informações de um pagamento pelo ID.
QR- Dynamic-Payments & Refunds-Get Payment by External Reference	GET	Consulta un pago por el número de referencia externo.
QR- Dynamic-Payments & Refunds-Refund Payment (Total)	POST	Reembolsa totalmente el pago identificado.
QR- Dynamic-Payments & Refunds-Refund Payment (Partial)	POST	Reembolsa parcialmente un pago.

Merchant Orders (Pedidos)

Gestión de pedidos que agrupan pagos e ítems.

Nombre de la Operación	Método HTTP	Descripción de la función
QR - Attended-Merchant Orders-GET Merchant Order by ID	GET	Consulta la información de pago de un pedido por su ID.
QR - Attended-Merchant Orders-GET Merchant Order by External Reference	GET	Busca la información del pedido de merchant por la referencia externa.
QR- Dynamic-Merchant Orders-GET Merchant Order by ID	GET	Consulta la información de pago de un pedido de comerciante por su ID.
QR- Dynamic-Merchant Orders-GET Merchant Order by External Reference	GET	Consulta toda la información del pedido del comerciante por referencia externa.
Checkout Pro-Merchant Orders-Get Merchant Order	GET	Consulta la información de pago y el estatus del pedido por su ID.
Checkout Bricks-Mercado Pago Account (Checkout Pro)-Merchant Orders-Get Merchant Order	GET	Consulta la información de pago y el estatus de una orden de comerciante.

Checkout API e Bricks (Pagos Online)

Creación directa de pagos (Tarjeta, PIX, Boleto) y gestión de preferencias de checkout.

Nombre de la Operación	Método HTTP	Descripción de la función
Checkout API-Payments-Create Payment (card)	POST	Crea un pago con tarjeta, incluyendo ítems y pagador.
Checkout API-Payments-Create Payment - Tourism (card)	POST	Crea un pago con datos completos de turismo.
Checkout API-Payments-Create Payment - Tickets and Entertainment (card)	POST	Crea un pago con tarjeta incluyendo detalles de evento.
Checkout API-Payments-[Brasil] Create Payment (PIX)	POST	Crea un pago vía PIX (Brasil).
Checkout API-Payments-[Brasil] Create Payment (boleto)	POST	Crea un pago con boleto (Brasil).
Checkout API-Payments-[Colombia] Create Payment (PSE Avanza)	POST	Crea un pago con PSE Avanza en Colombia.
Checkout API-Payments (auth + capture)-Create Payment (card)	POST	Crea un pago autorizado con tarjeta, aguardando captura.
Checkout API-Payments (auth + capture)-Capture Payment (Total)	PUT	Captura el valor total de un pago preautorizado
Checkout API-Payments (auth + capture)-Capture Payment (Partial)	PUT	Captura parcial de un pago preautorizado
Checkout API-Payments (auth + capture)-Cancel Pre Authorization	PUT	Cancela un pago preautorizado
Checkout API-Payments-Get Payment by ID	GET	Consulta toda la información de un pago por su ID.
Checkout API-Payments-Get Payment by External Reference	GET	Recupera un pago utilizando una referencia externa.
Checkout Bricks-Payments-Create Payment (card)	POST	Crear pago con tarjeta.
Checkout Bricks-Payments-Create Payment - Tourism (card)	POST	Crea un pago con datos completos de turismo.
Checkout Bricks-Payments-Create Payment - Tickets and Entertainment (card)	POST	Crea un pago con tarjeta para artículos de entretenimiento.
Checkout Bricks-Payments-[Brasil] Create Payment (PIX)	POST	Crea un pago vía PIX (solo Brasil).
Checkout Bricks-Payments-[Brasil] Create Payment (boleto)	POST	Crea un pago con boleto en Brasil.
Checkout Bricks-Payments (auth + capture)-Create Payment (card)	POST	Crea un pago autorizado vía tarjeta, con captura posterior.
Checkout Bricks-Payments (auth + capture)-Capture Payment (Total)	PUT	Captura el valor total de un pago preautorizado.
Checkout Bricks-Payments (auth + capture)-Capture Payment (Partial)	PUT	Captura parcialmente un pago preautorizado.
Checkout Bricks-Payments (auth + capture)-Cancel Pre Authorization	PUT	Cancelar pago preautorizado.
Checkout Bricks-Payments-Get Payment by ID	GET	Consulta los detalles del pago por su ID.
Checkout Bricks-Payments-Get Payment by External Reference	GET	Busca toda la información de un pago utilizando su referencia externa.

Preferencias de Checkout (Checkout Pro)

Nombre de la Operación	Método HTTP	Descripción de la función
Checkout Pro-Preferences-Create Preference	POST	Crea una preferencia de pago y devuelve la URL de checkout.
Checkout Pro-Preferences-Create Preference - Tourism	POST	Crea una preferencia de pago para turismo.
Checkout Pro-Preferences-Create Preference - Tickets and Entertainment	POST	Crear preferencia de pago – Boletos y Entretenimiento.
Checkout Pro-Preferences-Update Preference	PUT	Actualización de los detalles de la preferencia de pago.
Checkout Pro-Preferences-Get Preference	GET	Obtiene información detallada de una preferencia específica.
Checkout Pro-Marketplace model-Create Preference - Marketplace Fee	POST	Crea una preferencia de checkout con comisión de marketplace.
Checkout Bricks-Mercado Pago Account (Checkout Pro)-Preferences-Create Preference	POST	Crea una preferencia de pago.
Checkout Bricks-Mercado Pago Account (Checkout Pro)-Preferences-Update Preference	PUT	Actualiza los detalles de una preferencia de pago.
Checkout Bricks-Mercado Pago Account (Checkout Pro)-Preferences-Get Preference	GET	Consulta la preferencia de checkout por su ID.
Checkout Bricks-Marketplace model-Create Preference - Marketplace Fee	POST	Crea una preferencia de checkout agregando comisión de marketplace.

Clientes y Tarjetas (Customers & Cards)

Nombre de la Operación	Método HTTP	Descripción de la función
Checkout API-Customers & Cards-Customers-Create Customer	POST	Crea un cliente con todos los datos y registra tarjetas.
Checkout API-Customers & Cards-Customers-Update Customer	PUT	Actualiza los datos de un cliente.
Checkout API-Customers & Cards-Customers-Get Customer	GET	Busca información del cliente por su ID.
Checkout API-Customers & Cards-Customers-Get Customer by Email	GET	Busca información del cliente usando el correo electrónico.
Checkout API-Customers & Cards-Cards-Add Credit Card	POST	Registra la tarjeta de crédito del cliente en el sistema.
Checkout API-Customers & Cards-Cards-Update Customer Card	PUT	Actualiza los detalles de la tarjeta de un cliente.
Checkout API-Customers & Cards-Cards-Get Customer Card	GET	Consulta la referencia de una tarjeta guardada de un cliente.
Checkout API-Customers & Cards-Cards-Get All Customer Cards	GET	Consulta las tarjetas guardadas del cliente.
Checkout API-Customers & Cards-Cards-Delete Customer Card	DELETE	Elimina la tarjeta de un cliente.
Checkout API-Customers & Cards-Payments-Create Payment existing customer(card)	POST	Crea un pago con tarjeta para un cliente ya existente.
Checkout API-Customers & Cards-Zero Dollar Auth-Card Validation (with customer id)	POST	Valida la tarjeta de un cliente ya registrado mediante una transacción de valor cero.
Checkout API-Customers & Cards-Zero Dollar Auth-Card validation (with email)	POST	Valida una tarjeta con transacción de valor cero y el correo electrónico del pagador.
Checkout Bricks-Customers & Cards-Customers-Create Customer	POST	Crea un cliente con datos completos.
Checkout Bricks-Customers & Cards-Customers-Update Customer	PUT	Actualiza los datos de un cliente.
Checkout Bricks-Customers & Cards-Customers-Get Customer	GET	Muestra los datos de un cliente por su ID.
Checkout Bricks-Customers & Cards-Customers-Get Customer by Email	GET	Busca un cliente por correo electrónico.
Checkout Bricks-Customers & Cards-Cards-Add Credit Card	POST	Almacena la referencia de la tarjeta de crédito del cliente.
Checkout Bricks-Customers & Cards-Cards-Update Customer Card	PUT	Actualiza los datos de una tarjeta de cliente.
Checkout Bricks-Customers & Cards-Cards-Get Customer Card	GET	Verifica los datos de una tarjeta guardada para un cliente.
Checkout Bricks-Customers & Cards-Cards-Get All Customer Cards	GET	Lista las tarjetas almacenadas de un cliente.
Checkout Bricks-Customers & Cards-Cards-Delete Customer Card	DELETE	Elimina la tarjeta de un cliente.
Checkout Bricks-Customers & Cards-Payments-Create Payment existing customer(card)	POST	Crea un pago de un cliente ya guardado utilizando una tarjeta.
Checkout Bricks-Customers & Cards-Zero Dollar Auth-Card Validation (with customer id)	POST	Valida la tarjeta del cliente mediante una transacción de valor cero.
Checkout Bricks-Customers & Cards-Zero Dollar Auth-Card validation (with email)	POST	Valida una tarjeta con transacción de valor cero y el correo electrónico del pagador.

Reversiones y Chargebacks

Nombre de la Operación	Método HTTP	Descripción de la función
Checkout API-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Total)	POST	Procesa el reembolso total de un pago específico.
Checkout API-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Partial)	POST	Emite el reembolso parcial de un pago específico.
Checkout API-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Cancel Payment	PUT	Cancela un pago preautorizado o pendiente.
Checkout API-Refunds, Cancellations & Chargebacks-Chargebacks-Get Chargeback	GET	Consulta información de chargeback por su ID.
Checkout API-Refunds, Cancellations & Chargebacks-Chargebacks-Chargeback - Upload documentation	POST	Envio de documentación para la disputa de un chargeback.
Checkout Pro-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Total)	POST	Realiza el reembolso total de un pago específico.
Checkout Pro-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Partial)	POST	Reembolsar parcialmente un pago específico.
Checkout Pro-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Cancel Payment	PUT	Cancela el pago (preautorizado o pendiente).
Checkout Pro-Refunds, Cancellations & Chargebacks-Chargebacks-Get Chargeback	GET	Mostrar los detalles de un chargeback por su ID.
Checkout Pro-Refunds, Cancellations & Chargebacks-Chargebacks-Chargeback - Upload documentation	POST	Envío de documentación del chargeback.
Checkout Bricks-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Total)	POST	Emite el reembolso total de un pago.
Checkout Bricks-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Refund Payment (Partial)	POST	Crea el reembolso parcial de un pago.
Checkout Bricks-Refunds, Cancellations & Chargebacks-Refunds and Cancellations-Cancel Payment	PUT	Cancela el pago (preautorizado y pendiente).
Checkout Bricks-Refunds, Cancellations & Chargebacks-Chargebacks-Get Chargeback	GET	Consulta los detalles del chargeback por su ID.
Checkout Bricks-Refunds, Cancellations & Chargebacks-Chargebacks-Chargeback - Upload documentation	POST	Envío de documentación de contracargo (chargeback).

Modelos de Marketplace

Nombre de la Operación	Método HTTP	Descripción de la función
Checkout API-Marketplace model-Create Payment (card) - Marketplace Fee	POST	Crea un pago con tarjeta incluyendo comisión de marketplace.
Checkout Pro-Marketplace model-Create Preference - Marketplace Fee	POST	Crea una preferencia de checkout con comisión de marketplace.
Checkout Bricks-Marketplace model-Create Payment (card) - Marketplace Fee	POST	Crea un pago con tarjeta incluyendo comisión de marketplace.
Checkout Bricks-Marketplace model-Create Preference - Marketplace Fee	POST	Crea una preferencia de checkout agregando comisión de marketplace a la transacción.

Utilidades y Configuraciones (OAuth, Metodos de Pago)

Nombre de la Operación	Método HTTP	Descripción de la función
Oauth-Connect URL	POST	Redirecciona al cliente a la página de autorización.
Oauth-Generate Access Token	POST	Genera el token de acceso OAuth para el vendedor.
Oauth-Refresh Access Token	POST	Actualiza el token de acceso para operar en nombre del vendedor.
Checkout API-Payment Methods-Get Payment Method	GET	Consulta los métodos de pago disponibles para un determinado BIN.
Checkout API-Payment Methods-Get Installments	GET	Consulta las cuotas disponibles para un BIN y monto de transacción.
Checkout API-Identification Types-Get Identification types	GET	Consulta los tipos de documentos de identificación por país.

Lee más cómo agregar operaciones en los módulos.

Ejemplo de flujo utilizando Mercado Pago

Este ejemplo demuestra cómo construir un flujo de pago utilizando Skyone Studio, integrando API, base de datos y el módulo de Mercado Pago, con gestión de éxito y error.

Componentes utilizados en el flujo

Los flujos presentados utilizan los siguientes recursos de la plataforma:

• API Gateway y Webhook Responsables de exponer endpoints y recibir llamadas externas, permitiendo la comunicación entre el sistema cliente y el flujo en Skyone Studio.

• Base de datos Una base de datos simple que contiene información de productos (por ejemplo: ID, nombre, precio), utilizada para enriquecer los datos de la compra.

• Módulo de Mercado Pago Utilizado para crear y gestionar pagos directamente en la plataforma de Mercado Pago.

---

Objetivo de la integración

La integración fue diseñada para recibir una solicitud con datos mínimos de la compra, como el ID del producto, y a partir de ahí:

1. Consultar la base de datos de Skyone Studio para recuperar la información completa del producto.

2. Armar los datos necesarios para la creación del pago en Mercado Pago.

3. Enviar la solicitud de pago a Mercado Pago.

4. Gestionar los escenarios de éxito o error, definiendo correctamente la respuesta al sistema solicitante.

5. Procesar notificaciones asincrónicas a través de un webhook, activado cuando se actualiza el estatus del pago.

---

Flujos principales

La solución se compone de dos flujos principales:

1. Envío de pago

Este flujo es responsable de iniciar el proceso de pago:

• Recibe la solicitud vía API Gateway, que contiene el identificador de la compra o del producto.

• Ejecuta una consulta en la base de datos del Studio para obtener los datos completos del producto.

• Realiza validaciones básicas (por ejemplo, si el producto existe).

• Armar la estructura de datos esperada por Mercado Pago.

• Envía la solicitud de creación del pago utilizando el módulo de Mercado Pago.

• Devuelve al cliente el resultado inicial de la creación del pago (como link o estatus).

2. Verificación de éxito o error

Este flujo es responsable de validar el resultado del pago:

• Recibe una llamada (vía API o webhook).

• Consulta la base de datos o el estatus devuelto por Mercado Pago.

• Evalúa el resultado utilizando una condición (IF), separando los escenarios de:

  • Pago aprobado (éxito)

  • Pago rechazado o con error (falla)

• Devuelve la respuesta adecuada para cada escenario, garantizando que el sistema cliente sepa cómo proceder.

Leer también: Documentación Oficial de la API de Mercado Pago