> ## 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 Payphone a tu flujo en Canvas, configura sus campos y prueba pagos. 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. > [!TIP] > > Si todavía no instalaste la integración, comienza por [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/payphone/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 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 > [tab] Datos del pago > > ![Nodo Payphone en Canvas con la pestaña Datos del pago abierta en el panel lateral](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/payphone-nodo-datos-del-pago.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=c7d133f60651d751ed0d4df4928289f3) > > Pestaña Datos del pago: personalización, montos y datos del comprador > > > [accordion] Personalización > > > > **Personalización** `boolean` (default: 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**. > > > [accordion] Header > > > > **Header** `string` > > > > Título del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. > > > [accordion] Body > > > > **Body** `string` > > > > Texto principal del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. > > > [accordion] Footer > > > > **Footer** `string` > > > > Texto de cierre del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. > > > [accordion] Motivo de pago > > > > **Motivo de pago** `string` *required* > > > > Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna. > > > [accordion] Monto sujeto a impuestos > > > > **Monto sujeto a impuestos** `number` *required* > > > > Monto sobre el que aplica IVA. Solo números, en dólares (USD). > > > [accordion] Monto libre de impuestos > > > > **Monto libre de impuestos** `number` *required* > > > > Monto exento de impuestos. Solo números. Si no aplica, usa `0`. > > > [accordion] Nombre(s) comprador > > > > **Nombre(s) comprador** `string` *required* > > > > 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. > > > [accordion] Apellido(s) comprador > > > > **Apellido(s) comprador** `string` *required* > > > > 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. > > > [accordion] Email comprador > > > > **Email comprador** `string` *required* > > > > Correo del comprador que usará el checkout. > > > > En **Producción**, usa el email real del comprador capturado en el flujo. > [tab] Avanzado > > ![Nodo Payphone con la pestaña Avanzado abierta mostrando ambiente, moneda USD e IVA](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/payphone-nodo-avanzado.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=18a2170a84af1ecba7c7defb942d0234) > > Pestaña Avanzado: ambiente, expiración, moneda e IVA > > > [accordion] Ambiente > > > > Muestra si Payphone 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] > > > > > > Payphone usa las **mismas credenciales** en ambos modos. El ambiente en Brain Studio debe coincidir con el selector **Prueba / Producción** de tu aplicación en **Payphone Developer**. > > > [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. > > > > Selecciona una opción del listado disponible en Brain Studio. > > > [accordion] Moneda > > > > **Moneda** `string` *required* > > > > Moneda del cobro. Para Payphone en Ecuador, el valor es **USD**. > > > [accordion] Porcentaje de IVA > > > > **Porcentaje de IVA** `number` > > > > Porcentaje de IVA aplicado a la operación. > > > > Debe ser coherente con el **IVA aplicado** configurado al instalar la integración en [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/payphone/conectar-en-brain-studio.md). > > > [accordion] Metadatos del pago > > > > **Metadatos del pago** `string` > > > > Campo opcional para guardar referencia interna como ID de orden, correlativo o user ID. *** ## 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. > [accordion] Pago exitoso > > 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 > [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 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 > [accordion] Pago fallido > > 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 > [accordion] Error > > 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. > [!NOTE] > > 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/payphone/obtener-credenciales.md#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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/payphone/conectar-en-brain-studio.md#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 > [accordion] Tres puntos deben coincidir > > 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. > [accordion] Mismas credenciales siempre > > 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. > [accordion] Datos del comprador obligatorios > > Payphone requiere **nombre**, **apellido** y **email** del comprador en **Datos del pago**. En producción, usa datos reales capturados en el flujo. > [accordion] IVA y moneda > > El **IVA aplicado** se define al instalar la integración. El **Porcentaje de IVA** del nodo debe ser coherente. La moneda es **USD**. > [accordion] Pagos pendientes > > 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 > [card] [Cobertura y precios](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/payphone/cobertura-y-precios.md) > > Revisa disponibilidad, medios de pago y tarifas referenciales de Payphone. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.