> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso y configuración

> Agrega el nodo de Mercado Pago a tu flujo en Canvas y configura sus inputs y outputs.

Una vez conectada la integración en Marketplace, el nodo de **Mercado Pago** queda disponible en tu workspace para usarlo dentro de tus flujos.

En esta guía verás cómo agregarlo al Canvas y cómo configurar sus entradas y salidas.

<Tip>
  ¿Primera vez implementando un cobro? Sigue primero la guía [Tutorial: Implementando tu primer cobro desde WhatsApp](/guides/integraciones/pagos/implementando-tu-primer-cobro) que te lleva paso a paso desde cero hasta producción.
</Tip>

***

## Agregar el nodo al Canvas

<Steps>
  <Step title="Ubicar la integración en Marketplace">
    En el panel lateral izquierdo de Brain Studio, abre la carpeta **Marketplace**.

    Si la integración está correctamente conectada, verás **Mercado Pago** listado como proveedor disponible.

    <Frame caption="Mercado Pago disponible en el panel lateral de Marketplace">
      <img src="https://mintcdn.com/jelouai/y5L6vahGrhMqbaUQ/assets/images/integraciones/pagos/mercado-pago-nodo-canvas.png?fit=max&auto=format&n=y5L6vahGrhMqbaUQ&q=85&s=525151f895b2b80de936349f1f6fb69e" alt="Mercado Pago visible en la carpeta Marketplace dentro del panel lateral de Brain Studio" width="766" height="522" data-path="assets/images/integraciones/pagos/mercado-pago-nodo-canvas.png" />
    </Frame>
  </Step>

  <Step title="Arrastrar el nodo al Canvas">
    Arrastra **Mercado Pago** desde el panel lateral hacia tu flujo en el Canvas.

    Al soltarlo, se creará el bloque del nodo con sus salidas disponibles.

    <Frame caption="Nodo de Mercado Pago desplegado en el Canvas">
      <img src="https://mintcdn.com/jelouai/nCvuucLdA-_D8bXJ/assets/images/integraciones/pagos/mercado-pago-configuracion-nodo.png?fit=max&auto=format&n=nCvuucLdA-_D8bXJ&q=85&s=91263850a921fc15919900b63a9d0e32" alt="Nodo de Mercado Pago agregado al Canvas mostrando sus salidas" width="2048" height="956" data-path="assets/images/integraciones/pagos/mercado-pago-configuracion-nodo.png" />
    </Frame>
  </Step>

  <Step title="Abrir el panel de configuración">
    Selecciona el nodo en el Canvas para abrir su panel de configuración en el lado derecho.

    Desde allí podrás completar los **inputs** y revisar las **salidas** disponibles.
  </Step>
</Steps>

***

## Configurar el nodo en Canvas

