Saltar al contenido principal
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

  1. Navegue al administrador de DEUNA
  2. Ingrese sus credenciales de comerciante
  3. Haga 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 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:

  1. 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).
  2. Haga 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. 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:

  1. En el panel de configuración de Deuna (Banco Pichincha)
  2. Haga clic Agregar procesador o Configurar credenciales
  3. Complete los cuatro campos obligatorios:

Campos obligatorios

campoDescripciónEjemploNotas
Public API KeyDenominada “Clave API” en Deuna (Banco Pichincha)pub_abc123xyz789Mapas al encabezado x-api-key
Private API KeyDenominada “API Secreta” en Deuna (Banco Pichincha)sec_abc123xyz789Mapas al encabezadox-api-secret
Punto de Venta (CAJA)Llamado "CAJA" en Deuna (Banco Pichincha)4200069Identificador de cadena para su punto de venta
FormatoTipo de código de pagoQR o CODIGO_6_DIGITOSDetermina 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

AspectoCódigo numérico (CODIGO_6_DIGITOS)Código QR
El cliente vecódigo de 6 dígitosCódigo QR dinámico
ventana de tiempo3 minutos15 minutos
como pagarEscribe en la aplicaciónEscanee o haga clic
Lo mejor paraPago de computadora de escritorio/tabletaPago desde el móvil
Experiencia de usuarioSe requiere entrada manualRápido, con un solo toque/escaneo
Valor de campoCODIGO_6_DIGITOSQR

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. DEUNA procesa el estado de pago final de forma asíncrona

Para seleccionar este formato:

  1. En forma de procesador
  2. bajo Formato, seleccione 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
    • Haga clic para abrir la aplicación directamente
  4. DEUNA procesa el estado de pago final de forma asíncrona

Para seleccionar este formato:

  1. En forma de procesador
  2. bajo Formato, seleccione 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 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:

  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. Verifica que las credenciales de tu cuenta en Deuna (Banco Pichincha) sean correctas
  3. Primero pruebe sus credenciales en el panel de control de Deuna (Banco Pichincha)
  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 a Deuna (Banco Pichincha) al momento de pagar

Verificar:

  1. Cartera Deuna es Habilitado (no deshabilitado) en DEUNA Admin
  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 (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:

  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:
    • 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