Le fonti vengono utilizzate per i pagamenti online tramite Smart Checkout, plugin e i nostri strumenti di pagamento.
➡️ Aggiungi una fonte
Per aggiungere una fonte per i pagamenti online, segui questi passaggi:
Accedi a Viva.com e seleziona l’account pertinente (demo o live).
Vai a Vendite → Pagamenti online → Siti web/App.
Seleziona Aggiungi sito web/App.
Compila i dati richiesti nella finestra pop-up come segue:
Codice – Il numero a quattro cifre in alto a sinistra del campo è il "Codice fonte" – l'identificatore univoco per questa fonte di pagamento. Questo codice viene generato automaticamente, ma puoi scegliere un valore diverso se preferisci (ad esempio per scopi organizzativi). Se utilizzi la nostra Payment API, questo codice viene trasmesso tramite il parametro sourceCode durante la creazione di un ordine di pagamento.
Nome della fonte – Oltre al Codice fonte, puoi anche assegnare un nome alla tua fonte di pagamento. Questo ti permette di identificare più facilmente la fonte all’interno del tuo account e nei report (come ad esempio il Report di regolamento).
Conto collegato – Seleziona il conto (wallet) che desideri collegare a questa fonte di pagamento. Quando questa fonte di pagamento viene utilizzata, i fondi verranno depositati nel conto selezionato. Puoi collegare più fonti diverse a un singolo conto, se lo desideri.
Protocollo – Se la tua piattaforma e-commerce utilizza SSL al momento del checkout, seleziona https. Se la tua piattaforma non utilizza SSL (come avviene in alcuni ambienti di sviluppo, ad esempio), seleziona http.
Nome di dominio – Inserisci il dominio che sarà collegato a questa fonte di pagamento. Non è necessario includere la barra finale (\) o il protocollo (http:// o https://). Ad esempio:
Se il tuo sito web utilizza www: www.tuodominio.com
Se il tuo sito web non utilizza www: tuodominio.com
Metodo di integrazione – Lascialo impostato su Redirection/Native Checkout v2.
Logo aziendale – Carica il logo della tua azienda da associare a questa fonte di pagamento, in formato PNG con trasparenza, fino a 100 KB (dimensione consigliata: 128 x 128 pixel). Questo è un passaggio importante, poiché il logo apparirà sulla tua pagina di pagamento, aiutando i clienti a riconoscere e confermare la tua azienda.
Success URL – Questo è l’URL della pagina a cui il cliente verrà reindirizzato dopo un pagamento andato a buon fine. Ad esempio, puoi usarlo per mostrare una pagina di conferma del pagamento o una pagina che ringrazia il cliente per il pagamento.
Failure URL – Questo è l’URL della pagina a cui il cliente verrà reindirizzato dopo un pagamento non riuscito. Ad esempio, puoi usarlo per riportare il cliente all’ultimo passaggio del processo di checkout, in modo che possa riprovare la transazione.
Se utilizzi uno dei nostri plugin, le Success URL e Failure URL potrebbero richiedere valori specifici. Consulta la tabella delle URL dei plugin riportata di seguito.
Plugin name | Success URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
Plugin name | Failure URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
Impostazioni avanzate – A questo punto, puoi abilitare la visualizzazione di un pulsante Annulla in Smart Checkout, oltre a modificare i nomi dei parametri URL aggiunti alle Success/Failure URL dopo una transazione (vedi Response information | Viva.com Developer Portal).
Per abilitare il pulsante Annulla in Smart Checkout, attiva l’opzione Cancel Button. Quando si clicca sul pulsante Annulla, Smart Checkout reindirizzerà alla tua Failure URL con il parametro cancel nella query.
Nota:
Attualmente, il pulsante Annulla è supportato per le integrazioni dirette con Smart Checkout, così come per funzionalità specifiche nei nostri plugin per Shopify e PrestaShop.
È inoltre possibile ricevere webhook per gli eventi di annullamento degli ordini. Segui questa guida (Order Updated | Viva.com Developer Portal) per configurare un webhook per gli annullamenti degli ordini.
I parametri predefiniti sono:
Parameter | Default Name |
Cancellation status | cancel |
Order Code | s |
Transaction ID | t |
Language | lang |
Si consiglia di mantenere questi valori predefiniti, a meno che non siano necessarie modifiche specifiche per allinearli ai sistemi interni.
Infine, rivedi le informazioni accanto a ciascuna casella di controllo nella parte inferiore dello schermo. Devi accettare questi termini per poter creare la fonte di pagamento. Una volta selezionate tutte le opzioni, fai clic sul pulsante Crea per completare il processo.