> ## 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 Kushki a tu flujo en Canvas, configura sus inputs y prueba pagos en ambiente de prueba.

Una vez conectada la integración, el nodo de **Kushki** queda disponible en Canvas y te permite crear experiencias de cobro con **WebView embebido** dentro del flujo conversacional.

<Tip>
  Si todavía no instalaste la integración, sigue primero [Conectar en Brain Studio](/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio).
</Tip>

***

## Agregar el nodo al Canvas

<Steps>
  <Step title="Abrir tu flujo en Canvas">
    Abre en Brain Studio el flujo donde quieres incorporar el cobro con Kushki.
  </Step>

  <Step title="Agregar el nodo Kushki">
    Agrega **Kushki** desde la barra de herramientas de **Canvas**, en el nodo **Pagos**, o desde los proveedores de pago disponibles una vez instalada la integración.
  </Step>

  <Step title="Conectar el nodo al punto de cobro">
    Conecta el nodo de Kushki después de que el flujo ya tenga el monto y la confirmación de compra.
  </Step>

  <Step title="Abrir el panel de configuración">
    Selecciona el nodo para abrir el panel lateral y completar los **inputs** y revisar las **salidas**.

    <Frame caption="Nodo Kushki en Canvas con el panel Datos del pago">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=c6500efb1c7250bed16768bedcf0f60e" alt="Nodo Kushki Pago WebView con salidas del pago y panel lateral en Datos del pago" width="1154" height="926" data-path="assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png" />
    </Frame>
  </Step>
</Steps>

***

## Configurar el nodo

<Tabs>
  <Tab title="Inputs">
    ### Datos del pago

    <AccordionGroup>
      <Accordion title="Personalización" icon="message">
        <ParamField body="Personalización" type="boolean" default="false">
          Actívalo para definir los mensajes que acompañan el botón de pago.

          Si está desactivado, Brain Studio usa los textos predeterminados del mensaje de cobro.
        </ParamField>
      </Accordion>

      <Accordion title="Motivo de pago" icon="file-lines">
        <ParamField body="Motivo de pago" type="string" required>
          Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna.

          Puedes mapearlo desde variables del flujo, por ejemplo `{{$memory.paymentBreakdown.summary}}`.
        </ParamField>
      </Accordion>

      <Accordion title="Monto sujeto a impuestos" icon="receipt">
        <ParamField body="Monto sujeto a impuestos" type="number" required>
          Monto sobre el que aplica IVA. Solo números.

          Puedes mapearlo desde variables del flujo.
        </ParamField>
      </Accordion>

      <Accordion title="Monto libre de impuestos" icon="dollar-sign">
        <ParamField body="Monto libre de impuestos" type="number" required>
          Monto exento de impuestos. Si no aplica, usa `0`. Solo números.

          Puedes mapearlo desde variables del flujo.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Note>
      El nodo en Canvas expone las salidas **Pago exitoso**, **Pago pendiente**, **Mensaje de pago enviado**, **Pago fallido** y **Error**.
    </Note>

    ### Avanzado

    <AccordionGroup>
      <Accordion title="Ambiente" icon="server">
        Muestra si Kushki opera en **Desarrollo** o **Producción**.

        Si está en **Desarrollo**, desde aquí puedes iniciar **Pasar a producción**.
      </Accordion>

      <Accordion title="Expiración del botón de pago" icon="clock">
        <ParamField body="Expiración del botón de pago" type="string">
          Define cuánto tiempo permanece vigente el botón de pago después de enviarlo.
        </ParamField>
      </Accordion>
    </AccordionGroup>

    <Frame caption="Pestaña Avanzado del nodo Kushki">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=384162aa6b962dda00334667f8d39b41" alt="Panel Avanzado del nodo Kushki con ambiente Desarrollo y expiración del botón de pago" width="1162" height="656" data-path="assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png" />
    </Frame>
  </Tab>

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

        Recomendaciones:

        * confirmar la orden
        * emitir comprobante o actualizar estado en sistemas externos
      </Accordion>

      <Accordion title="Pago pendiente" icon="clock">
        Se activa cuando la transacción queda en proceso o requiere confirmación posterior.

        Recomendaciones:

        * informar al usuario con claridad
        * evitar crear un segundo cobro mientras se resuelve el estado
      </Accordion>

      <Accordion title="Mensaje de pago enviado" icon="paper-plane">
        Se activa cuando el mensaje con el botón de pago se envía correctamente en la conversación.

        Esta salida **no** confirma el pago. Solo indica que el mensaje se envió correctamente.
      </Accordion>

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

        Recomendaciones:

        * permitir reintento controlado
        * ofrecer soporte o un camino alternativo
      </Accordion>

      <Accordion title="Error" icon="triangle-exclamation">
        Se activa ante errores técnicos, errores del proveedor o fallas de comunicación.

        Recomendaciones:

        * registrar el error
        * mostrar mensaje de contingencia
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

***

## Probar pagos en ambiente de prueba

Si Kushki está conectado con credenciales de **prueba**, puedes probar el checkout con los datos de prueba de Kushki.

<Note>
  En ambiente de prueba, el pago es ficticio y no mueve dinero real.
</Note>

<Steps>
  <Step title="Confirmar credenciales de prueba">
    Verifica que Kushki esté instalado con credenciales del ambiente de prueba.
  </Step>

  <Step title="Configurar el nodo">
    Completa **Motivo de pago**, **Monto sujeto a impuestos** y **Monto libre de impuestos**. En **Avanzado**, confirma que el ambiente sea **Desarrollo**.
  </Step>

  <Step title="Probar desde WhatsApp">
    Dispara el flujo desde WhatsApp, abre el checkout WebView de Kushki y completa un pago de prueba.
  </Step>

  <Step title="Validar la salida del flujo">
    Verifica por qué salida continúa el flujo:

    * **Pago exitoso**
    * **Pago pendiente**
    * **Pago fallido**
    * **Error**
  </Step>
</Steps>

***

## Pasar a producción

Si instalaste Kushki en **desarrollo/prueba**, inicia el paso a producción desde la pestaña **Avanzado** del nodo o desde **Marketplace**.

Antes de operar con pagos reales:

* Ten listas las credenciales de **producción**
* Usa el flujo descrito en [Conectar en Brain Studio](/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio)
* Recuerda el costo de **\$0.10 USD** por transacción en producción
* Ejecuta una prueba real de bajo monto antes de escalar

***

## Consideraciones importantes

<AccordionGroup>
  <Accordion title="El ambiente depende de la instalación">
    Con credenciales de prueba, usa datos de prueba. Con credenciales de producción, usa datos reales.
  </Accordion>

  <Accordion title="Evita pagos duplicados">
    En escenarios pendientes o fallidos, informa con claridad antes de iniciar otro intento de cobro.
  </Accordion>
</AccordionGroup>

***

## Próximo paso

<Card title="Cobertura y precios" href="/guides/integraciones/pagos/proveedores/kushki/cobertura-y-precios" icon="globe">
  Revisa disponibilidad por país, monedas, medios de pago y consideraciones comerciales de Kushki.
</Card>
