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

  1. Passare all'Amministratore di DEUNA
  2. Inserisci le credenziali del commerciante
  3. Cliccare su Accedi

Passo 2: Passare ai metodi di pagamento

  1. Nella barra laterale sinistra, vai a Collegamenti
  2. Clicca su Metodi di pagamento
  3. Cercare Portafoglio Deuna App nella lista

Impostazione iniziale#

Abilitare Deuna App Wallet

Se Portafoglio Deuna App non è ancora abilitato:

  1. Trova Portafoglio Deuna App nell'elenco dei metodi di pagamento
  2. Cliccare su Abilita' o Aggiungi
  3. Un pannello di configurazione si aprirà con un modulo per aggiungere il processore
  4. Riempire tutti quattro campi obbligatori (vedere sezione sotto)
  5. Seleziona il tuo preferito modalità di pagamento (vedere sezione sotto)
  6. 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:

  1. Nel pannello di configurazione Deuna App Wallet
  2. Cliccare su Aggiungere processore o Configurare le credenziali
  3. Compila tutti e quattro i campi richiesti:

Campi obbligatori

CampoDescrizioneEsempioNote
Public API KeyChiamato "API Key" nel Portafoglio di Deuna Apppub_abc123xyz789Mappe all'intestazione x-api-key
Private API KeyChiamato "API Secret" in Deuna App Walletsec_abc123xyz789Mappe all'intestazionex-api-secret
Punto vendita (CAJA)Chiamato "CAJA" nel Portafoglio di Deuna App4200069Identificatore di stringa per il punto vendita
FormatoTipo di codice di pagamentoQR o CODIGO_6_DIGITOSDetermina 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

AspettiCodice numerico (CODIGO 6 DIGITOS)Codice QR QR
Il cliente vede6 cifreCodice QR dinamico
Finestra del tempo3 minuti15 minuti
Come pagareDigitare l'appScansione o click
Ideale perCheckout desktop/tabletControllo mobile
Esperienza utenteIngresso manuale richiestoVeloce, one-tap/scan
Valore di campoCODIGO_6_DIGITOSQR

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:

  1. Il cliente vede un grande codice a 6 cifre
  2. Il codice scade esattamente in 3 minuti
  3. Il cliente deve aprire Deuna App e inserire manualmente il codice
  4. Dopo l'inserimento, il cliente conferma nell'app
  5. Pagamento confermato tramite webhook

Per selezionare questo formato:

  1. Nel modulo del processore
  2. Sottotitoli Formato, selezionare Codice numerico (CODIGO 6 DIGITOS)
  3. 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:

  1. Il cliente vede un codice QR dinamico
  2. Codice QR è valido per esattamente 15 minuti
  3. Il cliente può:
    • Scansione con la fotocamera Deuna App
    • Cliccare su per aprire l'app direttamente
  4. Pagamento confermato tramite webhook

Per selezionare questo formato:

  1. Nel modulo del processore
  2. Sottotitoli Formato, selezionare Codice QR QR
  3. 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:

  1. 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)
  2. Controlla che le credenziali siano corrette dal tuo account Deuna App Wallet
  3. Prova le tue credenziali nel cruscotto Deuna App Wallet prima
  4. Prova di nuovo in un browser diverso
  5. Contattare il supporto Deuna se persiste il problema

Problema: i clienti non possono vedere Deuna App Wallet al momento del checkout

Verifica:

  1. Portafoglio Deuna App Abilitato (non per disabili)
  2. Processore è configurato correttamente (tutti i quattro campi riempiti)
  3. L'ordine del cliente è in USD moneta
  4. Il cliente è dentro Ecuador (o utilizzando l'indirizzo di fatturazione dell'Ecuador)
  5. Pagamento Widget include deuna_wallet processore
  6. 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:

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

Multi-Admin Setup

Se più amministratori gestiscono i pagamenti:

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