Allt du behöver veta om betallänkar

Så här funkar tjänsten i korthet:I Jupiter skapar anläggningen en begäran om att göra en ny betallänk. Denna sparas i databasen.Portalen kollar med jämna mellanrum ifall det kommit in någon ny begäran.Portalen hör sedan av sig till molntjänsten ConnectR och berättar att en ny betallänk ska skapas. ConnectR meddelar tillbaka till Portalen att betallänken skapats.Portalen ber att ConnectR ska skicka betallänken till gästen via SMS (om det är inställt)ConnectR skickar SMS'et med betallänken till gästenGästen surfar till betallänken och hamnar då på en webbsida som drivs av SurfBoard. Har betallänkens giltighetstid gått ut har ConnectR sett till att inaktivera betallänken och gästen blir då varse om att länken inte längre är giltig när hen surfar till den.Gästen läser igenom betalningsvillkor och liknande och klickar sig sedan vidare till själva betalsidan. Den sidan ligger hos Surfboard.Efter genomförd betalning rapporteras detta till CloudPortalen kollar med jämna mellanrum med Cloud ifall det genomförts några betalningar "sedan sist"När den märker att det kommit in en ny betalning ber den Jupiter Servern lägga in betalningen på bokningens notaBetalningen skapas i Jupiters databas...... och går nu att se i JupiterFörberedelser gentemot SurfboardHotellet måste givetvis redan vara kund hos Surfboard och helst även ha en "online store" registrerad. Men om det sistnämnda inte är gjort måste följande göras:Logga in i vår partner portal hos Surfboardhttps://partner.surfboardpayments.com/Inloggningsuppgifterna ligger i Aurora under RebnisGå till kundens merchant och sedan "Stores"Klicka på "Create store"Ange "Betallänkar" som namn och fyll sedan i resten av uppgifternaKlicka i "Do you want to enable online payments for your store?"Ett gäng nya inmatningsrutor visas då, fyll i följande:"http://surfboardmerchant.com/" under "Webshop URL""Payment Page URL" ska vara tomLänkar till hotellets egna "terms and conditions" samt "privacy policy""Google Pay Merchant ID" ska vara tomTryck sedan "Create Store"Nu är deras "online store" skapad. I och med det måste Surfboard godkänna den. Skriv till Surfboard i Operations-kanalen på Slack att en online store är skapad för merchant [merchant ID] och be dom kika på den och återkoppla när det är klart.När de blivit godkända av Surfboard återstår att skapa en "online terminal".Gör så här i Partner Portalen:Gå till hotellets merchantFliken "Stores"Välj sedan deras "online store", förhoppningsvis döpt till "Betallänkar"Välj "Register Terminal"Välj sedan "Register Online Terminal"Klicka på "Register Terminal"Nu är terminalen registrerad. Spara undan det ID terminalen fått, för det kommer behövas senare. Mer om det nedan.Installation och konfigurationDet som behöver vara installerat är Portalen (>= 1.5.1) samt Jupiter Server (>= 2025.1.0).Jupiter måste uppdateras till >= 2025.2.0.JupiterInställningar i Jupiter görs under Register > Inställningar > Ekonomi > BetallänkarBocka i "Använd betallänkar" och fyll i resten av inställningarna efter bästa förmåga.Under fliken "SMS-mallar" kan man justera hur SMS:en skall se utUnder fliken "Integrationer" kan man ställa in vilka betalsätt i Jupiter som skall användas för de olika betaltjänsterna. Just nu har vi officiellt bara stöd för Modular Visit/Surfboard.Tryck på "Visa integrationer"Mata in vårt gamla vanliga lösenord (927441)Kryssa i "Använd Modular Visit"Peka ut vilket betalsätt som ska användas för att markera upp genomförda betalningar i notan i JupiterHär ska även Device id i ConnectR fyllas i. Mer om det längre ned.Det finns även en genväg för att komma till inställningssidan på portalen.PortalDet finns två delar gällande inställningarna i Portalen.Kolla först följande:Surfa till http://[portalens adress]/settings/Kontrollera att det finns en "Tenant Identifier". Finns den så står den med grå text i denna ruta:Om den inte finns måste du trycka på "Skapa identifierare"Det kan även finnas lägen då "Hämta identifierare från databas" är lämplig att använda. T.ex. om de redan kört Portalen och har identifierare sparade i databaserna, men har sedan dess bytt server.SparaNästa del är själva inställningarna för betaltjänsten. Gör så här:Surfa till http://[portalens adress]/settings/connectrAnge vårt gamla vanliga lösenord (927441)Gå till fliken "Betalning" och sedan "Registrera enhet" och fyll i följandeNamn: Ange något lämpligt namn, förslagsvis "Betallänkar"Surfboard - TerminalId: Här ska anläggningens "OnlineTerminal Id" anges. Detta fås via SurfBoards Partner Portal. Gå in på kundens merchant, sedan store, välj "Betallänkar" och sedan bör online terminalen ligga upplagd där. Ta dess terminal ID.Surfboard - MerchantId: Anläggningens "MerchantId" hos Surfboard måste anges. Detta erhålls i samband med att anläggningen läggs upp i SurfBoards Partner Portal.Terminaltyp: Här ska "Betalsida online" väljasTryck "Lägg till enhet"Gå till fliken "Befintliga enheter"Kopiera det DeviceId som står på den enhet du precis la till (den heter förhoppningsvis "Betallänkar")Gå till Jupiter och sedan "Register -> Inställningar -> Ekonomi -> Betallänkar" och fliken "Integrationer"Klicka på "Visa integrationer" och skriv in vårt lösenordKlistra in DeviceId i för ändamålet avsedd rutaSpara genom att trycka "OK"När Surfboard-inställningarna är gjorda måste även inställningar för SMS göras.Gör så här:Gå till Portalen och surfa till http://[portalens adress]/settings/connectrGå till fliken "Meddelanden"Fyll i anläggningens namn under "Företagsnamn". Detta namn är inget som kommer visas i SMS-utskicken, utan används bara av oss för att (vid debitering kunna) identifiera vilken anläggning/kund det är som skickat SMS'enFyll i "Avsändare för SMS". Det är detta som kommer stå som avsändare i själva SMS-meddelandet som anläggningen skickar till sina gästerSparaNu borde allt vara klart och redo att köra igång!Intern testningFör att testa så får man köra molnbryggan lokalt, den består av två delar, WebAPI och WebApp och finns här: \\AKI\Builds\Bridge\WebAPI har en egen databas och kan köras mot PostgreSQL eller Firebird (>= 3.0).Alla inställningar görs i appsettings.json.Enklast är att utgå från appsettings.Development.json för WebAPI och WebApp.Man bör sätta portar i programmen och jag har valt 7298 för WebAPI och 7146 för WebApp (då det verkar vara vad utvecklarna kör på).PortalÄndra "BaseAddress": "https://pay.rebnis.se" till "BaseAddress": "http://localhost:7298"WebApp:Lägg till "Urls": "http://*:7146" i dokumentroten.WebAPI:Lägg till "Urls": "http://*:7298" i dokumentroten.Standard är att köra mot PostgreSQL men om man vill köra mot Firebird så kan man kopiera inställningarna för ConnectionStrings och DbProvider från appsettings.Rebnis.json.Ändra alla "dqvn9pcr-7298.euw.devtunnels.ms" till "localhost:7298" (eller motsvarande devtunnel-adress om man vill testa externt).Ändra alla "dqvn9pcr-7146.euw.devtunnels.ms" till "localhost:7146" (eller motsvarande devtunnel-adress om man vill testa externt).Spara ner Swish-certifikatet (Fråga Johan N) på lämpligt ställe och ställ in sökvägen på "CertificatePath".Inloggen man ställer in på Portalen (se början av guiden) för testning är:Nets EasyHemlig nyckel: test-secret-key-e2930dcf8a674a50aa2f1615bdeda8dbCheckout nyckel: test-checkout-key-3f41ccef0e9f4c189467ec9e7e58e959Sida för Nets testkort: https://developer.nexigroup.com/nexi-checkout/en-EU/docs/test-card-processing/SwishSwishnummer: 1234704896VaulterAnvändarnamn: modularvisitLabLösenord: Testaccount1278_$Fungerande personnummer för att testa bank/direktbetalning ("Open Payment"): 811228-9874Se till att köra in senaste staging-SQL:en och kör igång staging-versionerna av Portalen, Jupiter Server, WebApi, WebApp samt Jupiter så skall det förhoppningsvis fungera.