Viva.com Smart Checkout gör det möjligt för dig att ta emot onlinebetalningar via en hostad betalningssida.
Den här guiden beskriver de viktigaste stegen för att integrera Smart Checkout med din webbplats eller app, från att konfigurera ditt Viva.com-konto och din betalningskälla till att omdirigera kunder och verifiera betalningsresultatet.
1. Välj din Viva.com-miljö
Viva.com erbjuder två miljöer. Se till att du använder den miljö som motsvarar det du vill göra.
Miljö | Använd den för | Kom igång |
Produktion | Ta emot riktiga betalningar | |
Demo | Testa din integration och testbetalningar |
Se till att du arbetar i rätt miljö när du konfigurerar och testar din integration.
2. Skapa en betalningskälla för onlinebetalningar
En betalningskälla innehåller de inställningar som Viva.com använder för betalningar som görs via din webbplats eller app.
När du konfigurerar din betalningskälla ska du konfigurera din domän och de URL:er som kunderna ska återvända till efter att ha slutfört betalningsprocessen.
Till exempel:
en sida för lyckad betalning, till exempel ”Tack för din beställning”
en sida för misslyckad betalning, till exempel ”Något gick fel med din betalning”
För att skapa en betalningskälla för onlinebetalningar går du till Försäljning > Onlinebetalningar i din Viva.com-kontrollpanel.
När du har skapat betalningskällan sparar du dess 4-siffriga källkod. Du behöver den här koden när du konfigurerar din integration.
Detaljerade konfigurationsanvisningar finns i Källa för onlinebetalningar | Viva.com Support.
3. Integrera Smart Checkout
Det finns tre huvudsakliga steg för att integrera Smart Checkout:
Steg 1: Skapa en betalningsorder
Innan du begär en betalning från en kund ska du skapa en betalningsorder.
Varje betalningsorder tilldelas ett unikt 16-siffrigt ID som kallas orderCode.
Skapa betalningsordern från din server med hjälp av Create Payment Order API och skicka sedan orderCode till din webbplats eller app.
För API-parametrar och implementeringsinformation besöker du Viva.com Developer Portal. I menyn till vänster väljer du APIs for payments och sedan Payment API. Under Payments väljer du Create payment order.
Steg 2: Omdirigera kunden till Smart Checkout
När du har skapat betalningsordern omdirigerar du kunden till Smart Checkout. Kunden kan sedan ange sina betalningsuppgifter och slutföra betalningsprocessen på Smart Checkout-sidan.
Steg 3: Hantera kundens återkomst och verifiera betalningsresultatet
Efter betalningsprocessen omdirigeras kunden till den URL som har konfigurerats för det aktuella resultatet:
Success URL för lyckade betalningar
Failure URL för misslyckade betalningar
Du kan konfigurera dessa URL:er i din Viva.com-kontrollpanel under Försäljning > Onlinebetalningar > Webbsidor/Appar.
Verifiera betalningsresultatet
Verifiera transaktionsstatusen i ditt system med hjälp av betalningsinformationen som returneras av Viva.com. Transaktionsinformationen som används för validering omfattar:
AmounttransactionIdstatusId
Viva.com erbjuder följande metoder för att kontrollera betalningsresultatet.
Webhooks
Webhooks gör det möjligt för ditt system att ta emot aviseringar om lyckade eller misslyckade betalningar och stöder både synkrona och asynkrona betalningsmetoder.
För implementeringsinformation, händelseparametrar och exempel på payloads besöker du Viva.com Developer Portal och väljer Webhooks For Payments i menyn.
Retrieve Transaction API
Du kan även hämta transaktionsinformation med hjälp av Retrieve Transaction API. För API-parametrar och implementeringsinformation besöker du Viva.com Developer Portal. I menyn till vänster väljer du APIs for payments och sedan Payment API. Under Transactions väljer du Retrieve transaction.
Valfria inställningar för Smart Checkout
Du kan även konfigurera ytterligare Smart Checkout-inställningar utifrån behoven för din integration.
Visa din varumärkeslogotyp
Du kan lägga till din varumärkeslogotyp i Smart Checkout via inställningarna för betalningskällan. För instruktioner besöker du Viva.com Developer Portal, går till Tutorials, väljer Smart Checkout Configuration och klickar sedan på Add your brand logo.
Se till att du laddar upp en tydlig logotyp i lämplig storlek för optimal visning.
Visa en Cancel-knapp
Du kan konfigurera en Cancel-knapp i betalningskällans avancerade konfigurationsinställningar. Det ger kunderna möjlighet att avbryta sin beställning.
Cancel-knappen stöds för direkta Smart Checkout-integrationer och plugins för Shopify och PrestaShop.
Du kan även konfigurera webhooks för att ta emot aviseringar om händelser som rör avbrutna beställningar. Besök Viva.com Developer Portal, välj Webhooks For Payments och sedan Order Updated för mer information.
Ytterligare betalningsalternativ
Smart Checkout stöder även ytterligare betalningskonfigurationer, inklusive:
Återkommande betalningar: Handlaren initierar automatiskt debiteringar enligt ett fördefinierat schema efter den första betalningen.
Förauktoriseringar: Ett belopp reserveras och överföringen av pengarna initieras senare.
För teknisk implementeringsinformation och andra tillgängliga Smart Checkout-konfigurationer besöker du Viva.com developer portal.
Behöver du fortfarande hjälp? Vårt team finns här för att hjälpa dig. Kontakta oss via alternativet Chatta med oss på ditt Viva.com-konto.