Introducere
Integrați Viva.com Smart Checkout pentru a permite clienților să efectueze plăți sigure printr-o pagină de plată găzduită. Acest ghid vă ghidează prin pașii pentru integrarea perfectă în site-ul sau aplicația dvs.
➤ Obțineți contul Viva.com, dacă nu aveți deja unul
Viva.com acceptă două medii diferite, asigurați-vă că îl utilizați pe cel corect:
Mediu | Descriere | URL de înregistrare | Adresa URL a tabloului de bord |
Producție | Pentru efectuarea plăților în lumea reală | ||
Demo | Pentru efectuarea plăților de testare și a altor scopuri de testare |
➤ Obțineți sursa de plată online și păstrați codul sursă
O sursă de plată este o entitate de configurare care permite comercianților să configureze și să gestioneze setările de integrare a plăților pentru site-urile lor web sau aplicațiile mobile.
Configurați domeniul și adresele URL în care Viva.com Smart Checkout va redirecționa clienții după finalizarea plății. Aceste adrese URL duc de obicei la pagini precum "Mulțumesc pentru comandă" pentru plăți reușite sau "Ceva nu a mers bine cu plata" pentru tranzacții eșuate, permițând clienților să-și continue călătoria fără probleme pe site-ul sau aplicația dvs.
Creați o sursă de plată pentru plățile online, navigând la Vânzări > Plăți online > Site-uri / Aplicații în tabloul de bord Viva.com.
Asigurați-vă că salvați codul sursă din 4 cifre al sursei de plată pe care tocmai ați creat-o, deoarece veți avea nevoie de el mai târziu în scopuri de integrare și configurare.
Exemplu de configurare a sursei de plată cu codul sursă 5801
Verificați aici un ghid detaliat despre cum să creați o Sursă pentru plăți online
➤ Ghid de integrare pas cu pas
Pașii cheie de integrare
Crearea ordinului de plată
Redirecționați către Smart Checkout
Gestionați returul clienților și verificați rezultatul plății
➥ Pasul 1: Creați ordinul de plată |
Pentru a solicita o plată de la unul dintre clienții dvs., trebuie să creați un ordin de plată. Fiecărui ordin de plată i se atribuie un ID unic din 16 cifre, cunoscut și sub numele de orderCode.
Puteți genera ordinul de plată folosind API-ul Creare ordin de plată pe server și puteți transmite orderCode site-ului sau aplicației dvs.
Pentru mai multe detalii despre cum să configurați un ordin de plată, consultați ghidul nostru detaliat pe portalul nostru pentru dezvoltatori aici și aici.
➥ Pasul 2: Redirecționați clientul către Smart Checkout |
Când sunt redirecționați, clienții vor vedea formularul Smart Checkout pentru a-și introduce detaliile de plată și a finaliza tranzacția.
➤ Opțiuni suplimentare pentru Smart Checkout
Opțiuni pentru sursa de plată
Afișați logo-ul mărcii dvs.
Puteți include logo-ul mărcii pentru a fi afișat în Smart Checkout configurându-l în setările Sursei de plată. Există un ghid detaliat pe portalul nostru pentru dezvoltatori aici.
Adăugarea logo-ului îmbunătățește experiența clienților prin consolidarea identității mărcii în timpul procesului de plată. Asigurați-vă că încărcați un logo clar și de dimensiuni adecvate pentru o afișare optimă.
➤ Afișarea unui buton de anulare
Furnizarea unui buton Anulare oferă flexibilitate clienților și ajută la îmbunătățirea experienței generale a utilizatorului.
Puteți configura un buton Anulare pe Smart Checkout pentru a oferi clienților opțiunea de a-și anula comenzile. Acesta este gestionat la nivel de sursă de plată (sub Configurare avansată), oferindu-vă controlul asupra disponibilității butonului Anulare pentru comenzile asociate unei anumite surse.
Platforme acceptate: Butonul Anulare este acceptat în prezent pentru integrări directe Smart Checkout și pluginuri pentru Shopify și PrestaShop.
Suport webhook: Puteți configura webhook-uri pentru a primi notificări pentru evenimentele de anulare a comenzii. Urmați acest ghid de configurare webhook pentru mai multe informații
➥ Pasul 3: Gestionați returnarea clientului și verificați rezultatul plății |
Gestionați returnarea clienților
După plată, clienții sunt redirecționați către:
URL de succes pentru plăți reușite.
URL de eroare pentru plăți eșuate.
Puteți configura aceste setări prin tabloul de bord al contului Viva.com în Vânzări > Plăți online > Site-uri / Aplicații
Verificați rezultatul plății
Verificarea asigură finalizarea cu succes a tranzacției. Pentru a valida starea unei tranzacții în sistemul dvs., verificați încrucișat următorii parametri: Amount, transactionId, statusId (Vizualizați toate codurile StatusId)
➤ Metode recomandate de verificare a plăților:
Webhook-uri:
Primiți actualizări în timp real pentru succesul sau eșecul plăților.
Consultați documentația noastră despre webhook-urile Transaction Payment Created și Transaction Failed pentru mai multe detalii despre implementare, exemple de sarcini utile și explicații ale tuturor parametrilor.
Acoperă atât metodele de plată sincrone, cât și metodele de plată asincrone.
Preluați API-ul de tranzacții:
Pentru mai multe detalii despre apelul API și parametrii acestuia, consultați documentația Retrieve Transaction API de pe portalul nostru pentru dezvoltatori
➤ Configurare suplimentară
Cu Viva.com Smart Checkout am pregătit multe funcții și instrumente pe care le puteți utiliza și le puteți oferi clienților mai multe opțiuni pentru plățile lor.
Plăți recurente: O metodă de plată în care comerciantul (dvs.) inițiază automat debitări pe un program predefinit, fără a implica clientul după prima plată.
Pre-autorizații: O metodă de plată utilizată pentru a verifica disponibilitatea fondurilor și a rezerva suma, transferul efectiv de fonduri fiind inițiat ulterior.
Puteți găsi ghiduri detaliate pe portalul dezvoltatorului pentru a continua cu toate configurațiile pe care le puteți face prin contul dvs. pentru a accepta plăți online, precum și pentru a explora toate alternativele și serviciile pe care le oferim.