Installera Surfboard-terminal

TerminalernaDet finns två "trådade" terminaler som funkar i Jupiter och Rebnis Kassa. De heter SurfPad och SurfTouch och är trådlösa, även om de beter sig som traditionella trådkopplade terminaler i våra program. Man trycker på "ta betalt" och köpet dyker upp i terminalen. Det går alltså inte att hämta nota eller liknande i dom.Terminalerna kommunicerar med omvärlden via 5G och behöver således inte köras via kundens wifi. Kommunikationen mellan terminal och program ser också lite annorlunda ut jämfört med de terminaler vi traditionellt integrerat. I detta fallet "pratar" Jupiter (via CardPayment) och Rebnis Kassa med molntjänsten "Rebnis Cloud" som i sin tur kontaktar Surfboards molntjänst som till slut kontaktar terminalen när en gäst vill betala.När betalningen är slutförd går sedan kommunikationen omvänd väg tillbaka till våra program. Detta innebär att kunden inte kommer kunna ta betalt via kort om deras internet slutar fungera, för då kan inte vi få kontakt med terminalen.En annan sak som skiljer dessa terminaler från andra är att de inte behöver göra något dagsavslut. Så det automatiska kortterminalavslutet som görs i Rebnis Kassa i samband med Z-rapporten är inaktiverat när man kör Surfboard-terminaler.Det går även att "dela" på en en terminal så att den används i både Jupiter och Rebnis Kassa.Det går INTE att knappa manuella kortnummer i dessa terminaler, så tanken är då att kunden får använda sig av så kallade manuella betallänkar. Mer om det här (Sven skriv något här).Första installationenOm de inte kört någon Surfboard-terminal sedan tidigare, behöver vissa förfaranden vidtas innan det går att köra igång. Versionskrav (minst dessa versioner krävs):Jupiter 2025.2.0CardPayment 7.0.0Portalen 1.5.1Rebnis Kassa 2.17.1Portalen 1.5.1Annat som krävs:Kunden måste vara registrerad i SurfBoards partnerportal och därigenom fått ett MerchantId, som sedan ska anges i Portalen. För att kunna köra igång dessa så behöver man ett ID som finns på de olika terminalerna. På Surfpad finns de ett id/serie-nummer på baksidan som skall anges vid aktivering i partnerportalen. På SurfTouch så ska man starta terminalen för att få upp ett ID första gången som man då ska ange i partnerportalen.Aktivera "unlinked refunds":För att kunden ska kunna göra returköp måste vi be SurfBoard aktivera "unlinked refunds" för kunden/merchant. Detta görs via vår gemensamma slack-kanal.Aktivera terminalenInnan terminalen går att registrera (se nedan) måste den även aktiveras på den merchant som ska använda den. Så börja alltid med att be kunden skicka oss serienumret på den/de terminaler som ska installeras. Det står på en klisterlapp på terminalens baksida och börjar med "S/N xxx".När du fått serienumret aktiverar du terminalen genom att göra följande:Logga in i vår Partner Portal hos Surfboard (https://partner.surfboardpayments.com)Gå till "Merchants" och välj sedan den kund det gällerKlicka på "Terminals"Tryck sedan på "Activate Terminal"Knappa in terminalens serienummerSka du aktivera flera terminaler kan du även med fördel sedan trycka "Add Serial Number" så dyker ytterligare en inmatningsruta uppTryck sedan "Activate"Nu är terminalen aktiverad och du kan fortsätta med installationen enligt nedan.Registrera terminalenNär terminalen fått nätverk ska den registreras och "paras ihop" med kundens merchant hos Surfboard. Gör följande:Gå in i partner portalen och leta upp kunden därGå till deras store (ej "online store" eller "betallänkar")Klicka på "Register Terminal"Välj "Register Physical Terminal"Kunden bör se en sexsiffrig kod i sin terminal. Den ska nu anges här under "Registration ID"Döp även terminalen till något begåvat. Förslagsvis med "SurfTouch" i början.Välj sedan "Register Terminal"Nu borde terminalen ha blivit registrerad. Det kan dock i undantagsfall vara så att det misslyckas och det står något i stil med "No manufactured terminal found for the given serial number". Då måste man höra av sig till SurfBoard och be dom knyta terminalen till kundens merchant ID. Surfboard behöver terminalens serienummer som står på baksidan av terminalen ("S/N: 12345678").Inställningar i PortalenPortalen är ett måste för både Jupiter och Rebnis Kassa, då vissa av de inställningar som krävs för att komma igång görs där. När du uppdaterat eller säkerställt att minst version 1.5.1 av Portalen används, gör då följande:Surfa till http://[portalens adress]/settings/Se till att sökvägar och inställningar för Jupiter och/eller Rebnis Kassa är korrektaSkapa identifierare för Cloud/ConnectROm det inte står någon identifierare under avsnittet "Cloud/ConnectR" måste en sådan skapasTryck på "Skapa identifierare"Spara längst nedStarta sedan om Portalens tjänstNu har det skapats en "Tenant identifier" som sparats i våra databaser. Denna synkas sedan, i nästa steg, upp till vår molntjänst och är med i kommunikationen med SurfBoard. Men det saknas ändå några inställningar till innan vi kan köra igång. När Portalen gått igång igen gör du följande:Surfa till http://[portalens adress]/settings/connectrSidan är lösenordsskyddad, men låses upp med vårt vanliga lösenord (927441)Gå till fliken "Betalning" och sedan "Registrera enhet"Ange ett lämpligt namn, detta är vad terminalen kommer heta i Portalen. Döp den gärna till samma sak som den blev döpt till hos Surfboard när den registrerades där. Går att se här i deras portal  LänkAnge det "TerminalId" terminalen fått hos Surfboard när den registrerades därAnge kundens "MerchantId"Ange "Betalterminal" som betaltypSparaNu skapas en "Device" i ConnectR, med den "Tenant identifier" som tidigare angavs. Till den kopplas även det "MerchantId" och "TerminalId" som vi precis knappade in.Nu är inställningarna i Portalen färdiga och det är dags att ställa in uppgifterna i Jupiter och/eller Rebnis Kassa. Dessa inställningar är lika oavsett om det är första eller tionde terminalen som läggs till.JupiterFör att betala via Surfboard-terminalerna behövs terminalens "Terminal id". Det skapas när terminalen registreras i kundens verksamhet, via Surfboards Partner Portal. Gör sedan följande:Se till att CardPayment är installerat och fungerarGå till "Register -> Inställningar -> Betalkort" i JupiterAnge "Modular Visit" som betalkortsinterfaceSe till att rätt sökväg till CardPayment är inställdAnge det "DeviceId" som står i PortalenTryck "OK"Nu ska det funka att ta betalt via terminalen.Rebnis KassaFör att betala via Surfboard-terminalerna behövs terminalens "Terminal id". Det skapas när terminalen registreras i kundens verksamhet, via Surfboards Partner Portal. Gör sedan följande:Ställ in "Modular Visit" som leverantör under "Inställningar -> Integrationer -> Betalkort"Starta sedan om springaren på servernGå till klientregistret och dubbelklicka på den klient som terminalen ska användas påKnappa in terminalens "Device-id" som står i PortalenTryck "OK" och logga sedan ut och in i kassanNu ska det funka att ta betalt via terminalen.