Passa al contenuto principale
In questa pagina

Le seguenti impostazioni consentono di personalizzare il comportamento di checkout e l'aspetto per soddisfare le esigenze specifiche di ciascun commerciante.

Lingua#

Il linguaggio dell'interfaccia di checkout viene configurato automaticamente in base al paese in cui opera il tuo business.

Questa impostazione mira a garantire un'esperienza localizzata per gli acquirenti, riducendo l'attrito e migliorando i tassi di conversione.

  • Il linguaggio è definito attraverso la tokenizzazione degli ordini.
  • La lingua può essere specificata dinamicamente per ogni ordine.

URL di base#

Se desideri personalizzare un URL di base specifico per i tuoi link di pagamento, puoi richiederlo dal nostro team di supporto. Questa personalizzazione consente di personalizzare l'esperienza alla tua identità di marca.

Esempio: https://payhere.yourbrand.deuna.com

Attiva l'autenticazione utente#

DEUNA consente di configurare se i vostri acquirenti completano il checkout come ospiti o come utenti autenticati, con l'accesso alle loro carte salvate e ai dati di acquisto precedenti. Questo comportamento è controllato da due variabili:

VariabileTipoDescrizione
user_authentication_flowbooleanConsente il flusso utente autenticato (login, OTP, schede salvate).
init_with_guest_userbooleanConsente il flusso utente ospite (nessun login).

Entrambe le variabili sono configurate all'interno widgets_general_config.user_experience quando si crea o aggiorna la configurazione del commerciante:

JSON
{
  "widgets_general_config": {
    "user_experience": {
      "user_authentication_flow": true,
      "init_with_guest_user": false
    }
  }
}

Come si decide se un utente vede il flusso autenticato?

Se si imposta user_authentication_flow: true, DEUNA determina quale utente mostrare (e quindi, che ha salvato le carte) seguendo un ordine prioritario. Un valore definito a un livello più elevato sempre sovrascrive i livelli sotto di esso:

PrioritàFonteDescrizione
1(più alto)Param di query userTokenSe il commerciante invia esplicitamente un userToken quando inizializza il widget, che l'utente viene utilizzato indipendentemente da qualsiasi altra configurazione.
2Configurazione del MerchantSe no userToken viene inviata, la configurazione definita in widgets_general_config.user_experience viene utilizzato.
3 (più basso)Ordine / fatturazione e-mailSe non c'è userToken e nessuna configurazione applicabile, la decisione si basa esclusivamente sulla e-mail ricevuta nei dati di ordine o fatturazione.

Esempio — inizializzazione con un esplicito userToken:

JavaScript
deunaSDK.initElements({
  orderToken: "YOUR_ORDER_TOKEN",
  userToken: "YOUR_USER_TOKEN", // overrides merchant config and order email
  // ...other initialization parameters
});

Sovrascrivendo all'inizializzazione: onlyCardEnrollment

Parametri inviati all'interno behavior quando inizializzare il WebSDK permette di ignorare determinati flussi definiti nella configurazione del commerciante, senza cambiare la configurazione stessa.

onlyCardEnrollment nasconde le carte salvate di un utente autenticato, permettendo solo l'iscrizione di una nuova carta. Questo è consigliato quando il commerciante gestisce la visualizzazione delle carte salvate dell'utente dal proprio UI, e ha solo bisogno di DEUNA per gestire il modulo di iscrizione della carta.

onlyCardEnrollment supera il risultato della tabella prioritaria sopra: anche se userToken o un attivo user_authentication_flow mostrava normalmente carte salvate, questa bandiera li costringeva a rimanere nascosti per quella sessione.

Autorizzatore esterno (userToken)OTP (OTP)user_authentication_flow)onlyCardEnrollmentCarte salvate visibili?
✅❌❌✅
✅❌✅❌
❌✅❌✅
❌✅✅❌

Esempio — Configurazione di Vault Widget WebSDK:

JavaScript
await DeunaSDK.initElements({
  orderToken: "<ORDER_TOKEN>",
  userToken: "<AUTHENTICATION_TOKEN>",
  userInfo: { /* ... */ },
  behavior: {
    onlyCardEnrollment: true,
    // ...other behavior overrides
  },
  callbacks: { /* ... */ },
  },
});

Abilita il salvataggio della carta#

Oltre a decidere se un utente controlla come ospite o come utente autenticato, è possibile configurare come il salvataggio della carta si comporta durante il pagamento.

VariabileTipoDescrizione
show_saved_cards_flowbooleanVisualizza un casella di controllo che permette al cliente di decidere se salvare la loro carta durante il pagamento. Quando è disattivato (false, il default), la carta viene salvata automaticamente senza chiedere, che migliora la conversione sugli acquisti futuri.
default_card_flowbooleanVisualizza una casella di controllo aggiuntiva che consente all'utente di decidere se tale scheda debba essere contrassegnata come la predefinito per gli acquisti futuri. Disabilitato per impostazione predefinita.

Entrambe le variabili sono configurate anche all'interno widgets_general_config.user_experience:

JSON
{
  "widgets_general_config": {
    "user_experience": {
      "show_saved_cards_flow": true,
      "default_card_flow": true
    }
  }
}

Abilita il salvataggio della carta#

È possibile visualizzare una casella di controllo che consente al cliente di decidere se salvare la propria carta al momento del checkout. Questa opzione è utile nei flussi degli ospiti.

Il comportamento predefinito non è quello di visualizzare la casella di controllo e salvare automaticamente la scheda per migliorare la conversione.

Consentire la cancellazione della carta#

Controlla se i acquirenti possono eliminare le carte salvate nelle Vault Widget. Consigliato per l'abbonamento e i modelli di fatturazione ricorrenti per evitare la rimozione accidentale del metodo di pagamento e il churn involontario.

VariabileTipoPredefinitoDescrizione
allow_card_deletionbooleantrueDetermina se i acquirenti possono eliminare le carte. Quando false, tutte le azioni di cancellazione sono nascoste.

Configurare dentro widgets_general_config.user_experience:

JSON
{
  "widgets_general_config": {
    "user_experience": {
      "allow_card_deletion": false
    }
  }
}

Comportamento dell'UI

StatoCarte attiveCarte scaduteScheda di defaultVista singola carta
false (Disabilitato)Nasconde "Cancella" dal menu (solo "Set as default" è mostrato).Nasconde l'icona della spazzatura.Nasconde il menu delle azioni per evitare popover vuoti.Nasconde il pulsante di cancellazione.
true o omesso (Default)Cancellazione standard disponibile nel menu.Icona di cestino visibile e attiva.Cancellazione standard disponibile nel menu.Eliminare il pulsante visibile e attivo.

Stile visivo#

Personalizza il tuo widget utilizzando CustomStyle.

Adapt l'esperienza visiva dei vostri clienti alle vostre linee guida di marca.