> ## 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio.md).

***

## Agregar el nodo al Canvas

**1. Abrir tu flujo en Canvas**

Abre en Brain Studio el flujo donde quieres incorporar el cobro con Kushki.

**2. 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.

**3. 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.

**4. Abrir el panel de configuración**

Selecciona el nodo para abrir el panel lateral y completar los **inputs** y revisar las **salidas**.

![Nodo Kushki Pago WebView con salidas del pago y panel lateral en Datos del pago](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-nodo-datos-del-pago.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=2636240e03dbeecb25aa3d21e1677b14)

Nodo Kushki en Canvas con el panel Datos del pago

***

## Configurar el nodo

> [tab] Inputs
>
> ### Datos del pago
>
> > [accordion] Personalización
> >
> > **Personalización** `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.
>
> > [accordion] Motivo de pago
> >
> > **Motivo de pago** `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}}`.
>
> > [accordion] Monto sujeto a impuestos
> >
> > **Monto sujeto a impuestos** `number` *required*
> >
> > Monto sobre el que aplica IVA. Solo números.
> >
> > Puedes mapearlo desde variables del flujo.
>
> > [accordion] Monto libre de impuestos
> >
> > **Monto libre de impuestos** `number` *required*
> >
> > Monto exento de impuestos. Si no aplica, usa `0`. Solo números.
> >
> > Puedes mapearlo desde variables del flujo.
>
> > [!NOTE]
> >
> > El nodo en Canvas expone las salidas **Pago exitoso**, **Pago pendiente**, **Mensaje de pago enviado**, **Pago fallido** y **Error**.
>
> ### Avanzado
>
> > [accordion] Ambiente
> >
> > Muestra si Kushki opera en **Desarrollo** o **Producción**.
> >
> > Si está en **Desarrollo**, desde aquí puedes iniciar **Pasar a producción**.
>
> > [accordion] Expiración del botón de pago
> >
> > **Expiración del botón de pago** `string`
> >
> > Define cuánto tiempo permanece vigente el botón de pago después de enviarlo.
>
> ![Panel Avanzado del nodo Kushki con ambiente Desarrollo y expiración del botón de pago](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=c9b5e0e495348ecfc920c36ed7ed4198)
>
> Pestaña Avanzado del nodo Kushki

> [tab] Outputs
>
> > [accordion] Pago exitoso
> >
> > Se activa cuando Kushki confirma que la transacción fue aprobada.
> >
> > Recomendaciones:
> >
> > * confirmar la orden
> > * emitir comprobante o actualizar estado en sistemas externos
>
> > [accordion] Pago pendiente
> >
> > 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] Mensaje de pago enviado
> >
> > 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] Pago fallido
> >
> > Se activa cuando la transacción fue rechazada, declinada o no se completa.
> >
> > Recomendaciones:
> >
> > * permitir reintento controlado
> > * ofrecer soporte o un camino alternativo
>
> > [accordion] Error
> >
> > Se activa ante errores técnicos, errores del proveedor o fallas de comunicación.
> >
> > Recomendaciones:
> >
> > * registrar el error
> > * mostrar mensaje de contingencia

***

## 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.

**1. Confirmar credenciales de prueba**

Verifica que Kushki esté instalado con credenciales del ambiente de prueba.

**2. Configurar el nodo**

Completa **Motivo de pago**, **Monto sujeto a impuestos** y **Monto libre de impuestos**. En **Avanzado**, confirma que el ambiente sea **Desarrollo**.

**3. Probar desde WhatsApp**

Dispara el flujo desde WhatsApp, abre el checkout WebView de Kushki y completa un pago de prueba.

**4. Validar la salida del flujo**

Verifica por qué salida continúa el flujo:

* **Pago exitoso**
* **Pago pendiente**
* **Pago fallido**
* **Error**

***

## 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio.md)
* 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

> [accordion] El ambiente depende de la instalación
>
> Con credenciales de prueba, usa datos de prueba. Con credenciales de producción, usa datos reales.

> [accordion] Evita pagos duplicados
>
> En escenarios pendientes o fallidos, informa con claridad antes de iniciar otro intento de cobro.

***

## Próximo paso

> [card] [Cobertura y precios](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/cobertura-y-precios.md)
>
> Revisa disponibilidad por país, monedas, medios de pago y consideraciones comerciales de Kushki.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.