> ## 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 y configura sus inputs y outputs.
Una vez conectada la integración en Marketplace con el **Token de acceso**, el **Store ID**, el **IVA** y la **Moneda**, el nodo de **Payphone** queda disponible en tu workspace para usarlo dentro de tus flujos en Canvas.
***
## Agregar el nodo al Canvas
En el panel lateral izquierdo de Brain Studio, abre la carpeta **Marketplace**.
Si la integración está correctamente conectada, verás **Payphone** listado como proveedor disponible.
Arrastra **Payphone** desde el panel lateral hacia tu flujo en el Canvas.
Al soltarlo, se creará el bloque del nodo con sus salidas disponibles.
Selecciona el nodo en el Canvas para abrir su panel de configuración en el lado derecho.
Desde ahí podrás completar los **inputs** y revisar las **salidas** disponibles.
***
## Configurar el nodo
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).
Define la modalidad del cobro.
Para esta integración, el valor por defecto es `payment`.
Define el entorno en el que se ejecutará el cobro.
**Valores disponibles:** `DEV`, `PROD`
El valor configurado aquí debe coincidir con el entorno seleccionado en la aplicación dentro de **Payphone Developer**.
Si configuras `DEV` en el nodo pero la aplicación está en producción, o viceversa, el flujo puede fallar o generar resultados inconsistentes.
Define la vigencia del botón de pago desde que se envía al usuario.
**Valores disponibles:** `10`, `20`, `30`, `60`
Texto descriptivo del cobro.
Ejemplos:
* número de orden
* nombre del producto o servicio
* referencia interna del pago
Ingresa el monto a cobrar que está sujeto a impuestos.
Acepta valores numéricos en dólares, incluyendo decimales cuando corresponda.
Ingresa el monto a cobrar que está libre de impuestos.
Acepta valores numéricos en dólares, incluyendo decimales cuando corresponda.
Información adicional para trazabilidad o referencia interna.
Puedes usar este campo para correlacionar el pago con una orden, una cotización o una operación de conciliación.
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)
Cuando esta opción está activa, puedes modificar completamente el mensaje que verá el usuario antes de abrir el checkout.
Título del mensaje que acompaña al botón de pago.
Texto principal del mensaje que acompaña al botón de pago.
Texto de cierre o aclaración del mensaje que acompaña al botón de pago.
Se activa cuando Payphone confirma que la transacción fue procesada correctamente.
Este es el punto oficial de confirmación del pago dentro del flujo.
Ejemplos de uso:
* emitir factura
* activar una suscripción
* liberar un producto o servicio
* actualizar el estado de una orden en un sistema externo
Se activa cuando la transacción fue rechazada o declinada.
Recomendaciones:
* informar al usuario
* permitir un reintento
* redirigir a otro medio de pago
Se activa cuando Payphone devuelve un código de error interno durante la creación o el procesamiento del pago.
Se activa cuando ocurre un error de comunicación con el proveedor, por ejemplo un timeout, un problema de red o una respuesta inválida.
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. Desde esta salida puedes conectar un nodo de espera o un mensaje que indique al usuario que ya puede completar el pago.
***
## Consideraciones importantes
Si configuras el nodo en `DEV`, la aplicación en **Payphone Developer** también debe estar en **Prueba**.
Si configuras el nodo en `PROD`, la aplicación en **Payphone Developer** debe estar en **Producción**.
Cuando un pago queda inicialmente pendiente, el agente informa ese estado al usuario mediante el mensaje correspondiente.
Si luego Payphone actualiza el resultado, el flujo continúa por la salida final que corresponda:
* **Pago Exitoso**
* **Pago Fallido**
El estado pendiente no se expone como una salida independiente del nodo.