Introduktion av API-lösningen
Information för betaltjänstleverantör
I texten nedan kan ”föreningssystem” utläsas som föreningssystem eller betaltjänstleverantör, beroende på sammanhang. När en betaltjänstleverantör har anslutit till Fritidskortet kommer betaltjänstleverantörens system hantera all direkt kommunikation med Fritidskortets API.
Syftet med API för föreningssystem är att möjliggöra anslutning av föreningssystem till den digitala tjänsten Fritidskortet, nedan förkortad till fritidskortstjänsten. Lösningen bygger på att Fritidskortet erbjuds som ett betalningsalternativ i föreningssystemets användargränssnitt. En betalning med Fritidskortet förutsätter att en vårdnadshavare lämnat en ansökan till E-hälsomyndigheten och att denna har beviljats. Hela ansökningsprocessen kommer att ske i fritidskortstjänstens användargränssnitt, men uppgifter från föreningssystemet kommer att ligga till grund för ansökan. Föreningssystemet kommer också att kunna följa ansökningsprocessen via API-anrop.
Figur: Gränssnitt Fritidskortet för en vårdnadshavare
Användarresa
Användarresan för vårdnadshavaren börjar i föreningssystemet där betalunderlag för aktuell fritidsaktivitet visas, exempelvis en faktura. Fritidskortet presenteras som ett betalningsalternativ enligt de presentationskrav som gäller. När betalningsalternativet Fritidskortet väljs slussas vårdnadshavaren vidare till fritidskortstjänsten där inloggning sker med e-legitimation.
Om vårdnadshavaren inte har ansökt om Fritidskortet tidigare behöver en sådan ansökan göras innan betalningsflödet kan fortsätta. Positivt utfall resulterar i ett påfyllt saldo för barnet.
För att betala gör vårdnadshavaren en ansökan om att använda Fritidskortet. Betalningsuppgifter såsom mottagare, Bankgiro-/Plusgironummer och belopp är förifyllda i ansökan. Efter signering av ansökan visas utfall och vårdnadshavaren slussas tillbaka till föreningssystemet. I föreningssystemet betalar vårdnadshavaren eventuellt återstående belopp att betala med något av de tillgängliga betalningsalternativen.
Figur: Översiktlig användarresa för en vårdnadshavare
Utbetalning vid positiv signal
Beslutet om att betala ut det ekonomiska stödet kommer endast att verkställas om det kommer en positiv signal från föreningssystemet. Vid avsaknad av sådan signal kommer E-hälsomyndigheten att avbryta utbetalningsprocessen genom att ändra tidigare fattat beslut. För att det ska bli tydligt för vårdnadshavaren kommer alla beslut och eventuella ändringar av beslut att visas i fritidskortstjänsten.
Figur: Beslut och verkställande av utbetalning