Viva.com Smart Checkout vă permite să acceptați plăți online prin intermediul unei pagini de plată găzduite.
Acest ghid explică pașii principali pentru integrarea Smart Checkout cu site-ul sau aplicația dvs., de la configurarea contului Viva.com și a sursei de plată până la redirecționarea clienților și verificarea rezultatului plății.
1. Alegeți mediul Viva.com
Viva.com oferă două medii. Asigurați-vă că utilizați mediul care corespunde acțiunilor pe care doriți să le efectuați.
Mediu | Utilizați-l pentru | Primii pași |
Producție | Acceptarea plăților reale | |
Demo | Testarea integrării și efectuarea plăților de test |
Asigurați-vă că lucrați în mediul corect atunci când configurați și testați integrarea.
2. Creați o sursă de plată pentru plățile online
O sursă de plată conține setările pe care Viva.com le utilizează pentru plățile efectuate prin intermediul site-ului sau aplicației dvs.
Atunci când configurați sursa de plată, configurați numele domeniului și adresele URL către care clienții trebuie să fie redirecționați după finalizarea procesului de plată.
De exemplu:
o pagină pentru plăți reușite, cum ar fi „Vă mulțumim pentru comandă”
o pagină pentru plăți nereușite, cum ar fi „A apărut o problemă cu plata dvs.”
Pentru a crea o sursă de plată pentru plățile online, accesați Vânzări > Plăți online în tabloul de bord Viva.com.
După crearea sursei de plată, salvați codul sursei format din 4 cifre. Veți avea nevoie de acest cod atunci când configurați integrarea.
Exemplu de configurare a unei surse de plată cu codul sursei 2861 |
 |
Pentru instrucțiuni detaliate de configurare, consultați Sursă pentru plăți online | Viva.com Suport.
3. Integrați Smart Checkout
Există trei pași principali pentru integrarea Smart Checkout:
Pasul 1: Creați un ordin de plată
Înainte de a solicita o plată de la un client, creați un ordin de plată.
Fiecărui ordin de plată îi este atribuit un ID unic format din 16 cifre, denumit orderCode.
Creați ordinul de plată de pe serverul dvs. utilizând Create Payment Order API, apoi transmiteți orderCode către site-ul sau aplicația dvs.
Pentru parametrii API și detaliile de implementare, accesați Viva.com Developer Portal. În meniul din partea stângă, selectați APIs for payments, apoi Payment API. În secțiunea Payments, selectați Create payment order.
Pasul 2: Redirecționați clientul către Smart Checkout
După crearea ordinului de plată, redirecționați clientul către Smart Checkout. Clientul își poate introduce apoi detaliile de plată și poate finaliza procesul de plată pe pagina Smart Checkout.
Pasul 3: Gestionați revenirea clientului și verificați rezultatul plății
După procesul de plată, clientul este redirecționat către adresa URL configurată pentru rezultatul corespunzător:
Adresa URL reușită pentru plățile reușite
URL greșit pentru plățile nereușite
Puteți configura aceste adrese URL în tabloul de bord Viva.com, în Vânzări > Plăți online > Site-uri / Aplicații.
Verificați rezultatul plății
Verificați starea tranzacției în sistemul dvs. utilizând informațiile de plată returnate de Viva.com. Informațiile despre tranzacție utilizate pentru validare includ:
AmounttransactionIdstatusId
Viva.com oferă următoarele metode pentru verificarea rezultatului plății.
Webhooks
Webhooks permit sistemului dvs. să primească notificări privind reușita sau nereușita unei plăți și acceptă atât metode de plată sincrone, cât și asincrone.
Pentru detalii despre implementare, parametrii evenimentelor și exemple de payloads, accesați Viva.com Developer Portal și selectați Webhooks For Payments din meniu.
Retrieve Transaction API
De asemenea, puteți prelua informații despre tranzacție utilizând Retrieve Transaction API. Pentru parametrii API și detaliile de implementare, accesați Viva.com Developer Portal. În meniul din partea stângă, selectați APIs for payments, apoi Payment API. În secțiunea Transactions, selectați Retrieve transaction.
Setări opționale Smart Checkout
De asemenea, puteți configura setări Smart Checkout suplimentare în funcție de nevoile integrării.
Afișați logo-ul companiei
Puteți adăuga logo-ul companiei în Smart Checkout prin intermediul setărilor sursei de plată. Pentru instrucțiuni, accesați Viva.com Developer Portal, mergeți la Tutorials, selectați Smart Checkout Configuration, apoi faceți clic pe Add your brand logo.
Asigurați-vă că încărcați un logo clar și de dimensiuni corespunzătoare pentru o afișare optimă.
Afișați un buton Anulați
Puteți configura un buton Anulați în Setări avansate ale sursei de plată. Acesta le oferă clienților opțiunea de a-și anula comanda.
Butonul Anulați este disponibil pentru integrările directe Smart Checkout și pentru pluginurile Shopify și PrestaShop.
De asemenea, puteți configura webhooks pentru a primi notificări despre evenimentele de anulare a comenzilor. Accesați Viva.com Developer Portal, selectați Webhooks For Payments, apoi Order Updated pentru mai multe informații.
Opțiuni suplimentare de plată
Smart Checkout acceptă și configurații suplimentare de plată, inclusiv:
Plăți recurente: Comerciantul inițiază automat debitările conform unui program prestabilit după prima plată.
Preautorizări: O sumă este rezervată, iar transferul fondurilor este inițiat ulterior.
Pentru detalii tehnice despre implementare și alte configurații Smart Checkout disponibile, accesați Viva.com developer portal.
Mai aveți nevoie de ajutor? Echipa noastră este aici pentru a vă oferi asistență. Vă rugăm să ne contactați prin opțiunea Vorbește cu noi din contul dvs. Viva.com.