> ## 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 Stripe a tu flujo, configura el nodo y continúa según el estado real del pago.

Una vez conectada la integración, Stripe queda disponible en tu workspace para usarlo dentro de tus flujos y AI Agents.

> [!TIP]
>
> Si todavía no instalaste la integración, comienza por [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/conectar-en-brain-studio.md).

***

## Tres modalidades de uso

> [card] [WebView embebido](#webview-embebido)
>
> Botón de pago con checkout en WebView

> [card] [Nativo en chat](#nativo-en-chat)
>
> Captura de tarjeta en conversación

> [card] [Tools avanzadas / MCP](#tools-avanzadas-mcp)
>
> Acceso a API completa vía MCP

> [!TIP]
>
> Esta página cubre las tres modalidades. Usa las cards para ir directo a la que necesites.

***

## WebView embebido

Esta es la modalidad **recomendada para empezar**. El usuario recibe un enlace o botón de pago que abre el checkout de Stripe en WebView dentro de WhatsApp.

### Agregar el nodo al Canvas

**1. 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 **Stripe** listado como proveedor disponible.

![Stripe visible en la carpeta Marketplace dentro del panel lateral de Brain Studio](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-nodo-canvas.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=e11ba403cad69519a96b83d42d27cc93)

Stripe en Marketplace (panel lateral)

**2. Arrastrar el nodo al Canvas**

Arrastra **Stripe** desde el panel lateral hacia tu flujo en el Canvas.

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

![Nodo de Stripe agregado al Canvas mostrando sus salidas](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-configuracion-nodo.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=0bd0c2545eaaf275670033a11584515e)

Tool de Stripe con salidas disponibles

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

Selecciona el nodo en el Canvas para abrir su panel de configuración en el lado derecho.

Completa las pestañas **Datos del pago** y **Avanzado**, y revisa las **salidas** disponibles en el nodo del Canvas.

### Configurar el nodo en Canvas

> [tab] Datos del pago
>
> > [accordion] Guardar resultado como
> >
> > **Guardar resultado como** `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).
>
> > [accordion] Tipo de pago (default: payment)
> >
> > **Tipo de pago** `string` (default: payment)
> >
> > Define el tipo de cobro.
> >
> > **Valores disponibles:** `payment` (pago único), `subscription` (suscripción)
> >
> > > [!NOTE]
> > >
> > > Si no seleccionas nada, se usará `payment`.
>
> > [accordion] Expiración del botón de pagos \[minutos]
> >
> > **Expiración del botón de pagos \[minutos]** `number`
> >
> > Define la vigencia del botón de pago desde que se envía al usuario.
> >
> > **Valores disponibles:** `10`, `20`, `30`, `60`
>
> > [accordion] Moneda
> >
> > **Moneda** `string` *required*
> >
> > Moneda del cobro.
> >
> > > [!NOTE]
> > >
> > > La moneda disponible depende del país y configuración de tu cuenta Stripe.
>
> > [accordion] Motivo de pago
> >
> > **Motivo de pago** `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.
>
> > [accordion] Metadata del pago
> >
> > **Metadata del pago** `string`
> >
> > Información adicional para trazabilidad o referencia interna.
> >
> > > [!NOTE]
> > >
> > > Puedes usarlo para correlación con tu orden, conciliación o auditoría del pago.
>
> > [accordion] Email comprador
> >
> > **Email comprador** `string` *required*
> >
> > Correo del comprador. Debe haberse recolectado previamente en el flujo y entregarse aquí como variable.
>
> > [accordion] Personalizar textos botón de pago
> >
> > **Personalizar textos botón de pago** `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)
> >
> > > [!NOTE]
> > >
> > > Cuando esta opción está activa, puedes modificar completamente el mensaje que verá el usuario antes de abrir el checkout.
>
> > [accordion] Header
> >
> > **Header** `string`
> >
> > Título del mensaje que acompaña al botón de pago.
>
> > [accordion] Body
> >
> > **Body** `string`
> >
> > Texto principal del mensaje que acompaña al botón de pago.
>
> > [accordion] Footer
> >
> > **Footer** `string`
> >
> > Texto de cierre o aclaración del mensaje que acompaña al botón de pago.

> [tab] Avanzado
>
> > [accordion] Ambiente
> >
> > Muestra si Stripe opera en **Desarrollo** o **Producción**.
> >
> > En **Desarrollo**, verás el mensaje *Tu integración está en modo de desarrollo. Pásala a producción cuando estés listo.* y podrás iniciar el flujo para **Pasar a producción**.
> >
> > > [!NOTE]
> > >
> > > Debe coincidir con el entorno con el que instalaste Stripe (credenciales de prueba o de producción). Revisa [Pasar a producción](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/conectar-en-brain-studio.md#pasar-a-producción).
>
> > [accordion] Experiencia de pago
> >
> > **Experiencia de pago** `string`
> >
> > Define cómo se presentará el cobro al usuario.
> >
> > **Valores disponibles:** `Pago WebView` (tool nativa), u otras experiencias habilitadas en tu workspace.
> >
> > > [!TIP]
> > >
> > > Para empezar, usa **Pago WebView**. La experiencia nativa en chat requiere habilitación especial.
>
> > [accordion] Stripe Connect
> >
> > Activa este toggle si instalaste Stripe mediante **Crear cuenta en Stripe** (registro guiado en México).
> >
> > > [!NOTE]
> > >
> > > Si conectaste con tu **Access Token** propio (cuenta existente), deja este toggle desactivado.

> [tab] Salidas
>
> > [accordion] Pago exitoso
> >
> > 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] Pago pendiente
> >
> > Se activa cuando el proveedor informa que la transacción quedó en estado pendiente.
> >
> > Puede depender del medio de pago y validaciones adicionales.
> >
> > 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] Pago fallido
> >
> > Se activa cuando la transacción fue rechazada o declinada.
> >
> > Recomendaciones:
> >
> > * Informar al usuario
> > * Permitir reintento
> > * Reutilizar el mismo nodo de Stripe
>
> > [accordion] Error HTTP
> >
> > Se activa cuando ocurre un error de comunicación con el proveedor (timeout, red o respuesta inválida).
>
> > [accordion] Error Code
> >
> > Se activa cuando el proveedor devuelve un código de error interno durante la creación o procesamiento del pago.
>
> > [accordion] Envío correcto de CTA
> >
> > 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.
> > ```

***

## Nativo en chat

Stripe también puede operar con una experiencia de **[pago nativo con tarjeta dentro del chat](https://docs.jelou.ai/guides/integraciones/pagos/experiencias/pago-nativo.md)**.

> [!WARNING]
>
> Esta modalidad requiere habilitación especial.
> Si deseas activarla, escríbenos a [ayuda@jelou.ai](mailto:ayuda@jelou.ai).

***

## Tools avanzadas / MCP

Además del uso en Canvas mediante herramientas nativas, Stripe expone un conjunto de **tools avanzadas** que pueden utilizarse en implementaciones más técnicas o flujos personalizados.

Estas herramientas permiten interactuar directamente con servicios de Stripe desde tu flujo.

> [tab] Tools disponibles
>
> > [accordion] Crear Cliente
> >
> > Crea un nuevo registro de cliente en tu cuenta de Stripe.
> >
> > Los clientes pueden estar asociados con:
> >
> > * Métodos de pago
> > * Suscripciones
> > * Facturas
> >
> > Útil para:
> >
> > * Registrar un cliente antes de procesar pagos
> > * Implementar modelos de suscripción
> > * Gestionar historial de pagos por cliente
>
> > [accordion] Crear Payment Intent
> >
> > Crea un **PaymentIntent** en Stripe.
> >
> > * El monto se envía en centavos\
> >   (ejemplo: `15000` = \$150.00)
> > * Devuelve:
> >   * `client_secret`
> >   * `payment_intent_id`
> >
> > Útil para:
> >
> > * Iniciar un pago desde un cliente
> > * Integraciones personalizadas
> > * Control avanzado del ciclo de pago
>
> > [accordion] Consultar estado de pago
> >
> > Obtiene el estado actual de un pago por:
> >
> > * `PaymentIntent ID`
> > * `Charge ID`
> >
> > Devuelve detalles como:
> >
> > * Estado
> > * Importe
> > * Método de pago
> > * URL del recibo
> >
> > Útil para:
> >
> > * Verificar si un cliente completó el pago
> > * Implementar validaciones adicionales
> > * Consultas post-transacción
>
> > [accordion] Listar transacciones
> >
> > Lista las transacciones recientes de saldo en la cuenta Stripe:
> >
> > * Cargos
> > * Reembolsos
> > * Transferencias
> > * Retiros
> >
> > Soporta:
> >
> > * Filtro por fecha (timestamps Unix)
> > * Paginación
> >
> > Útil para:
> >
> > * Revisar actividad reciente
> > * Conciliación contable
> > * Auditoría de movimientos
>
> > [accordion] Procesar reembolso
> >
> > Procesa un reembolso completo o parcial de un cargo o PaymentIntent.
> >
> > Opciones disponibles:
> >
> > * Monto específico (para reembolsos parciales)
> > * Razón (`duplicate`, `fraudulent`, `requested_by_customer`)
> >
> > Los reembolsos suelen reflejarse en la cuenta del cliente en 5–10 días hábiles.
> >
> > Útil para:
> >
> > * Gestión post-venta
> > * Cancelaciones
> > * Políticas de devolución


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