Skip to main content
Una vez conectada la integración en Marketplace, Stripe queda disponible en tu workspace para usarlo dentro de tus flujos y AI Agents.
¿Primera vez implementando un cobro? Sigue primero la guía Tutorial: Implementando tu primer cobro desde WhatsApp que te lleva paso a paso desde cero hasta producción.

Tres modalidades de uso

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

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.

Configurar el nodo en Canvas

Guardar resultado como
string
Define el nombre de la variable donde Brain Studio guardará el JSON completo de respuesta del nodo.
Útil si quieres usar la respuesta más adelante (logs, validaciones, trazabilidad o decisiones del flujo).
Tipo de pago
string
default:"payment"
Define el tipo de cobro.Valores disponibles: payment (pago único), subscription (suscripción)
Si no seleccionas nada, se usará payment.
Ambiente
string
required
Define el entorno de ejecución del pago.Valores disponibles: Test, Producción
Debe coincidir con la API Key con la que instalaste Stripe en Marketplace (Test vs Live).
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
Moneda
string
required
Moneda del cobro.
La moneda disponible depende del país y configuración de la cuenta Stripe conectada.
Motivo de pago
string
required
Texto descriptivo del cobro (por ejemplo, número de orden o descripción del producto o servicio).
Idealmente úsalo con variables del flujo para que quede alineado al contexto de la conversación.
Metadata del pago
string
Información adicional para trazabilidad o referencia interna.
Puedes usarlo para correlación con tu orden, conciliación o auditoría del pago.
Email comprador
string
required
Correo del comprador. Debe haberse recolectado previamente en el flujo y entregarse aquí como variable.
Personalizar textos botón de pago
boolean
default:"false"
Si seleccionas , 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)
Cuando esta opción está activa, puedes modificar completamente el mensaje que verá el usuario antes de abrir el checkout.
Header
string
Título del mensaje que acompaña al botón de pago.
Body
string
Texto principal del mensaje que acompaña al botón de pago.

Nativo en chat

Stripe también puede operar con una experiencia de pago nativo con tarjeta dentro del chat.
Esta modalidad requiere habilitación especial. Si deseas activarla, escríbenos a [email protected].

Payments – Pago con tarjeta (documentación técnica)

Referencia técnica para implementar la experiencia nativa.

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