Passa al contenuto principale
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

  1. Passare all'amministrazione di DEUNA
  2. Inserisci le tue credenziali commerciante
  3. Fare clic Accedi

Passaggio 2: vai a Metodi di pagamento

  1. Nella barra laterale di sinistra, vai a Connessioni
  2. Fare clic su Metodi di pagamento
  3. 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:

  1. Trova Portafoglio Deuna nell'elenco Metodi di pagamento. Questa è l'etichetta Admin per la connessione Deuna (Banco Pichincha).
  2. Fare clic Abilita o Aggiungi
  3. Si aprirà un pannello di configurazione con un modulo per aggiungere il processore
  4. Compila tutto quattro campi delle credenziali obbligatorie (vedi sezione seguente)
  5. Seleziona il tuo preferito modalità di pagamento (vedi sezione seguente)
  6. 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:

  1. Nel pannello di configurazione di Deuna (Banco Pichincha).
  2. Fare clic Aggiungi processore o Configura credenziali
  3. Compila tutti e quattro i campi obbligatori:

Campi obbligatori

CampoDescrizioneEsempioNote
Public API KeyChiamata "Chiave API" a Deuna (Banco Pichincha)pub_abc123xyz789Esegue il mapping all'intestazione x-api-key
Private API KeyChiamato "API Secret" a Deuna (Banco Pichincha)sec_abc123xyz789Esegue il mapping all'intestazionex-api-secret
Punto Vendita (CAJA)Chiamato "CAJA" a Deuna (Banco Pichincha)4200069Identificatore di stringa per il tuo punto vendita
FormatoTipo di codice di pagamentoQR o CODIGO_6_DIGITOSDetermina 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

AspettoCodice Numerico (CODIGO_6_DIGITOS)Codice QR
Il cliente vedeCodice a 6 cifreCodice QR dinamico
Finestra temporale3 minuti15 minuti
Come pagareDigita nell'appScansiona o fai clic
Meglio perPagamento su desktop/tabletPagamento mobile-first
Esperienza dell'utenteÈ richiesto l'inserimento manualeVeloce, con un solo tocco/scansione
Valore del campoCODIGO_6_DIGITOSQR

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:

  1. Il cliente vede un grande codice a 6 cifre
  2. Il codice scade tra 3 minuti esatti
  3. Il cliente deve aprire l'app Deuna e inserire manualmente il codice
  4. Dopo l'accesso, il cliente conferma nell'app
  5. DEUNA elabora lo stato del pagamento finale in modo asincrono

Per selezionare questo formato:

  1. Sotto forma di processore
  2. Sotto Formato, seleziona Codice Numerico (CODIGO_6_DIGITOS)
  3. 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:

  1. Il cliente vede un codice QR dinamico
  2. Il codice QR è valido esattamente per 15 minuti
  3. Il cliente può:
    • Scansione con la fotocamera dell'app Deuna
    • Fare clic per aprire direttamente l'app
  4. DEUNA elabora lo stato del pagamento finale in modo asincrono

Per selezionare questo formato:

  1. Sotto forma di processore
  2. Sotto Formato, seleziona Codice QR
  3. 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:

  1. 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)
  2. Verifica che le credenziali del tuo account Deuna (Banco Pichincha) siano corrette
  3. Metti prima alla prova le tue credenziali nella dashboard di Deuna (Banco Pichincha).
  4. Riprovare in un browser diverso
  5. Contatta l'assistenza DEUNA se il problema persiste

Problema: i clienti non possono vedere Deuna (Banco Pichincha) alla cassa

Verifica:

  1. Portafoglio Deuna è Abilitato (non disabilitato) in DEUNA Admin
  2. Il processore è configurato correttamente (tutti e quattro i campi compilati)
  3. L'ordine del cliente è arrivato USD valuta
  4. Il cliente è dentro Ecuador (o utilizzando l'indirizzo di fatturazione dell'Ecuador)
  5. Il widget di pagamento include deuna_wallet processore
  6. 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:

  1. Chiedi al proprietario o all'amministratore del tuo account
  2. Possono concedere autorizzazioni in Ruoli e autorizzazioni utente sezione

Configurazione multi-amministratore

Se più amministratori gestiscono i pagamenti:

  1. Tutte le modifiche alla configurazione sono visibili a tutti gli amministratori
  2. Qualsiasi amministratore può modificare la modalità di pagamento (non consigliato senza comunicazione)
  3. 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