Saltar al contenido principal

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.

Una vez conectada la integración, el nodo de PayPal queda disponible en Canvas y te permite crear experiencias de cobro con WebView embebido dentro del flujo conversacional.
Si todavía no instalaste la integración, sigue primero Conectar en Brain Studio.

Agregar el nodo al Canvas

1

Abrir tu flujo en Canvas

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

Agregar el nodo PayPal

Agrega PayPal desde la barra de herramientas de Canvas, en el nodo Pagos, o desde los proveedores de pago disponibles una vez instalada la integración.El punto exacto puede variar según si iniciaste la instalación desde Marketplace, Jelou Agent, el nodo de pagos en Canvas o un template.
3

Conectar el nodo al punto de cobro

Conecta el nodo de PayPal después de que el flujo ya tenga el monto, los datos del comprador y la confirmación de compra.
4

Abrir el panel de configuración

Selecciona el nodo para abrir el panel lateral derecho y completar los inputs y revisar las salidas disponibles.
Nodo PayPal en Canvas con el panel lateral de configuración abierto

Configurar el nodo

Datos del pago

Personalizar textos botón de pago
boolean
predeterminado:"false"
Permite definir el mensaje que acompaña el botón de pago en la conversación.Si se activa, habilita Header, Body y Footer cuando estén disponibles en tu versión del nodo.
Header
string
Título del mensaje del botón de pago.Se muestra cuando Personalizar textos botón de pago está activo y el campo está disponible en tu versión del nodo.
Body
string
Texto principal del mensaje del botón de pago.Se muestra cuando Personalizar textos botón de pago está activo y el campo está disponible en tu versión del nodo.
Contiene producto tangible
string
Define si la compra incluye un producto físico que requiere datos de envío.Si está en , el nodo exige completar los campos de envío. Si está en No, esos campos no son obligatorios.Usa solo cuando la compra incluya un producto físico que deba enviarse.
Si vendes servicios, productos digitales o cobros sin envío físico, selecciona No.
País de envío
string
Requerido cuando Contiene producto tangible está en . Indica el país de envío del producto según la dirección del comprador.
Estado de envío
string
Requerido cuando Contiene producto tangible está en . Indica el estado o provincia de envío según la dirección del comprador.
Ciudad de envío
string
Requerido cuando Contiene producto tangible está en . Indica la ciudad de envío según la dirección del comprador.
Dirección de envío
string
Requerido cuando Contiene producto tangible está en . Indica la dirección de envío del producto.
Código postal de envío
string
Requerido cuando Contiene producto tangible está en . Indica el código postal de envío según la dirección del comprador.
Motivo de pago
string
requerido
Describe el motivo del cobro (por ejemplo, orden, servicio o referencia interna).
Monto sujeto a impuestos
number
requerido
Monto sobre el que aplica el impuesto.
Monto libre de impuestos
number
requerido
Monto exento de impuestos.Si no aplica, usa 0.
Nombre(s) comprador
string
requerido
Nombre o nombres del comprador.
Apellido(s) comprador
string
requerido
Apellido o apellidos del comprador.
Email comprador
string
requerido
Correo del comprador que usará el checkout.En Sandbox, debe ser el email de una cuenta Sandbox Personal de PayPal. En producción, usa el email real del comprador.

Avanzado

El bloque Ambiente muestra si PayPal opera en Desarrollo o Producción.Si la integración está en Desarrollo, desde ahí puedes iniciar el flujo para Pasar a producción.Si la integración está en Producción, el bloque refleja que PayPal ya opera con credenciales productivas.
No pases a producción sin tener credenciales Live y webhook Live configurados en PayPal.
Experiencia de pago
string
predeterminado:"WebView"
Indica que el checkout de PayPal se abre como WebView embebido dentro de la experiencia conversacional.
Expiración del botón de pagos [minutos]
number
Define cuánto tiempo permanece vigente el botón de pago después de enviarlo.Los valores disponibles dependen de la configuración visible en Brain Studio.
Moneda
string
requerido
Define la moneda del cobro.Debe ser compatible con la configuración de la integración.
Porcentaje de IVA
number
requerido
Ingresa el porcentaje de IVA que se aplicará en el cálculo del pago.
Metadata del pago
string
Campo opcional para guardar una referencia interna (por ejemplo, ID de orden o correlativo de operación).
Guardar resultado como
string
Define el nombre de la variable donde Brain Studio guardará el JSON completo de respuesta del nodo.
Úsalo para trazabilidad, validaciones posteriores o decisiones del flujo.

