Viva.com Smart Checkout consente di accettare pagamenti online tramite una pagina di pagamento ospitata.
Questa guida illustra i passaggi principali per integrare Smart Checkout con il proprio sito web o la propria app, dalla configurazione dell’account Viva.com e della fonte di pagamento fino al reindirizzamento dei clienti e alla verifica dell’esito del pagamento.
1. Scegliere l’ambiente Viva.com
Viva.com mette a disposizione due ambienti. Assicurarsi di utilizzare l’ambiente adatto a ciò che si desidera fare.
Ambiente | Utilizzarlo per | Per iniziare |
Produzione | Accettare pagamenti reali | |
Demo | Testare l’integrazione ed effettuare pagamenti di prova |
Assicurarsi di operare nell’ambiente corretto durante la configurazione e il test dell’integrazione.
2. Creare una fonte di pagamento per i pagamenti online
Una fonte di pagamento contiene le impostazioni utilizzate da Viva.com per i pagamenti effettuati tramite il proprio sito web o la propria app.
Durante la configurazione della fonte di pagamento, configurare il proprio dominio e gli URL a cui i clienti devono essere reindirizzati dopo aver completato la procedura di pagamento.
Ad esempio:
una pagina per i pagamenti riusciti, come “Grazie per il tuo ordine”
una pagina per i pagamenti non riusciti, come “Si è verificato un problema con il tuo pagamento”
Per creare una fonte di pagamento per i pagamenti online, accedere a Vendite > Pagamenti online nella Dashboard Viva.com.
Dopo aver creato la fonte di pagamento, salvare il relativo codice fonte a 4 cifre. Questo codice sarà necessario durante la configurazione dell’integrazione.
Esempio di configurazione di una fonte di pagamento con codice fonte 2861
Per istruzioni dettagliate sulla configurazione, consultare Fonte per i pagamenti online | Supporto Viva.com.
3. Integrare Smart Checkout
L’integrazione di Smart Checkout prevede tre passaggi principali:
Passaggio 1: Creare un ordine di pagamento
Prima di richiedere un pagamento a un cliente, creare un ordine di pagamento.
A ogni ordine di pagamento viene assegnato un ID univoco di 16 cifre, denominato orderCode.
Creare l’ordine di pagamento dal proprio server utilizzando Create Payment Order API, quindi passare l’orderCode al proprio sito web o alla propria app.
Per i parametri dell’API e i dettagli sull’implementazione, visitare Viva.com Developer Portal. Nel menu a sinistra, selezionare APIs for payments, quindi Payment API. In Payments, selezionare Create payment order.
Passaggio 2: Reindirizzare il cliente a Smart Checkout
Dopo aver creato l’ordine di pagamento, reindirizzare il cliente a Smart Checkout. Il cliente potrà quindi inserire i propri dati di pagamento e completare la procedura di pagamento nella pagina Smart Checkout.
Passaggio 3: Gestire il ritorno del cliente e verificare l’esito del pagamento
Dopo la procedura di pagamento, il cliente viene reindirizzato all’URL configurato per il relativo esito:
Success URL per i pagamenti riusciti
Failure URL per i pagamenti non riusciti
È possibile configurare questi URL nella Dashboard Viva.com in Vendite > Pagamenti online > Siti web/app.
Verificare l’esito del pagamento
Verificare lo stato della transazione nel proprio sistema utilizzando le informazioni di pagamento restituite da Viva.com. Le informazioni sulla transazione utilizzate per la convalida includono:
AmounttransactionIdstatusId
Viva.com mette a disposizione i seguenti metodi per verificare l’esito del pagamento.
Webhooks
I Webhooks consentono al sistema di ricevere notifiche relative alla riuscita o al mancato completamento di un pagamento e supportano metodi di pagamento sia sincroni sia asincroni.
Per i dettagli sull’implementazione, i parametri degli eventi e gli esempi di payload, visitare Viva.com Developer Portal e selezionare Webhooks For Payments dal menu.
Retrieve Transaction API
È inoltre possibile recuperare le informazioni sulla transazione utilizzando Retrieve Transaction API. Per i parametri dell’API e i dettagli sull’implementazione, visitare Viva.com Developer Portal. Nel menu a sinistra, selezionare APIs for payments, quindi Payment API. In Transactions, selezionare Retrieve transaction.
Impostazioni opzionali di Smart Checkout
È inoltre possibile configurare impostazioni aggiuntive di Smart Checkout in base alle esigenze dell’integrazione.
Visualizzare il logo del proprio brand
È possibile aggiungere il logo del proprio brand a Smart Checkout tramite le impostazioni della fonte di pagamento. Per le istruzioni, visitare Viva.com Developer Portal, accedere a Tutorials, selezionare Smart Checkout Configuration, quindi fare clic su Add your brand logo.
Assicurarsi di caricare un logo nitido e di dimensioni appropriate per una visualizzazione ottimale.
Visualizzare un pulsante Cancel
È possibile configurare un pulsante Cancel nelle impostazioni di configurazione avanzata della fonte di pagamento. In questo modo, i clienti avranno la possibilità di annullare il proprio ordine.
Il pulsante Cancel è supportato per le integrazioni dirette di Smart Checkout e per i plugin per Shopify e PrestaShop.
È inoltre possibile configurare i webhooks per ricevere notifiche relative agli eventi di annullamento degli ordini. Visitare Viva.com Developer Portal, selezionare Webhooks For Payments, quindi Order Updated per ulteriori informazioni.
Opzioni di pagamento aggiuntive
Smart Checkout supporta inoltre configurazioni di pagamento aggiuntive, tra cui:
Pagamenti ricorrenti: l’esercente avvia automaticamente gli addebiti secondo una pianificazione predefinita dopo il primo pagamento.
Pre-autorizzazioni: un importo viene riservato e il trasferimento dei fondi viene avviato successivamente.
Per i dettagli tecnici sull’implementazione e per le altre configurazioni Smart Checkout disponibili, visitare Viva.com developer portal.
Serve ancora aiuto? Il nostro team è a disposizione per fornire assistenza. Contattarci tramite l’opzione Chatta con noi nel proprio account Viva.com.