Agrega el nodo de Deuna a tu flujo en Canvas y configura sus inputs y outputs.
Una vez conectada la integración en Marketplace con el Punto de Venta, el Api Key, el Api Secret, el IVA y la Moneda, el nodo de Deuna queda disponible en tu workspace para usarlo dentro de tus flujos en Canvas.El nodo procesa el pago a través de Deuna y expone el estado final de la transacción para que tu flujo continúe según el resultado.
En el panel lateral izquierdo de Brain Studio, abre la carpeta Marketplace.Si la integración está correctamente conectada, verás Deuna listado como proveedor disponible.
Deuna disponible en el panel lateral de Marketplace
2
Arrastrar el nodo al Canvas
Arrastra Deuna desde el panel lateral hacia tu flujo en el Canvas.Al soltarlo, se creará el bloque del nodo con sus salidas disponibles.
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 ahí podrás completar los inputs y revisar las salidas disponibles.
Define el entorno en el que se ejecutará el cobro.Valores disponibles:DEV, PROD
El ambiente debe coincidir con las credenciales utilizadas al conectar Deuna en Marketplace.Si usas credenciales de desarrollo con PROD, o viceversa, el pago no se procesará correctamente.
Texto principal del mensaje que acompaña al botón de pago.
Footer
Pago Exitoso
Se activa cuando Deuna 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
Pago Fallido
Se activa cuando la transacción fue rechazada o declinada.Recomendaciones:
informar al usuario
permitir reintento
redirigir a otro medio de pago
Error Code
Se activa cuando Deuna devuelve un código de error interno durante la creación o el procesamiento del pago.
Error HTTP
Se activa cuando ocurre un error de comunicación con el proveedor, como timeout, problemas de red o respuestas inválidas.
Envío correcto de CTA
Se activa cuando el botón de pago fue enviado correctamente en la conversación.Esta salida no confirma el pago. Solo indica que el usuario ya recibió el CTA y puede continuar el proceso en la wallet de Deuna.Recomendación de implementación:
Conecta esta salida a un AI Agent o a un bloque de soporte conversacional. Así, si el usuario tiene dudas o necesita ayuda mientras completa el pago, la conversación no pierde continuidad.Ejemplos de uso:
responder preguntas sobre el pago
indicar que el usuario debe completar la transacción en la wallet de Deuna
acompañar mientras llega la confirmación del proveedor
Esta salida es útil para mantener el hilo conversacional activo entre el envío del botón y la confirmación final del pago.
Ejemplo de prompt para AI Agent de soporte post-CTA:
Eres un asistente de ayuda para pagos.Tu función es acompañar al usuario después de que recibió el botón de pago, resolver dudas breves y mantener la conversación activa mientras Deuna confirma el resultado.Reglas:- No recalcules montos- No generes nuevos enlaces- No prometas aprobaciones- Si el usuario dice que ya pagó, indícale que espere la confirmación- Si el usuario tiene dudas, responde de forma breve y clara- Si detectas un problema, ofrece ayuda o deriva a soporte
El ambiente del nodo debe coincidir con las credenciales
El ambiente configurado en el nodo (DEV o PROD) debe coincidir con las credenciales utilizadas al conectar Deuna.Si no coinciden, el pago no se procesará correctamente.
Manejo de estado del pago
En pagos con Deuna, el usuario completa la transacción en la wallet del proveedor.En algunos casos, el pago puede quedar momentáneamente en estado pendiente. En ese caso:
el usuario recibe una notificación en la conversación
el flujo queda a la espera de la confirmación
Cuando Deuna confirma el resultado final, el flujo continúa automáticamente por:
Pago Exitoso
Pago Fallido
El estado pendiente no se expone como una salida independiente del nodo.
