configurazione del portafoglio di DEUNA App
In questa pagina
Panoramica#
Questa guida copre la configurazione del lato mercantile Portafoglio Deuna App nel pannello di amministrazione Deuna. La configurazione è una configurazione a una volta che determina quale modalità di pagamento i clienti utilizzeranno.
Accesso alla configurazione#
Passo 1: Accedi a Deuna Admin
- Passare all'Amministratore di DEUNA
- Inserisci le credenziali del commerciante
- Cliccare su Accedi
Passo 2: Passare ai metodi di pagamento
- Nella barra laterale sinistra, vai a Collegamenti
- Clicca su Metodi di pagamento
- Cercare Portafoglio Deuna App nella lista
Impostazione iniziale#
Abilitare Deuna App Wallet
Se Portafoglio Deuna App non è ancora abilitato:
- Trova Portafoglio Deuna App nell'elenco dei metodi di pagamento
- Cliccare su Abilita' o Aggiungi
- Un pannello di configurazione si aprirà con un modulo per aggiungere il processore
- Riempire tutti quattro campi obbligatori (vedere sezione sotto)
- Seleziona il tuo preferito modalità di pagamento (vedere sezione sotto)
- Cliccare su Salva
Il metodo di pagamento è ora attivo e apparirà come opzione per i vostri clienti al momento del checkout.
Aggiungere il processore Deuna App Wallet
Quando si attiva Portafoglio Deuna App, è necessario aggiungere il processore con le credenziali dal tuo account Deuna App Wallet.
Per aggiungere il processore:
- Nel pannello di configurazione Deuna App Wallet
- Cliccare su Aggiungere processore o Configurare le credenziali
- Compila tutti e quattro i campi richiesti:
Campi obbligatori
| Campo | Descrizione | Esempio | Note |
|---|---|---|---|
| Public API Key | Chiamato "API Key" nel Portafoglio di Deuna App | pub_abc123xyz789 | Mappe all'intestazione x-api-key |
| Private API Key | Chiamato "API Secret" in Deuna App Wallet | sec_abc123xyz789 | Mappe all'intestazionex-api-secret |
| Punto vendita (CAJA) | Chiamato "CAJA" nel Portafoglio di Deuna App | 4200069 | Identificatore di stringa per il punto vendita |
| Formato | Tipo di codice di pagamento | QR o CODIGO_6_DIGITOS | Determina se i clienti ottengono QR o 6 cifre |
Modulo passo per passo
Importante:
- Tutti e quattro i campi sono richiesto
- Le credenziali provengono dal tuo account business Deuna App Wallet
- La selezione dei formati determina la modalità di pagamento per tutti gli ordini
- Dopo il salvataggio, le credenziali vengono crittografate e memorizzate in modo sicuro
Scegliere il formato di pagamento#
Quando si compila il modulo del processore, è necessario selezionare il formato di pagamentoQuesta scelta viene fatta quando si aggiungono le credenziali e determina come i vostri clienti interagiranno con il flusso di pagamento.
Guida alla selezione del formato
| Aspetti | Codice numerico (CODIGO 6 DIGITOS) | Codice QR QR |
|---|---|---|
| Il cliente vede | 6 cifre | Codice QR dinamico |
| Finestra del tempo | 3 minuti | 15 minuti |
| Come pagare | Digitare l'app | Scansione o click |
| Ideale per | Checkout desktop/tablet | Controllo mobile |
| Esperienza utente | Ingresso manuale richiesto | Veloce, one-tap/scan |
| Valore di campo | CODIGO_6_DIGITOS | QR |
Formato 1: Codice Numerico (CODIGO 6 DIGITOS, 3 Minuti)
Scegli questo se:
- I vostri clienti utilizzano principalmente desktop/tablet
- Vuoi una finestra di transazione rapida
- Il flusso di controllo viene eseguito su più tipi di dispositivo
- Preferisci semplicità e dipendenze minime
Come funziona:
- Il cliente vede un grande codice a 6 cifre
- Il codice scade esattamente in 3 minuti
- Il cliente deve aprire Deuna App e inserire manualmente il codice
- Dopo l'inserimento, il cliente conferma nell'app
- Pagamento confermato tramite webhook
Per selezionare questo formato:
- Nel modulo del processore
- Sottotitoli Formato, selezionare Codice numerico (CODIGO 6 DIGITOS)
- Completa il modulo e clicca Salva processore
Verifica:
- Una volta salvato, vedrai un messaggio di conferma
- Tutti gli ordini successivi utilizzeranno i codici numerici a 6 cifre
Formato 2: Codice QR (15 Minuti)
Scegli questo se:
- I tuoi clienti sono principalmente utenti mobili
- Si desidera una finestra di transazione più lunga per flessibilità
- Preferisci un'esperienza moderna e one-tap
- La scansione QR è comune nel mercato target
Come funziona:
- Il cliente vede un codice QR dinamico
- Codice QR è valido per esattamente 15 minuti
- Il cliente può:
- Scansione con la fotocamera Deuna App
- Cliccare su per aprire l'app direttamente
- Pagamento confermato tramite webhook
Per selezionare questo formato:
- Nel modulo del processore
- Sottotitoli Formato, selezionare Codice QR QR
- Completa il modulo e clicca Salva processore
Verifica:
- Una volta salvato, vedrai un messaggio di conferma
- Tutti gli ordini successivi useranno i codici QR
Pannello di configurazione#
Risoluzione dei problemi di configurazione
Problema: Non riesco a trovare Deuna App Wallet in Metodi di pagamento Lista
Soluzione:
- Aggiorna la pagina
- Controllare che hai il permesso "Pagamenti" nel tuo ruolo utente
- Contatta il supporto Deuna per garantire che Deuna App Wallet sia fornito per il tuo account
Problema: il processore non salverà o mostra l'errore
Soluzione:
- Verificare tutti e quattro i campi delle credenziali sono riempiti:
- Chiave API pubblica (non vuota)
- Chiave API privata (non vuota)
- Punto vendita / CAJA (non vuoto, stringa numerica)
- Formato selezionato (QR o Codice Numerico)
- Controlla che le credenziali siano corrette dal tuo account Deuna App Wallet
- Prova le tue credenziali nel cruscotto Deuna App Wallet prima
- Prova di nuovo in un browser diverso
- Contattare il supporto Deuna se persiste il problema
Problema: i clienti non possono vedere Deuna App Wallet al momento del checkout
Verifica:
- Portafoglio Deuna App Abilitato (non per disabili)
- Processore è configurato correttamente (tutti i quattro campi riempiti)
- L'ordine del cliente è in USD moneta
- Il cliente è dentro Ecuador (o utilizzando l'indirizzo di fatturazione dell'Ecuador)
- Pagamento Widget include
deuna_walletprocessore - Token ordine è stato generato con successo
Se tutti verificati:
- Contatto Supporto Deuna
Permissioni e Accesso#
Requisito Admin Roles
Per configurare Deuna App Wallet, il tuo account utente deve avere:
- Collegamenti - Permesso di lettura/scrittura
- Metodi di pagamento - Permesso di lettura/scrittura
- Webhook - Permesso di lettura/scrittura (per la configurazione webhook)
Se non hai il permesso:
- Chiedi al tuo proprietario o amministratore
- Possono concedere autorizzazioni in Ruoli e autorizzazioni dell'utente sezione
Multi-Admin Setup
Se più amministratori gestiscono i pagamenti:
- Tutte le modifiche di configurazione sono visibili a tutti gli amministratori
- Qualsiasi amministratore può cambiare la modalità di pagamento (non consigliato senza comunicazione)
- Abilitare i log di audit per monitorare le modifiche:
- Vai a Ruoli e autorizzazioni dell'utente
- Abilita' Log attività
Migliori Pratiche#
Configurazione
✅ Do:
- Prova la connettività webhook dopo la configurazione
- Scegli la modalità di pagamento in base alla tua base clienti
- Limiti di rimborso prima di abilitare
- Documenta la tua scelta di modalità per il tuo team
❌ Non farlo.
- Disattivare Deuna App Portafoglio senza avvisare la tua squadra
- Cambiare frequentemente le modalità di pagamento senza motivo
- Condividi gli URL webhook in canali non garantiti
- La selezione della modalità di assume può essere sovrascrittura per ordine (non può)
Monitoraggio
✅ Do:
- Controllare le metriche di pagamento settimanali
- Recensione di registri di consegna webhook regolarmente
- Monitorare le richieste di rimborso per le tendenze
- Test di connettività webhook mensile
❌ Non farlo.
- Ignora i fallimenti webhook per periodi prolungati
- Salta il commerciante di prova di bordo
- Dimenticati di aggiornare l'URL di webhook se il tuo backend cambia