Configurazione Deuna (Banco Pichincha).
Configura la connessione del portafoglio Deuna supportato da Banco Pichincha in DEUNA Admin.
In questa pagina
Panoramica#
Questa guida copre la configurazione lato commerciante di Deuna (Banco Pichincha) nel pannello di amministrazione di DEUNA. La configurazione è un'impostazione una tantum che determina quale modalità di pagamento utilizzeranno i tuoi clienti.
Accesso alla configurazione#
Passaggio 1: accedi a DEUNA Admin
- Passare all'amministrazione di DEUNA
- Inserisci le tue credenziali commerciante
- Fare clic Accedi
Passaggio 2: vai a Metodi di pagamento
- Nella barra laterale di sinistra, vai a Connessioni
- Fare clic su Metodi di pagamento
- Cerca Portafoglio Deuna nell'elenco. Questo identificatore amministratore si riferisce al portafoglio Deuna sostenuto da Banco Pichincha.
Configurazione iniziale#
Abilitazione di Deuna (Banco Pichincha)
Se Deuna (Banco Pichincha) non è ancora abilitato:
- Trova Portafoglio Deuna nell'elenco Metodi di pagamento. Questa è l'etichetta Admin per la connessione Deuna (Banco Pichincha).
- Fare clic Abilita o Aggiungi
- Si aprirà un pannello di configurazione con un modulo per aggiungere il processore
- Compila tutto quattro campi delle credenziali obbligatorie (vedi sezione seguente)
- Seleziona il tuo preferito modalità di pagamento (vedi sezione seguente)
- Fare clic Salva
Il metodo di pagamento è ora attivo e apparirà come opzione per i tuoi clienti al momento del pagamento.
Aggiunta del processore Deuna (Banco Pichincha).
Quando abiliti Deuna (Banco Pichincha), devi aggiungere il processore con le credenziali del tuo account Deuna (Banco Pichincha).
Per aggiungere il processore:
- Nel pannello di configurazione di Deuna (Banco Pichincha).
- Fare clic Aggiungi processore o Configura credenziali
- Compila tutti e quattro i campi obbligatori:
Campi obbligatori
| Campo | Descrizione | Esempio | Note |
|---|---|---|---|
| Public API Key | Chiamata "Chiave API" a Deuna (Banco Pichincha) | pub_abc123xyz789 | Esegue il mapping all'intestazione x-api-key |
| Private API Key | Chiamato "API Secret" a Deuna (Banco Pichincha) | sec_abc123xyz789 | Esegue il mapping all'intestazionex-api-secret |
| Punto Vendita (CAJA) | Chiamato "CAJA" a Deuna (Banco Pichincha) | 4200069 | Identificatore di stringa per il tuo punto vendita |
| Formato | Tipo di codice di pagamento | QR o CODIGO_6_DIGITOS | Determina se i clienti ricevono il codice QR o a 6 cifre |
Modulo passo passo
Importante:
- Tutti e quattro i campi lo sono richiesto
- Le tue credenziali provengono dal tuo conto aziendale Deuna (Banco Pichincha).
- La selezione del formato qui determina la modalità di pagamento per tutti gli ordini
- Dopo il salvataggio, le credenziali vengono crittografate e archiviate in modo sicuro
Scelta del formato di pagamento#
Quando compili il modulo del processore, devi selezionare il tuo formato di pagamento. Questa scelta viene effettuata quando si aggiungono le credenziali e determina il modo in cui i clienti interagiranno con il flusso di pagamento.
Guida alla scelta del formato
| Aspetto | Codice Numerico (CODIGO_6_DIGITOS) | Codice QR |
|---|---|---|
| Il cliente vede | Codice a 6 cifre | Codice QR dinamico |
| Finestra temporale | 3 minuti | 15 minuti |
| Come pagare | Digita nell'app | Scansiona o fai clic |
| Meglio per | Pagamento su desktop/tablet | Pagamento mobile-first |
| Esperienza dell'utente | È richiesto l'inserimento manuale | Veloce, con un solo tocco/scansione |
| Valore del campo | CODIGO_6_DIGITOS | QR |
Formato 1: codice numerico (CODIGO_6_DIGITOS, 3 minuti)
Scegli questo se:
- I tuoi clienti utilizzano principalmente desktop/tablet
- Desideri una finestra di transazione rapida
- Il flusso di pagamento viene eseguito su più tipi di dispositivi
- Preferisci la semplicità e le dipendenze minime
Come funziona:
- Il cliente vede un grande codice a 6 cifre
- Il codice scade tra 3 minuti esatti
- Il cliente deve aprire l'app Deuna e inserire manualmente il codice
- Dopo l'accesso, il cliente conferma nell'app
- DEUNA elabora lo stato del pagamento finale in modo asincrono
Per selezionare questo formato:
- Sotto forma di processore
- Sotto Formato, seleziona Codice Numerico (CODIGO_6_DIGITOS)
- Compila il modulo e clicca Salva processore
Verifica:
- Una volta salvato, vedrai un messaggio di conferma
- Tutti gli ordini successivi utilizzeranno codici numerici a 6 cifre
Formato 2: codice QR (15 minuti)
Scegli questo se:
- I tuoi clienti sono principalmente utenti mobili
- Desideri una finestra di transazione più lunga per flessibilità
- Preferisci un'esperienza moderna e con un solo tocco
- La scansione QR è comune nel tuo mercato di riferimento
Come funziona:
- Il cliente vede un codice QR dinamico
- Il codice QR è valido esattamente per 15 minuti
- Il cliente può:
- Scansione con la fotocamera dell'app Deuna
- Fare clic per aprire direttamente l'app
- DEUNA elabora lo stato del pagamento finale in modo asincrono
Per selezionare questo formato:
- Sotto forma di processore
- Sotto Formato, seleziona Codice QR
- Compila il modulo e clicca Salva processore
Verifica:
- Una volta salvato, vedrai un messaggio di conferma
- Tutti gli ordini successivi utilizzeranno i codici QR
Pannello di configurazione#
Risoluzione dei problemi di configurazione
Problema: impossibile trovare il portafoglio Deuna nell'elenco dei metodi di pagamento
Soluzione:
- Aggiorna la pagina
- Verifica di disporre dell'autorizzazione "Pagamenti" nel tuo ruolo utente
- Contatta il supporto DEUNA per assicurarti che Deuna (Banco Pichincha) sia predisposto per il tuo account
Problema: il processore non salva o mostra un errore
Soluzione:
- Verifica che tutti e quattro i campi delle credenziali siano compilati:
- Chiave API pubblica (non vuota)
- Chiave API privata (non vuota)
- Punto Vendita / CAJA (non vuoto, stringa numerica)
- Formato selezionato (QR o Codice Numerico)
- Verifica che le credenziali del tuo account Deuna (Banco Pichincha) siano corrette
- Metti prima alla prova le tue credenziali nella dashboard di Deuna (Banco Pichincha).
- Riprovare in un browser diverso
- Contatta l'assistenza DEUNA se il problema persiste
Problema: i clienti non possono vedere Deuna (Banco Pichincha) alla cassa
Verifica:
- Portafoglio Deuna è Abilitato (non disabilitato) in DEUNA Admin
- Il processore è configurato correttamente (tutti e quattro i campi compilati)
- L'ordine del cliente è arrivato USD valuta
- Il cliente è dentro Ecuador (o utilizzando l'indirizzo di fatturazione dell'Ecuador)
- Il widget di pagamento include
deuna_walletprocessore - Il token dell'ordine è stato generato correttamente
Se tutto è verificato:
- Contatta il supporto DEUNA
Autorizzazioni e accesso#
Ruoli amministrativi richiesti
Per configurare Deuna (Banco Pichincha), il tuo account utente deve avere:
- Connessioni - Autorizzazione di lettura/scrittura
- Metodi di pagamento - Autorizzazione di lettura/scrittura
Se non hai i permessi:
- Chiedi al proprietario o all'amministratore del tuo account
- Possono concedere autorizzazioni in Ruoli e autorizzazioni utente sezione
Configurazione multi-amministratore
Se più amministratori gestiscono i pagamenti:
- Tutte le modifiche alla configurazione sono visibili a tutti gli amministratori
- Qualsiasi amministratore può modificare la modalità di pagamento (non consigliato senza comunicazione)
- Abilita i log di controllo per tenere traccia delle modifiche:
- Vai a Ruoli e autorizzazioni utente
- Abilita Registro delle attività
Migliori pratiche#
Configurazione
✅ Fai:
- Testare il completamento del pagamento asincrono dopo la configurazione
- Scegli la modalità di pagamento in base alla tua base clienti
- Controlla le limitazioni sui rimborsi prima di abilitare
- Documenta la scelta della modalità per la tua squadra
❌ Non:
- Disabilita Deuna (Banco Pichincha) senza avvisare la tua squadra
- Cambiare frequentemente modalità di pagamento senza motivo
- Supponiamo che la selezione della modalità possa essere sostituita per ordine (non è possibile)
Monitoraggio
✅ Fai:
- Controlla settimanalmente le metriche di pagamento
- Esamina regolarmente gli stati di pagamento non risolti
- Monitorare le richieste di rimborso per le tendenze
- Testare regolarmente il completamento del pagamento asincrono
❌ Non:
- Ignora gli stati di pagamento non risolti per periodi prolungati
- Salta i test di onboarding del commerciante