Integratiehandleiding voor Smart Checkout

#Introductie

Integreer Viva.com Smart Checkout om klanten in staat te stellen veilige betalingen te doen via een gehoste afrekenpagina. Deze gids leidt u door de stappen voor naadloze integratie in uw website of app.

---

#➤ Maak uw Viva.com-account aan, als u er nog geen heeft

Viva.com twee verschillende omgevingen ondersteunt, zorg er dan voor dat u de juiste gebruikt:

#➤ Haal uw online betalingsbron op en bewaar uw broncode

Een betalingsbron is een configuratie-entiteit waarmee verkopers betalingsintegratie-instellingen voor hun websites of mobiele apps kunnen instellen en beheren.

Stel uw domein en de URL's in waar Viva.com Smart Checkout klanten omleidt nadat de betaling is voltooid. Deze URL's leiden meestal naar pagina's als 'Bedankt voor uw bestelling' voor succesvolle betalingen of 'Er is iets misgegaan met uw betaling' voor mislukte transacties, zodat klanten hun reis naadloos kunnen voortzetten op uw website of in uw app.

Maak een betalingsbron voor online betalingen door in het Viva.com dashboard naar Verkoop > Online betalingen > Websites / Apps te navigeren.

Zorg ervoor dat u de 4-cijferige broncode van de zojuist gemaakte betaalmethode opslaat, aangezien u deze later nodig heeft voor integratie- en configuratiedoeleinden.

Kijk hier voor een gedetailleerde handleiding over het maken van een Bron voor online betalingen

#➤ Stapsgewijze integratiehandleiding

Belangrijke stappen om te integreren

1. Maak de betaalopdracht aan

2. Omleiden naar Smart Checkout

3. Retour van de klant afhandelen en het betalingsresultaat verifiëren

➥ Stap 1: Maak de betaalopdracht aan

Als u een betaling van een van uw klanten wilt aanvragen, moet u een betaalopdracht aanmaken. Elke betaalopdracht krijgt een unieke 16-cijferige ID toegewezen, ook wel de orderCode genoemd.

U kunt de betaalopdracht genereren met behulp van de Create Payment Order API op uw server en de orderCode doorgeven aan uw website of app.

Voor meer informatie over het instellen van een betalingsopdracht raadpleegt u onze gedetailleerde gids op ons ontwikkelaarsportaal hier en hier.

➥ Stap 2: Leid de klant door naar Smart Checkout

Wanneer klanten worden doorgestuurd, zien ze het Smart Checkout-formulier om hun betalingsgegevens in te voeren en de transactie te voltooien.

#➤ Extra opties voor Slim Afrekenen

• Opties voor betalingsbron

• Toon uw merklogo

U kunt uw merklogo toevoegen aan Smart Checkout door het te configureren in de instellingen voor Betalingsbron. Er is een gedetailleerde gids op ons ontwikkelaarsportaal hier.

Het toevoegen van uw logo verbetert de klantervaring door uw merkidentiteit tijdens het betalingsproces te versterken. Zorg ervoor dat u een duidelijk logo met de juiste grootte uploadt voor een optimale weergave.

#➤ Een annuleerknop weergeven

Het bieden van een annuleerknop biedt flexibiliteit voor uw klanten en helpt de algehele gebruikerservaring te verbeteren.

U kunt een knop Annuleren configureren op Smart Checkout om klanten de mogelijkheid te bieden hun bestellingen te annuleren. Dit wordt beheerd op het niveau van de betalingsbron (onder Geavanceerde configuratie), zodat u kunt bepalen of de knop Annuleren beschikbaar is voor bestellingen die aan een specifieke bron zijn gekoppeld.

Ondersteunde platforms: De knop Annuleren wordt momenteel ondersteund voor directe Smart Checkout-integraties en plug-ins voor Shopify en PrestaShop.

Webhook-ondersteuning: U kunt webhooks configureren om meldingen te ontvangen voor annuleringen van bestellingen. Volg deze installatiehandleiding voor webhooks voor meer informatie

➥ Stap 3: Retour van de klant afhandelen en betalingsresultaat verifiëren

Retour van klanten afhandelen

Na betaling worden klanten doorgestuurd naar:

• Succes-URL voor succesvolle betalingen.

• Mislukte URL voor mislukte betalingen.

U kunt deze instellingen configureren via uw Viva.com Account Dashboard onder Verkoop > Online betalingen > Websites / Apps

Betalingsresultaat verifiëren

Verificatie zorgt ervoor dat de transactie met succes wordt voltooid. Als u de status van een transactie in uw systeem wilt valideren, controleert u de volgende parameters: Amount, transactionId, statusId Alle StatusId-codes weergeven

#➤ Aanbevolen betaalmethoden:

1. Webhaken:

   • Ontvang realtime updates over geslaagde of mislukte betalingen.

   • Raadpleeg onze documentatie over Transactiebetaling gemaakt en Transactie mislukt voor meer informatie over de implementatie, voorbeeldpayloads en uitleg van alle parameters.

   • Omvat zowel synchrone als asynchrone betaalmethoden.

2. Transactie-API ophalen:

   • Voor meer informatie over de API-aanroep en de parameters ervan raadpleegt u de documentatie Transactie-API ophalen op onze ontwikkelaarsportal

#➤ Extra installatie

Met Viva.com Smart Checkout hebben we veel functies en tools voorbereid die u kunt gebruiken en uw klanten meer opties kunt bieden voor hun betalingen.

• Terugkerende betalingen: Een betaalmethode waarbij de handelaar (u) automatisch kosten initieert volgens een vooraf bepaald schema zonder de klant erbij te betrekken na de eerste betaling.

• Pre-autorisaties: een betaalmethode die wordt gebruikt om de beschikbaarheid van geld te verifiëren en het bedrag te reserveren, waarbij de daadwerkelijke overdracht van geld later wordt geïnitieerd.

U kunt gedetailleerde handleidingen vinden op ons ontwikkelaarsportaal om door te gaan met alle configuraties die u via uw account kunt maken om online betalingen te accepteren, en om alle alternatieven en diensten die we aanbieden te verkennen.