Introduzione
Integra Viva.com Smart Checkout per consentire ai clienti di effettuare pagamenti sicuri attraverso una pagina di checkout ospitata. Questa guida ti guida attraverso i passaggi per una perfetta integrazione nel tuo sito web o nella tua app.
➤ Ottieni il tuo account Viva.com, se non ne hai già uno
Viva.com supporta due ambienti diversi, assicurati di utilizzare quello corretto:
Ambiente | Descrizione | URL di registrazione | Dashboard URL |
Produzione | Per effettuare pagamenti nel mondo reale | ||
Demo | Per l'esecuzione di pagamenti di prova e altri scopi di test |
➤ Ottieni la tua fonte di pagamento online e conserva il tuo codice sorgente
Una fonte di pagamento è un'entità di configurazione che consente ai commercianti di configurare e gestire le impostazioni di integrazione dei pagamenti per i loro siti web o app per dispositivi mobili.
Configura il tuo dominio e gli URL a cui Viva.com Smart Checkout reindirizzerà i clienti dopo il completamento del pagamento. Questi URL in genere portano a pagine come "Grazie per il tuo ordine" per i pagamenti andati a buon fine o "Qualcosa è andato storto con il tuo pagamento" per le transazioni non riuscite, consentendo ai clienti di continuare il loro percorso senza problemi sul tuo sito web o sulla tua app.
Crea una fonte di pagamento per i pagamenti online, accedendo a Vendite > Pagamenti online > Siti web/app nella dashboard Viva.com.
Assicurati di salvare il codice sorgente a 4 cifre della fonte di pagamento che hai appena creato, poiché ti servirà in seguito per scopi di integrazione e configurazione.
Esempio di configurazione dell'origine di pagamento con codice sorgente 2402
Controlla qui per una guida dettagliata su come creare un Fonte per i pagamenti online
➤ Guida dettagliata all'integrazione
Passaggi chiave per l'integrazione
Creare l'ordine di pagamento
Reindirizza a Smart Checkout
Gestisci il reso del cliente e verifica l'esito del pagamento
➥ Passaggio 1: creare l'ordine di pagamento |
Per richiedere un pagamento a uno dei tuoi clienti, devi creare un ordine di pagamento. A ogni ordine di pagamento viene assegnato un ID univoco di 16 cifre, noto anche come orderCode.
Puoi generare l'ordine di pagamento utilizzando l'API Crea ordine di pagamento sul tuo server e passare l'orderCode al tuo sito web o alla tua app.
Per maggiori dettagli su come impostare un ordine di pagamento, consulta la nostra guida dettagliata sul nostro portale per sviluppatori qui e qui.
➥ Passaggio 2: reindirizza il cliente allo Smart Checkout |
Quando vengono reindirizzati, i clienti vedranno il modulo Smart Checkout per inserire i propri dati di pagamento e completare la transazione.
➤ Opzioni aggiuntive per Smart Checkout
Opzioni dell'origine di pagamento
Mostra il logo del tuo marchio
Puoi includere il logo del tuo marchio da visualizzare su Smart Checkout configurandolo nelle impostazioni dell'Origine di pagamento. C'è una guida dettagliata sul nostro portale per sviluppatori qui.
L'aggiunta del tuo logo migliora l'esperienza del cliente rafforzando l'identità del tuo marchio durante il processo di pagamento. Assicurati di caricare un logo chiaro e di dimensioni adeguate per una visualizzazione ottimale.
➤ Visualizzare un pulsante Annulla
Fornire un pulsante Annulla offre flessibilità ai clienti e aiuta a migliorare l'esperienza utente complessiva.
Puoi configurare un pulsante Annulla su Smart Checkout per fornire ai clienti la possibilità di annullare i loro ordini. Questa funzione viene gestita a livello di fonte di pagamento (in Configurazione avanzata), consentendoti di controllare se il pulsante Annulla è disponibile per gli ordini associati a un'origine specifica.
Piattaforme supportate: il pulsante Annulla è attualmente supportato per le integrazioni dirette di Smart Checkout e i plug-in per Shopify e PrestaShop.
Supporto webhook: è possibile configurare i webhook per ricevere notifiche per gli eventi di annullamento dell'ordine. Segui questa guida alla configurazione del webhook per ulteriori informazioni
➥ Passaggio 3: gestisci il reso del cliente e verifica l'esito del pagamento |
Gestire il reso del cliente
Dopo il pagamento, i clienti vengono reindirizzati a:
URL di successo per i pagamenti andati a buon fine.
URL di errore per i pagamenti non riusciti.
Puoi configurare queste impostazioni tramite la dashboard dell'account Viva.com in Vendite > Pagamenti online > Siti web/app
Verifica l'esito del pagamento
La verifica garantisce che la transazione sia stata completata correttamente. Per convalidare lo stato di una transazione nel tuo sistema, esegui un controllo incrociato dei seguenti parametri: Amount, transactionId, statusId Visualizza tutti i codici StatusId
➤ Metodi di verifica dei pagamenti consigliati:
Webhook:
Ricevi aggiornamenti in tempo reale per l'esito positivo o negativo del pagamento.
Consulta la nostra documentazione sui webhook Transazione di pagamento creata e Transazione non riuscita per maggiori dettagli sull'implementazione, sui payload di esempio e sulla spiegazione di tutti i parametri.
Copre sia i metodi di pagamento sincroni che quelli asincroni.
Recupera l'API della transazione:
Per ulteriori dettagli sulla chiamata API e sui relativi parametri, consulta la documentazione Recupera API transazione sul nostro portale per sviluppatori
➤ Configurazione aggiuntiva
Con Viva.com Smart Checkout abbiamo preparato molte funzionalità e strumenti che puoi utilizzare e offrire ai tuoi clienti più opzioni per i loro pagamenti.
Pagamenti ricorrenti: un metodo di pagamento in cui il commerciante (tu) avvia automaticamente gli addebiti in base a un programma predefinito senza coinvolgere il cliente dopo il primo pagamento.
Pre-autorizzazioni: un metodo di pagamento utilizzato per verificare la disponibilità di fondi e riservare l'importo, con l'effettivo trasferimento di fondi avviato successivamente.
Puoi trovare guide dettagliate sul nostro portale degli sviluppatori per procedere con tutte le configurazioni che puoi effettuare tramite il tuo account per accettare pagamenti online, oltre a esplorare tutte le alternative e i servizi che offriamo.