Skip to main content
Una vez conectada la integración, el nodo de Payphone 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, comienza por 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 Payphone.
2

Agregar el nodo Payphone

Agrega Payphone 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 Payphone 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. Completa las pestañas Datos del pago y Avanzado, y revisa las salidas disponibles en el nodo del Canvas.Si faltan campos obligatorios, el nodo muestra el aviso Configuración incompleta. Revisa los campos del nodo. y el badge de ambiente (Desarrollo o Producción).

​
Configurar el nodo

Nodo Payphone en Canvas con la pestaña Datos del pago abierta en el panel lateral

Pestaña Datos del pago: personalización, montos y datos del comprador

​
boolean
predeterminado:"false"
Actívalo para definir los mensajes que acompañan tu botón de pago.Si está activo, habilita los campos Header, Body y Footer.
​
string
Título del mensaje del botón de pago.Se muestra cuando Personalización está activa.
​
string
Texto principal del mensaje del botón de pago.Se muestra cuando Personalización está activa.
​
string
requerido
Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna.
​
number
requerido
Monto sobre el que aplica IVA. Solo números, en dólares (USD).
​
number
requerido
Monto exento de impuestos. Solo números. Si no aplica, usa 0.
​
string
requerido
Nombre del comprador que usará el checkout.En Desarrollo, puedes usar datos de prueba. En Producción, usa el nombre real capturado en el flujo.
​
string
requerido
Apellido del comprador que usará el checkout.En Desarrollo, puedes usar datos de prueba. En Producción, usa el apellido real capturado en el flujo.
​
string
requerido
Correo del comprador que usará el checkout.En Producción, usa el email real del comprador capturado en el flujo.

​
Salidas del nodo

Las salidas aparecen en el nodo de Payphone en Canvas. Conéctalas según el resultado que quieras manejar en tu flujo.
Se activa cuando Payphone confirma que la transacción fue aprobada.Recomendaciones:
  • confirmar la orden
  • emitir comprobante o notificación
  • actualizar estado de compra en tus sistemas
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
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 botón de pago fue enviado en WhatsApp.Puedes conectar esta salida a un AI Agent de soporte post-envío del mensaje de pago para asistir al usuario mientras decide abrir el checkout o si tiene dudas antes de pagar.Recomendaciones:
  • resolver dudas sobre cómo abrir el botón de pago
  • ayudar si el WebView no carga
  • no confirmar pagos desde esta salida
Se activa cuando la transacción fue rechazada, declinada o no se completa.Recomendaciones:
  • permitir reintento controlado
  • ofrecer ruta de soporte o un camino alterno
Se activa ante errores técnicos, errores del proveedor o fallas de comunicación durante la creación o el procesamiento del pago.Recomendaciones:
  • registrar el error
  • mostrar mensaje de contingencia
  • reintentar de forma controlada y escalar si persiste

​
Probar pagos

Si Payphone está conectado en entorno de prueba, valida el flujo antes de pasar a producción.
En modo prueba, el cobro depende de que la aplicación en Payphone Developer esté en Prueba y el nodo en Desarrollo. Payphone usa las mismas credenciales en ambos escenarios.
1

Confirmar entorno en Brain Studio

Verifica que la integración esté instalada en entorno de prueba y que el nodo muestre ambiente Desarrollo en la pestaña Avanzado.
2

Alinear Payphone Developer

En el portal de Payphone Developer, selecciona Prueba en el selector de entorno de tu aplicación.Revisa Obtención de credenciales — Modo prueba y producción.
3

Completar datos del comprador

En Datos del pago, ingresa Nombre(s) comprador, Apellido(s) comprador y Email comprador con datos de prueba o variables del flujo.
4

Probar desde WhatsApp

Dispara el flujo desde WhatsApp, abre el checkout WebView de Payphone y completa el pago de prueba.
5

Validar la salida del flujo

Verifica por qué salida continúa el flujo:
  • Mensaje de pago enviado (solo envío del botón)
  • Pago exitoso
  • Pago pendiente
  • Pago fallido
  • Error

​
Pasar a producción

Si instalaste Payphone en entorno de prueba, puedes iniciar el paso a producción desde la pestaña Avanzado del nodo Payphone en Canvas o desde la página de Payphone en Marketplace. El modal solo pide confirmación: las credenciales actuales se mantienen. Detalle en Conectar en Brain Studio — Pasar a producción. Antes de operar con pagos reales:
  • Cambia la aplicación en Payphone Developer a Producción.
  • Confirma que Porcentaje de IVA y Moneda (USD) en el nodo sean coherentes con tu operación.
  • Reemplaza datos de prueba por datos reales del comprador (nombre, apellido, email).
  • Recuerda el costo de $0.10 USD por transacción en producción, descontado de tu saldo en Brain Studio.
  • Ejecuta una prueba real de bajo monto antes de escalar.

​
Consideraciones importantes

Para que el cobro funcione correctamente, alinea:
  1. Entorno de la instalación en Brain Studio (prueba o producción)
  2. Ambiente del nodo (Desarrollo o Producción)
  3. Selector Prueba / Producción en Payphone Developer
Si uno no coincide, el flujo puede fallar o dar resultados inconsistentes.
El Token y el Store ID no cambian entre prueba y producción. Pasar a producción en Brain Studio no reemplaza credenciales; solo cambia el modo de operación.
Payphone requiere nombre, apellido y email del comprador en Datos del pago. En producción, usa datos reales capturados en el flujo.
El IVA aplicado se define al instalar la integración. El Porcentaje de IVA del nodo debe ser coherente. La moneda es USD.
Si un pago queda pendiente, informa al usuario y evita iniciar un segundo cobro hasta resolver el estado. El flujo continuará por Pago exitoso o Pago fallido cuando Payphone actualice el resultado.

​
Próximo paso

Cobertura y precios

Revisa disponibilidad, medios de pago y tarifas referenciales de Payphone.