<Tabs>
  <Tab title="Inputs">
    <AccordionGroup>
      <Accordion title="Guardar resultado como" icon="database">
        <ParamField body="Guardar resultado como" type="string">
          Define el nombre de la variable donde Brain Studio guardará el **JSON completo** de respuesta del nodo.

          <Tip>
            Útil si quieres usar la respuesta más adelante (logs, validaciones, trazabilidad o decisiones del flujo).
          </Tip>
        </ParamField>
      </Accordion>

      <Accordion title="Tipo de pago (default: payment)" icon="credit-card">
        <ParamField body="Tipo de pago" type="string" default="payment">
          Define el tipo de cobro.

          **Valores disponibles:** `payment` (pago único), `subscription` (suscripción)

          <Info>
            Si no seleccionas nada, se usará `payment`.
          </Info>
        </ParamField>
      </Accordion>

      <Accordion title="Ambiente" icon="flask">
        <ParamField body="Ambiente" type="string" required>
          Define el entorno de ejecución del pago.

          **Valores disponibles:** `Test`, `Producción`

          <Warning>
            Debe coincidir con el Access Token que conectaste en Marketplace (Test vs Producción).
          </Warning>
        </ParamField>
      </Accordion>

      <Accordion title="Expiración del botón de pagos [minutos]" icon="clock">
        <ParamField body="Expiración del botón de pagos [minutos]" type="number">
          Define la vigencia del botón de pago desde que se envía al usuario.

          **Valores disponibles:** `10`, `20`, `30`, `60`
        </ParamField>
      </Accordion>

      <Accordion title="Moneda" icon="coins">
        <ParamField body="Moneda" type="string" required>
          Moneda del cobro.

          <Info>
            La moneda disponible depende del país de la cuenta o credenciales de Mercado Pago conectadas.
          </Info>
        </ParamField>
      </Accordion>

      <Accordion title="Motivo de pago" icon="file-lines">
        <ParamField body="Motivo de pago" type="string" required>
          Texto descriptivo del cobro (por ejemplo, número de orden o descripción del producto o servicio).

          <Tip>
            Idealmente úsalo con variables del flujo para que quede alineado al contexto de la conversación.
          </Tip>
        </ParamField>
      </Accordion>

      <Accordion title="Metadata del pago" icon="tag">
        <ParamField body="Metadata del pago" type="string">
          Información adicional para trazabilidad o referencia interna.

          <Info>
            Puedes usarlo para correlación con tu orden, conciliación o auditoría del pago.
          </Info>
        </ParamField>
      </Accordion>

      <Accordion title="Email comprador" icon="envelope">
        <ParamField body="Email comprador" type="string" required>
          Correo del comprador. Debe haberse recolectado previamente en el flujo y entregarse aquí como variable.
        </ParamField>
      </Accordion>

      <Accordion title="Personalizar textos botón de pago" icon="message">
        <ParamField body="Personalizar textos botón de pago" type="boolean" default="false">
          Si seleccionas **Sí**, se habilitan campos adicionales para personalizar el mensaje que acompaña al botón de pago.

          **Campos que se habilitan al activar:**

          * `Header` (obligatorio)
          * `Body` (obligatorio)
          * `Footer` (obligatorio)
        </ParamField>

        <Info>
          Cuando esta opción está activa, puedes modificar completamente el mensaje que verá el usuario antes de abrir el checkout.
        </Info>

        <Frame caption="Ejemplo de mensaje con botón de pago personalizado en WhatsApp">
          <img src="https://mintcdn.com/jelouai/nCvuucLdA-_D8bXJ/assets/images/integraciones/pagos/mercado-pago-boton-ejemplo.png?fit=max&auto=format&n=nCvuucLdA-_D8bXJ&q=85&s=adc316c21bd770d28a50e948abff86ef" alt="Ejemplo de mensaje con textos personalizados y botón de pago de Mercado Pago en WhatsApp" className="max-w-sm mx-auto" width="1033" height="498" data-path="assets/images/integraciones/pagos/mercado-pago-boton-ejemplo.png" />
        </Frame>
      </Accordion>

      <Accordion title="Header" icon="heading">
        <ParamField body="Header" type="string">
          Título del mensaje que acompaña al botón de pago.
        </ParamField>
      </Accordion>

      <Accordion title="Body" icon="align-left">
        <ParamField body="Body" type="string">
          Texto principal del mensaje que acompaña al botón de pago.
        </ParamField>
      </Accordion>

      <Accordion title="Footer" icon="minus">
        <ParamField body="Footer" type="string">
          Texto de cierre o aclaración del mensaje que acompaña al botón de pago.
        </ParamField>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Outputs">
    <AccordionGroup>
      <Accordion title="Pago exitoso" icon="circle-check">
        Se activa cuando el proveedor confirma que la transacción fue procesada correctamente.

        Este es el punto oficial de confirmación de pago dentro del flujo.

        Ejemplos de uso:

        * Emitir factura
        * Activar suscripción
        * Liberar producto o servicio
        * Actualizar estado de orden en sistema externo
      </Accordion>

      <Accordion title="Pago pendiente" icon="clock">
        Se activa cuando el proveedor informa que la transacción quedó en estado pendiente.

        Puede depender del medio de pago (transferencias, validaciones adicionales, entre otros).

        Actualmente el monitoreo del cambio de estado desde pendiente a aprobado requiere lógica adicional (por ejemplo, webhook o verificación posterior del estado).
      </Accordion>

      <Accordion title="Pago fallido" icon="circle-xmark">
        Se activa cuando la transacción fue rechazada o declinada.

        Recomendaciones:

        * Informar al usuario
        * Permitir reintento
        * Reutilizar el mismo nodo de Mercado Pago
      </Accordion>

      <Accordion title="Error HTTP" icon="triangle-exclamation">
        Se activa cuando ocurre un error de comunicación con el proveedor (timeout, red o respuesta inválida).
      </Accordion>

      <Accordion title="Error Code" icon="bug">
        Se activa cuando el proveedor devuelve un código de error interno durante la creación o procesamiento del pago.
      </Accordion>

      <Accordion title="Envío correcto de CTA" icon="paper-plane">
        Se activa cuando el botón de pago fue enviado correctamente en la conversación.

        Indica que el mensaje con el botón se desplegó exitosamente en WhatsApp.

        Puede conectarse a un AI Agent que asista al usuario mientras decide completar el pago.

        **Ejemplo de prompt (referencial):**

        ```txt theme={null}
        Actúa como asistente de pagos.

        El usuario acaba de recibir un botón para completar su pago.
        No envíes mensajes proactivos.
        Solo responde si el usuario hace una pregunta.
        Ayúdalo a entender cómo completar el pago y resuelve dudas relacionadas.
        ```
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>
