Le fonti vengono utilizzate per identificare e gestire i pagamenti online effettuati tramite Smart Checkout, plugins e altri payment tools. È possibile trovare maggiori informazioni su ciascuna opzione nel Viva.com Developer Portal, rispettivamente nelle sezioni Smart Checkout, Plugins e Payment tools.
➡️ 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. Per maggiori informazioni, consultare la pagina della documentazione relativa a Payment API nel Viva.com Developer Portal.
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.
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. Per maggiori informazioni sui parametri aggiunti ai Success e Failure URLs, visitare la pagina Viva.com Developer Portal – Response information nella sezione Integration reference e consultare i parametri della stringa di query della risposta.
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 webhooks per gli eventi di annullamento degli ordini. Visitare la pagina Viva.com Developer Portal – Order Updated nella sezione Webhooks for payments per informazioni sul webhook Order Updated e sugli eventi di annullamento 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.
 |
 |