A Viva.com Smart Checkout segítségével hosztolt fizetési oldalon keresztül fogadhat online fizetéseket.
Ez az útmutató bemutatja a Smart Checkout weboldalával vagy alkalmazásával történő integrációjának fő lépéseit, a Viva.com-fiók és a fizetési forrás beállításától kezdve az ügyfelek átirányításán át a fizetés eredményének ellenőrzéséig.
1. Válassza ki a Viva.com-környezetet
A Viva.com két környezetet biztosít. Győződjön meg arról, hogy a céljának megfelelő környezetet használja.
Környezet | Használja erre | Első lépések |
Éles | Valós fizetések fogadása | |
Demo | Az integráció és a tesztfizetések tesztelése |
Az integráció beállításakor és tesztelésekor győződjön meg arról, hogy a megfelelő környezetben dolgozik.
2. Hozzon létre fizetési forrást az online fizetésekhez
A fizetési forrás tartalmazza azokat a beállításokat, amelyeket a Viva.com a weboldalán vagy alkalmazásán keresztül végrehajtott fizetésekhez használ.
A fizetési forrás beállításakor konfigurálja a domainjét és azokat az URL-eket, amelyekre az ügyfeleket a fizetési folyamat befejezése után vissza kell irányítani.
Például:
egy sikeres fizetést jelző oldal, például „Köszönjük a rendelését”
egy sikertelen fizetést jelző oldal, például „Hiba történt a fizetés során”
Online fizetésekhez használható fizetési forrás létrehozásához a Viva.com irányítópultján lépjen az ÉRTÉKESÍTÉS (TRANZAKCIÓK, TERMINÁLOK, ONLINE FIZETÉSEK) > ONLINE FIZETÉSEK menüpontra.
A fizetési forrás létrehozása után mentse el annak 4 számjegyű forráskódját. Erre a kódra az integráció konfigurálásakor lesz szüksége.
A részletes beállítási útmutatóért tekintse meg a Forrás online fizetésekhez | Viva.com Támogatás című cikket.
3. Integrálja a Smart Checkout szolgáltatást
A Smart Checkout integrálása három fő lépésből áll:
1. lépés: Hozzon létre fizetési megbízást
Mielőtt fizetést kérne egy ügyféltől, hozzon létre egy fizetési megbízást.
Minden fizetési megbízáshoz egy egyedi, 16 számjegyű azonosító tartozik, amelynek neve orderCode.
Hozza létre a fizetési megbízást a szerveréről a Create Payment Order API használatával, majd adja át az orderCode értékét a weboldalának vagy alkalmazásának.
Az API paramétereivel és a megvalósítással kapcsolatos részletekért látogasson el a Viva.com Developer Portal oldalra. A bal oldali menüben válassza az APIs for payments, majd a Payment API lehetőséget. A Payments alatt válassza a Create payment order lehetőséget.
2. lépés: Irányítsa át az ügyfelet a Smart Checkout oldalra
A fizetési megbízás létrehozása után irányítsa át az ügyfelet a Smart Checkout oldalra. Az ügyfél ezután megadhatja fizetési adatait, és befejezheti a fizetési folyamatot a Smart Checkout oldalon.
3. lépés: Kezelje az ügyfél visszairányítását, és ellenőrizze a fizetés eredményét
A fizetési folyamat után az ügyfelet a rendszer az adott eredményhez konfigurált URL-re irányítja át:
Success URL a sikeres fizetésekhez
Failure URL a sikertelen fizetésekhez
Ezeket az URL-eket a Viva.com irányítópultján az ÉRTÉKESÍTÉS (TRANZAKCIÓK, TERMINÁLOK, ONLINE FIZETÉSEK) > ONLINE FIZETÉSEK > Weboldalak / applikációk menüpontban konfigurálhatja.
Ellenőrizze a fizetés eredményét
Ellenőrizze a tranzakció állapotát a rendszerében a Viva.com által visszaadott fizetési adatok segítségével. Az ellenőrzéshez használt tranzakciós adatok a következők:
AmounttransactionIdstatusId
A Viva.com a következő módszereket biztosítja a fizetés eredményének ellenőrzésére.
Webhooks
A Webhooks lehetővé teszi, hogy rendszere értesítéseket kapjon a fizetések sikerességéről vagy sikertelenségéről, és támogatja mind a szinkron, mind az aszinkron fizetési módokat.
A megvalósítás részleteiért, az eseményparaméterekért és a minta payloadokért látogasson el a Viva.com Developer Portal oldalra, és válassza a menüben a Webhooks For Payments lehetőséget.
Retrieve Transaction API
A tranzakciós adatokat a Retrieve Transaction API használatával is lekérheti. Az API paramétereivel és a megvalósítással kapcsolatos részletekért látogasson el a Viva.com Developer Portal oldalra. A bal oldali menüben válassza az APIs for payments, majd a Payment API lehetőséget. A Transactions alatt válassza a Retrieve transaction lehetőséget.
A Smart Checkout opcionális beállításai
Az integráció igényeinek megfelelően további Smart Checkout-beállításokat is konfigurálhat.
Jelenítse meg márkája logóját
A fizetési forrás beállításain keresztül hozzáadhatja márkája logóját a Smart Checkout szolgáltatáshoz. Az útmutatóért látogasson el a Viva.com Developer Portal oldalra, nyissa meg a Tutorials részt, válassza a Smart Checkout Configuration, majd kattintson az Add your brand logo lehetőségre.
Az optimális megjelenítés érdekében jól látható, megfelelő méretű logót töltsön fel.
Jelenítsen meg Cancel gombot
A fizetési forrás speciális konfigurációs beállításaiban konfigurálhat egy Cancel gombot. Ez lehetővé teszi az ügyfelek számára, hogy lemondják a rendelésüket.
A Cancel gomb a közvetlen Smart Checkout-integrációk, valamint a Shopify és PrestaShop bővítmények esetében támogatott.
Webhookokat is konfigurálhat, hogy értesítéseket kapjon a rendelések lemondásával kapcsolatos eseményekről. Látogasson el a Viva.com Developer Portal oldalra, válassza a Webhooks For Payments, majd az Order Updated lehetőséget a további információk megtekintéséhez.
További fizetési lehetőségek
A Smart Checkout további fizetési konfigurációkat is támogat, többek között:
Ismétlődő fizetések: A kereskedő az első fizetést követően egy előre meghatározott ütemezés szerint automatikusan kezdeményezi a terheléseket.
Előengedélyezések: A rendszer lefoglal egy összeget, a pénzösszeg átutalása pedig később történik meg.
A technikai megvalósítással és a Smart Checkout egyéb elérhető konfigurációival kapcsolatos részletekért látogasson el a Viva.com developer portal oldalra.
Továbbra is segítségre van szüksége? Csapatunk készséggel áll rendelkezésére. Kérjük, lépjen kapcsolatba velünk a Viva.com-fiókjában található Chateljen velünk lehetőségen keresztül.