Configuración de la billetera de la aplicación DEUNA

Descripción general#

Esta guía cubre la configuración del lado comercial de Monedero de la aplicación Deuna en el Panel de administración de Deuna. La configuración es una configuración única que determina qué modo de pago utilizarán sus clientes.

Accediendo a la configuración#

Paso 1: inicie sesión en Deuna Admin

1. Navegue al administrador de DEUNA
2. Ingrese sus credenciales de comerciante
3. Clic Iniciar sesión

Paso 2: navegue hasta Métodos de pago

1. En la barra lateral izquierda, vaya a Conexiones
2. Haga clic en Métodos de pago
3. buscar Monedero de la aplicación Deuna en la lista

Configuración inicial#

Habilitación de la billetera de la aplicación Deuna

si Monedero de la aplicación Deuna aún no está habilitado:

1. encontrar Monedero de la aplicación Deuna en la lista de métodos de pago
2. Clic Habilitar o Añadir
3. Se abrirá un panel de configuración con un formulario para agregar el procesador
4. Complete todo cuatro campos de credenciales requeridos (ver sección a continuación)
5. Selecciona tu preferido modo de pago (ver sección a continuación)
6. Clic Guardar

El método de pago ahora está activo y aparecerá como una opción para sus clientes al momento de pagar.

Agregar el procesador de billetera de la aplicación Deuna

Cuando habilitas Monedero de la aplicación Deuna, debes agregar el procesador con las credenciales de tu cuenta de Deuna App Wallet.

Para agregar el procesador:

1. En el panel de configuración de Deuna App Wallet
2. Clic Agregar procesador o Configurar credenciales
3. Complete los cuatro campos obligatorios:

Campos obligatorios

Formulario paso a paso

Ampliar

Importante:

• Los cuatro campos son requerido
• Sus credenciales provienen de su cuenta comercial Deuna App Wallet
• La selección de formato aquí determina el modo de pago para todos los pedidos.
• Después de guardar, las credenciales se cifran y se almacenan de forma segura

Elegir su formato de pago#

Al completar el formulario del procesador, debe seleccionar su formato de pago. Esta elección se realiza al agregar credenciales y determina cómo interactuarán sus clientes con el flujo de pago.

Guía de selección de formato

Formato 1: Código Numérico (CODIGO_6_DIGITOS, 3 Minutos)

Elija esto si:

• Sus clientes utilizan principalmente computadoras de escritorio o tabletas
• Quieres una ventana de transacción rápida
• Su flujo de pago se ejecuta en varios tipos de dispositivos
• Prefieres la simplicidad y las dependencias mínimas.

Cómo funciona:

1. El cliente ve un código grande de 6 dígitos
2. El código caduca en exactamente 3 minutos.
3. El cliente debe abrir la aplicación Deuna e ingresar el código manualmente
4. Después de ingresar, el cliente confirma en la aplicación.
5. Pago confirmado mediante webhook

Para seleccionar este formato:

1. En forma de procesador
2. Bajo Formato, selecciona Código numérico (CODIGO_6_DIGITOS)
3. Complete el formulario y haga clic Guardar procesador

Verificación:

• Una vez guardado, verás un mensaje de confirmación.
• Todos los pedidos posteriores utilizarán códigos numéricos de 6 dígitos.

Formato 2: Código QR (15 Minutos)

Elija esto si:

• Sus clientes son principalmente usuarios de dispositivos móviles
• Quiere una ventana de transacción más larga para mayor flexibilidad
• Prefieres una experiencia moderna con un solo toque
• El escaneo QR es común en su mercado objetivo

Cómo funciona:

1. El cliente ve un código QR dinámico
2. El código QR es válido por exactamente 15 minutos
3. El cliente puede:
   • Escanear con la cámara de la aplicación Deuna
   • Clic para abrir la aplicación directamente
4. Pago confirmado mediante webhook

Para seleccionar este formato:

1. En forma de procesador
2. Bajo Formato, selecciona Código QR
3. Complete el formulario y haga clic Guardar procesador

Verificación:

• Una vez guardado, verás un mensaje de confirmación.
• Todos los pedidos posteriores utilizarán códigos QR.

Panel de configuración#

Configuración de solución de problemas

Problema: No puedo encontrar la billetera de la aplicación Deuna en la lista de métodos de pago

Solución:

• Actualizar la página
• Comprueba que tienes el permiso "Pagos" en tu rol de usuario
• Comuníquese con el soporte de Deuna para asegurarse de que Deuna App Wallet esté disponible para su cuenta.

Problema: el procesador no guarda o muestra un error

Solución:

1. Verifique que los cuatro campos de credenciales estén completos:
   • Clave API pública (no vacía)
   • Clave API privada (no vacía)
   • Punto de Venta/CAJA (no vacío, cadena numérica)
   • Formato seleccionado (QR o Código Numérico)
2. Verifique que las credenciales sean correctas desde su cuenta de Deuna App Wallet
3. Pruebe primero sus credenciales en el panel de Deuna App Wallet
4. Inténtalo de nuevo en un navegador diferente
5. Póngase en contacto con el soporte de Deuna si el problema persiste

Problema: los clientes no pueden ver la billetera de la aplicación Deuna al momento de pagar

Verificar:

1. La billetera de la aplicación Deuna es Habilitado (no deshabilitado)
2. El procesador está configurado correctamente (los cuatro campos completados)
3. El pedido del cliente está en USD moneda
4. El cliente está en Ecuador (o utilizando la dirección de facturación de Ecuador)
5. El widget de pago incluye deuna_wallet procesador
6. El token de pedido se generó correctamente

Si todo verificado:

• Contacta con el soporte de Deuna

Permisos y acceso#

Funciones de administrador requeridas

Para configurar Deuna App Wallet, su cuenta de usuario debe tener:

• Conexiones - Permiso de lectura/escritura
• Métodos de pago - Permiso de lectura/escritura
• Ganchos web - Permiso de lectura/escritura (para configuración de webhook)

Si no tienes permisos:

1. Pregúntele al propietario o administrador de su cuenta
2. Pueden otorgar permisos en Roles y permisos de usuario sección

Configuración de múltiples administradores

Si varios administradores gestionan los pagos:

1. Todos los cambios de configuración son visibles para todos los administradores.
2. Cualquier administrador puede cambiar el modo de pago (no recomendado sin comunicación)
3. Habilite los registros de auditoría para realizar un seguimiento de los cambios:
   • Vaya a Roles y permisos de usuario
   • Habilitar Registro de actividad

Mejores prácticas#

Configuración

✅ Hacer:

• Pruebe la conectividad del webhook después de la configuración
• Elija el modo de pago según su base de clientes
• Revisar las limitaciones de reembolso antes de habilitar
• Documente su elección de modo para su equipo

❌ No:

• Desactive Deuna App Wallet sin notificar a su equipo
• Cambiar frecuentemente los modos de pago sin motivo
• Compartir URL de webhooks en canales no seguros
• Supongamos que la selección de modo se puede anular por orden (no se puede)

Monitoreo

✅ Hacer:

• Verifique las métricas de pago semanalmente
• Revise los registros de entrega de webhooks con regularidad
• Monitorear las solicitudes de reembolso para detectar tendencias
• Pruebe la conectividad del webhook mensualmente

❌ No:

• Ignorar las fallas del webhook durante períodos prolongados
• Omitir las pruebas de incorporación de comerciantes
• Olvídese de actualizar la URL del webhook si su backend cambia