Configuración de Deuna (Banco Pichincha)
Configure la conexión de la billetera Deuna respaldada por Banco Pichincha en DEUNA Admin.
En esta página
Descripción general#
Esta guía cubre la configuración del lado comercial de Deuna (Banco Pichincha) 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 el administrador de DEUNA
- Navegue al administrador de DEUNA
- Ingrese sus credenciales de comerciante
- Haga clic Iniciar sesión
Paso 2: navegue hasta Métodos de pago
- En la barra lateral izquierda, vaya a Conexiones
- Haga clic en Métodos de pago
- buscar Cartera Deuna en la lista. Este identificador de administrador se refiere a la billetera Deuna respaldada por el Banco Pichincha.
Configuración inicial#
Habilitación de Deuna (Banco Pichincha)
si Deuna (Banco Pichincha) aún no está habilitado:
- encontrar Cartera Deuna en la lista de Métodos de pago. Esta es la etiqueta de administrador para la conexión de Deuna (Banco Pichincha).
- Haga clic Habilitar o Añadir
- Se abrirá un panel de configuración con un formulario para agregar el procesador
- Complete todo cuatro campos de credenciales requeridos (ver sección a continuación)
- Selecciona tu preferido modo de pago (ver sección a continuación)
- Haga clic Guardar
El método de pago ahora está activo y aparecerá como una opción para sus clientes al momento de pagar.
Agregando el Procesador Deuna (Banco Pichincha)
Cuando habilitas Deuna (Banco Pichincha), deberás agregar el procesador con las credenciales de tu cuenta de Deuna (Banco Pichincha).
Para agregar el procesador:
- En el panel de configuración de Deuna (Banco Pichincha)
- Haga clic Agregar procesador o Configurar credenciales
- Complete los cuatro campos obligatorios:
Campos obligatorios
| campo | Descripción | Ejemplo | Notas |
|---|---|---|---|
| Public API Key | Denominada “Clave API” en Deuna (Banco Pichincha) | pub_abc123xyz789 | Mapas al encabezado x-api-key |
| Private API Key | Denominada “API Secreta” en Deuna (Banco Pichincha) | sec_abc123xyz789 | Mapas al encabezadox-api-secret |
| Punto de Venta (CAJA) | Llamado "CAJA" en Deuna (Banco Pichincha) | 4200069 | Identificador de cadena para su punto de venta |
| Formato | Tipo de código de pago | QR o CODIGO_6_DIGITOS | Determina si los clientes obtienen un código QR o de 6 dígitos |
Formulario paso a paso
Importante:
- Los cuatro campos son requerido
- Tus credenciales provienen de tu cuenta comercial de Deuna (Banco Pichincha)
- 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
| Aspecto | Código numérico (CODIGO_6_DIGITOS) | Código QR |
|---|---|---|
| El cliente ve | código de 6 dígitos | Código QR dinámico |
| ventana de tiempo | 3 minutos | 15 minutos |
| como pagar | Escribe en la aplicación | Escanee o haga clic |
| Lo mejor para | Pago de computadora de escritorio/tableta | Pago desde el móvil |
| Experiencia de usuario | Se requiere entrada manual | Rápido, con un solo toque/escaneo |
| Valor de campo | CODIGO_6_DIGITOS | QR |
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:
- El cliente ve un código grande de 6 dígitos
- El código caduca en exactamente 3 minutos.
- El cliente debe abrir la aplicación Deuna e ingresar el código manualmente
- Después de ingresar, el cliente confirma en la aplicación.
- DEUNA procesa el estado de pago final de forma asíncrona
Para seleccionar este formato:
- En forma de procesador
- bajo Formato, seleccione Código numérico (CODIGO_6_DIGITOS)
- 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:
- El cliente ve un código QR dinámico
- El código QR es válido por exactamente 15 minutos
- El cliente puede:
- Escanear con la cámara de la aplicación Deuna
- Haga clic para abrir la aplicación directamente
- DEUNA procesa el estado de pago final de forma asíncrona
Para seleccionar este formato:
- En forma de procesador
- bajo Formato, seleccione Código QR
- 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 Deuna Wallet 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 (Banco Pichincha) esté aprovisionado para su cuenta.
Problema: el procesador no guarda o muestra un error
Solución:
- 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)
- Verifica que las credenciales de tu cuenta en Deuna (Banco Pichincha) sean correctas
- Primero pruebe sus credenciales en el panel de control de Deuna (Banco Pichincha)
- Inténtalo de nuevo en un navegador diferente
- Póngase en contacto con el soporte de DEUNA si el problema persiste
Problema: Los clientes no pueden ver a Deuna (Banco Pichincha) al momento de pagar
Verificar:
- Cartera Deuna es Habilitado (no deshabilitado) en DEUNA Admin
- El procesador está configurado correctamente (los cuatro campos completados)
- El pedido del cliente está en USD moneda
- El cliente está en Ecuador (o utilizando la dirección de facturación de Ecuador)
- El widget de pago incluye
deuna_walletprocesador - 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 (Banco Pichincha), su cuenta de usuario debe tener:
- Conexiones - Permiso de lectura/escritura
- Métodos de pago - Permiso de lectura/escritura
Si no tienes permisos:
- Pregúntele al propietario o administrador de su cuenta
- Pueden otorgar permisos en Roles y permisos de usuario sección
Configuración de múltiples administradores
Si varios administradores gestionan los pagos:
- Todos los cambios de configuración son visibles para todos los administradores.
- Cualquier administrador puede cambiar el modo de pago (no recomendado sin comunicación)
- Habilite los registros de auditoría para realizar un seguimiento de los cambios:
- Ir a Roles y permisos de usuario
- Habilitar Registro de actividad
Mejores prácticas#
Configuración
✅ Hacer:
- Pruebe la finalización del pago asincrónico 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:
- Desactiva Deuna (Banco Pichincha) sin avisar a tu equipo
- Cambiar frecuentemente los modos de pago sin motivo
- Supongamos que la selección de modo se puede anular por orden (no se puede)
Monitoreo
✅ Hacer:
- Verifique las métricas de pago semanalmente
- Revisar periódicamente los estados de pago no resueltos
- Monitorear las solicitudes de reembolso para detectar tendencias
- Pruebe la finalización de pagos asincrónicos con regularidad
❌ No:
- Ignorar estados de pago no resueltos durante períodos prolongados
- Omitir las pruebas de incorporación de comerciantes