Vejledning til Smart Checkout-integration

Viva.com Smart Checkout giver dig mulighed for at modtage onlinebetalinger via en hostet betalingsside.

Denne guide beskriver de vigtigste trin til at integrere Smart Checkout med dit website eller din app – fra opsætning af din Viva.com-konto og betalingskilde til omdirigering af kunder og bekræftelse af betalingsresultatet.

1. Vælg dit Viva.com-miljø

Viva.com tilbyder to miljøer. Sørg for, at du bruger det miljø, der passer til det, du vil foretage dig.

Miljø	Brug det til	Kom godt i gang
Produktion	Modtagelse af rigtige betalinger	Sådan opretter du en Viva.com-konto \| Viva.com Support
Demo	Test af din integration og testbetalinger	Sådan kommer du i gang med en sandbox/demo-konto \| Viva.com Support

Sørg for, at du arbejder i det korrekte miljø, når du opsætter og tester din integration.

2. Opret en betalingskilde til onlinebetalinger

En betalingskilde indeholder de indstillinger, som Viva.com bruger til betalinger foretaget via dit website eller din app.

Når du opsætter din betalingskilde, skal du konfigurere dit domæne og de URL'er, som kunderne skal vende tilbage til efter at have gennemført betalingsprocessen.

For eksempel:

en side for gennemført betaling, f.eks. "Tak for din ordre"
en side for mislykket betaling, f.eks. "Noget gik galt med din betaling"

For at oprette en betalingskilde til onlinebetalinger skal du gå til Salg > Online Betalinger i dit Viva.com-dashboard.

Når du har oprettet betalingskilden, skal du gemme dens 4-cifrede kildekode. Du skal bruge denne kode, når du konfigurerer din integration.

Du kan finde detaljerede opsætningsinstruktioner under Kilde til online betalinger | Viva.com Support.

3. Integrer Smart Checkout

Der er tre hovedtrin til integration af Smart Checkout:

Trin 1: Opret en betalingsordre

Før du anmoder om en betaling fra en kunde, skal du oprette en betalingsordre.

Hver betalingsordre tildeles et unikt 16-cifret ID kaldet orderCode.

Opret betalingsordren fra din server ved hjælp af Create Payment Order API, og send derefter orderCode til dit website eller din app.

For API-parametre og implementeringsoplysninger skal du besøge Viva.com Developer Portal. I menuen til venstre skal du vælge APIs for payments, derefter Payment API. Under Payments skal du vælge Create payment order.

Trin 2: Omdiriger kunden til Smart Checkout

Når du har oprettet betalingsordren, skal du omdirigere kunden til Smart Checkout. Kunden kan derefter indtaste sine betalingsoplysninger og gennemføre betalingsprocessen på Smart Checkout-siden.

Trin 3: Håndter kundens tilbagevenden, og bekræft betalingsresultatet

Efter betalingsprocessen omdirigeres kunden til den URL, der er konfigureret til det relevante resultat:

Success URL for gennemførte betalinger
Failure URL for mislykkede betalinger

Du kan konfigurere disse URL'er i dit Viva.com-dashboard under Salg > Online Betalinger > Hjemmesider/Apps.

Bekræft betalingsresultatet

Bekræft transaktionsstatussen i dit system ved hjælp af de betalingsoplysninger, der returneres af Viva.com. De transaktionsoplysninger, der bruges til validering, omfatter:

Amount
transactionId
statusId

Viva.com tilbyder følgende metoder til at kontrollere betalingsresultatet.

Webhooks

Webhooks gør det muligt for dit system at modtage meddelelser om gennemførte eller mislykkede betalinger og understøtter både synkrone og asynkrone betalingsmetoder.

For implementeringsoplysninger, hændelsesparametre og eksempler på payloads skal du besøge Viva.com Developer Portal og vælge Webhooks For Payments i menuen.

Retrieve Transaction API

Du kan også hente transaktionsoplysninger ved hjælp af Retrieve Transaction API. For API-parametre og implementeringsoplysninger skal du besøge Viva.com Developer Portal. I menuen til venstre skal du vælge APIs for payments, derefter Payment API. Under Transactions skal du vælge Retrieve transaction.

Valgfrie indstillinger for Smart Checkout

Du kan også konfigurere yderligere indstillinger for Smart Checkout baseret på behovene for din integration.

Vis dit brandlogo

Du kan føje dit brandlogo til Smart Checkout via indstillingerne for din betalingskilde. For instruktioner skal du besøge Viva.com Developer Portal, gå til Tutorials, vælge Smart Checkout Configuration og derefter klikke på Add your brand logo.

Sørg for at uploade et tydeligt logo i en passende størrelse for at sikre optimal visning.

Vis en Cancel-knap

Du kan konfigurere en Cancel-knap i betalingskildens avancerede konfigurationsindstillinger. Det giver kunderne mulighed for at annullere deres ordre.

Cancel-knappen understøttes ved direkte Smart Checkout-integrationer og plugins til Shopify og PrestaShop.

Du kan også konfigurere webhooks til at modtage meddelelser om hændelser vedrørende annullering af ordrer. Besøg Viva.com Developer Portal, vælg Webhooks For Payments, og vælg derefter Order Updated for at få flere oplysninger.

Yderligere betalingsmuligheder

Smart Checkout understøtter også yderligere betalingskonfigurationer, herunder:

Tilbagevendende betalinger: Forhandleren initierer automatisk betalinger efter en på forhånd fastlagt tidsplan efter den første betaling.
Forhåndsgodkendelser: Et beløb reserveres, og overførslen af pengene igangsættes senere.

For tekniske implementeringsoplysninger og andre tilgængelige Smart Checkout-konfigurationer skal du besøge Viva.com developer portal.

Har du stadig brug for hjælp? Vores team er klar til at hjælpe dig. Kontakt os via Chat med os på din Viva.com-konto.