Viva.com Smart Checkout gjør det mulig å motta nettbetalinger via en driftet betalingsside.
Denne veiledningen forklarer de viktigste trinnene for å integrere Smart Checkout med nettstedet eller appen din, fra oppsett av Viva.com-kontoen og betalingskilden til omdirigering av kunder og verifisering av betalingsresultatet.
1. Velg Viva.com-miljøet ditt
Viva.com tilbyr to miljøer. Sørg for at du bruker miljøet som passer til det du ønsker å gjøre.
Miljø | Bruk det til | Kom i gang |
Produksjon | Motta reelle betalinger | |
Demo | Teste integrasjonen og testbetalinger |
Sørg for at du arbeider i riktig miljø når du konfigurerer og tester integrasjonen.
2. Opprett en betalingskilde for nettbetalinger
En betalingskilde inneholder innstillingene Viva.com bruker for betalinger som utføres via nettstedet eller appen din.
Når du konfigurerer betalingskilden, må du konfigurere domenet ditt og URL-adressene kundene skal returneres til etter at betalingsprosessen er fullført.
For eksempel:
en side for vellykket betaling, for eksempel «Takk for bestillingen»
en side for mislykket betaling, for eksempel «Noe gikk galt med betalingen din»
For å opprette en betalingskilde for nettbetalinger går du til Salg > Online betalinger i Viva.com-dashbordet.
Når du har opprettet betalingskilden, lagrer du den 4-sifrede kildekoden. Du trenger denne koden når du konfigurerer integrasjonen.
Du finner detaljerte instruksjoner for oppsett under Kilde for netbetalinger | Viva.com Support.
3. Integrer Smart Checkout
Det er tre hovedtrinn for å integrere Smart Checkout:
Trinn 1: Opprett en betalingsordre
Før du ber om betaling fra en kunde, må du opprette en betalingsordre.
Hver betalingsordre tildeles en unik 16-sifret ID, kalt orderCode.
Opprett betalingsordren fra serveren din ved hjelp av Create Payment Order API, og send deretter orderCode til nettstedet eller appen din.
For API-parametere og implementeringsdetaljer går du til Viva.com Developer Portal. I menyen til venstre velger du APIs for payments, deretter Payment API. Under Payments velger du Create payment order.
Trinn 2: Omdiriger kunden til Smart Checkout
Når du har opprettet betalingsordren, omdirigerer du kunden til Smart Checkout. Kunden kan deretter angi betalingsopplysningene sine og fullføre betalingsprosessen på Smart Checkout-siden.
Trinn 3: Håndter kundens retur og verifiser betalingsresultatet
Etter betalingsprosessen blir kunden omdirigert til URL-adressen som er konfigurert for det aktuelle resultatet:
Success URL for vellykkede betalinger
Failure URL for mislykkede betalinger
Du kan konfigurere disse URL-adressene i Viva.com-dashbordet under Salg > Online betalinger > Nettsider/Apper.
Verifiser betalingsresultatet
Verifiser transaksjonsstatusen i systemet ditt ved hjelp av betalingsinformasjonen som returneres av Viva.com. Transaksjonsinformasjonen som brukes til validering, omfatter:
AmounttransactionIdstatusId
Viva.com tilbyr følgende metoder for å kontrollere betalingsresultatet.
Webhooks
Webhooks gjør det mulig for systemet ditt å motta varsler om vellykkede eller mislykkede betalinger og støtter både synkrone og asynkrone betalingsmetoder.
For implementeringsdetaljer, hendelsesparametere og eksempler på payloads går du til Viva.com Developer Portal og velger Webhooks For Payments i menyen.
Retrieve Transaction API
Du kan også hente transaksjonsinformasjon ved hjelp av Retrieve Transaction API. For API-parametere og implementeringsdetaljer går du til Viva.com Developer Portal. I menyen til venstre velger du APIs for payments, deretter Payment API. Under Transactions velger du Retrieve transaction.
Valgfrie Smart Checkout-innstillinger
Du kan også konfigurere flere Smart Checkout-innstillinger basert på behovene for integrasjonen din.
Vis merkevarelogoen din
Du kan legge til merkevarelogoen din i Smart Checkout via innstillingene for betalingskilden. Du finner instruksjoner i Viva.com Developer Portal. Gå til Tutorials, velg Smart Checkout Configuration, og klikk deretter på Add your brand logo.
Sørg for at du laster opp en tydelig logo i passende størrelse for optimal visning.
Vis en Cancel-knapp
Du kan konfigurere en Cancel-knapp i de avanserte konfigurasjonsinnstillingene for betalingskilden. Dette gir kundene mulighet til å kansellere bestillingen.
Cancel-knappen støttes for direkte Smart Checkout-integrasjoner og plugins for Shopify og PrestaShop.
Du kan også konfigurere webhooks for å motta varsler om hendelser knyttet til kansellering av bestillinger. Gå til Viva.com Developer Portal, velg Webhooks For Payments, og deretter Order Updated for mer informasjon.
Flere betalingsalternativer
Smart Checkout støtter også flere betalingskonfigurasjoner, blant annet:
Gjentakende betalinger: Forhandleren initierer belastninger automatisk i henhold til en forhåndsdefinert tidsplan etter den første betalingen.
Forhåndsautorisasjoner: Et beløp reserveres, og overføringen av midlene igangsettes senere.
For tekniske implementeringsdetaljer og andre tilgjengelige Smart Checkout-konfigurasjoner går du til Viva.com developer portal.
Trenger du fortsatt hjelp? Teamet vårt er her for å hjelpe deg. Ta kontakt med oss via alternativet Chat med oss på Viva.com-kontoen din.