# 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](/espanol/skyone-studio/modulos/gestion-de-modulos/creacion-de-modulos.md).

## ¿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](https://www.mercadopago.com/developers/panel).
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.        |

{% hint style="info" %}
Lee más cómo [agregar operaciones en los módulos.](/espanol/skyone-studio/modulos/configuraciones-and-operaciones/operaciones-de-modulos.md)
{% endhint %}

## 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**](https://www.mercadopago.com.br/developers/es)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/espanol/skyone-studio/how-to/como-crear-modulo-conector-de-mercado-libre.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.