Probar pagos en Sandbox

Si PayPal está conectado con credenciales de desarrollo/Sandbox, el checkout debe completarse con una cuenta compradora de prueba de PayPal. La cuenta Personal representa al comprador y la cuenta Business representa al comercio en pruebas.
Animación en PayPal Developer mostrando Sandbox Accounts, selección de una cuenta Personal y revisión de sus datos para usarla como comprador de prueba
1

Abrir Sandbox Accounts

En PayPal Developer Dashboard, ve a Testing ToolsSandbox Accounts.
2

Seleccionar una cuenta Personal

Elige una cuenta Personal de Sandbox y toma su email.Ese email será el comprador de prueba.
3

Revisar o cambiar la contraseña

Abre el detalle de la cuenta Personal y usa Change password si necesitas actualizarla.Para facilitar pruebas internas, puedes definir una contraseña temporal conocida por tu equipo de QA.
No uses esa contraseña en cuentas reales ni en producción.
4

Verificar el ambiente de desarrollo

En la pestaña Avanzado, confirma que PayPal esté operando en Desarrollo antes de ejecutar la prueba.
5

Configurar el Email comprador en el nodo

En el nodo de PayPal, usa el email de la cuenta Sandbox Personal en Email comprador o mapéalo desde una variable de prueba.
6

Probar desde WhatsApp

Dispara el flujo desde WhatsApp, abre el checkout WebView de PayPal e inicia sesión con la cuenta Sandbox Personal.
Animación del checkout WebView de PayPal abierto desde WhatsApp para completar un pago de prueba con una cuenta Sandbox Personal
7

Validar la salida del flujo

Verifica por qué salida continúa el flujo:
  • Pago exitoso
  • Pago pendiente
  • Pago fallido
  • Error
En Sandbox, el pago es ficticio y no mueve dinero real.

Pasar a producción

Si PayPal fue instalado con credenciales de desarrollo/Sandbox, puedes iniciar el paso a producción desde la pestaña Avanzado del nodo PayPal en Canvas o desde la página de PayPal en Marketplace. En ambos casos se abre el mismo modal para ingresar credenciales productivas y confirmar la configuración correspondiente. Antes de operar con pagos reales:
  • Asegúrate de tener credenciales Live y webhook Live correctamente configurados.
  • Usa el flujo Pasar a producción descrito en Conectar en Brain Studio.
  • Reemplaza en el nodo cualquier dato de prueba por datos reales del flujo.
  • En producción, usa el email real del comprador.
  • Ejecuta una prueba real de bajo monto antes de escalar.

Consideraciones importantes

Si instalaste PayPal con credenciales Sandbox/desarrollo, prueba con una cuenta compradora Sandbox.Si instalaste PayPal con credenciales Live/producción, usa datos reales de comprador.
En pruebas, el campo Email comprador debe pertenecer a una cuenta Sandbox Personal de PayPal.Si usas un email real en Sandbox, el checkout puede fallar o no continuar por la salida esperada.
En escenarios pendientes o fallidos, informa con claridad al usuario antes de iniciar un nuevo intento de cobro.Mantén una lógica de reintento controlada para evitar cobros repetidos.
El estado final del pago depende de los webhooks de PayPal configurados en el mismo ambiente que las credenciales usadas por el nodo.

Próximo paso

Cobertura y precios

Revisa disponibilidad, condiciones comerciales y consideraciones de operación por mercado.