Web Ansøger - DIBS integration Installationsvejledning BOULEVARDEN 19E 7100 VEJLE LERSØ PARKALLE 101 2100 KØBENHAVN Ø TLF. 76 42 11 00 WWW.UNIK.DK
Indholdsfortegnelse Indholdsfortegnelse... 1 Indledning... 2 Præsentation af betalingen... 3 UnikBolig4 opsætning... 9 Filer -> Indstillinger... 9 Forretningsgangen Web Venteliste Almen... 9 Online betaling forretningsgang... 9 Opkrævning af kortgebyr... 11 DIBS opsætning... 12 Returværdier... 12 MD5 nøgler... 12 Callback... 13 Instant capture... 14 Test... 14 FlexWin... 14 Severity og suspect... 15 Webserver... 17 Ordreopfølgning i Unik... 18 Visiteringsguiden... 18 Admin i Web Ansøger... 18 FAQ... 20 Fejlende callback... 20 Hængende ordrer... 21 Godkend og afbryd ordre... 21 Test uden at køre i testtilstand... 21 "Invalid amount for transaction" i visiteringsguiden... 21 1 af 21
Indledning Denne vejledning beskriver opsætning og anvendelse af DIBS integration i Unik web ansøger. Integrationen benytter DIBS FlexWin inline. Ved FlexWin integrationer omdirigeres brugeren under selve betalingen til DIBS web site hvor betalingen gennemføres inden brugeren har mulighed for at vende tilbage til kvitteringssiden i Web Ansøger. 2 af 21
Præsentation af betalingen Selve betalingsproceduren ser ud som beskrevet i det følgende. Skærmbillederne fra betalingen på DIBS website anvender Unik s decorator udkast. Læs mere om decorators i afsnittet Fejl! Henvisningskilde ikke fundet.. 3 af 21
4 af 21
5 af 21
6 af 21
7 af 21
8 af 21
UnikBolig4 opsætning Filer -> Indstillinger Under Filer->Indstillinger kan du sætte DIBS betalingssystemet i testtilstand. Husk, at det kræver, at DIBS også har aktiveret testtilstanden på deres side. Forretningsgangen Web Venteliste Almen I forretningsgangen Web Venteliste Almen kan du sætte emailtekster op, angive om du benytter SSL, samt angive om du benytter online betaling. Online betaling forretningsgang Da DIBS betalingsmetoden FlexWin ikke understøtter flere betalingsmodtagere må man kun knytte forretningsgangen Online Betaling på totalniveau. Der må kun være én forretningsgang. Forretningsgangen indeholder en række felter til konfiguration af DIBS integrationen. 9 af 21
Felterne er: Generelt Kontonavn: Den likvidkonto som DIBS aftalen er oprettet på. Forretningsid: Dit forretnings ID for din aftale med DIBS. Skal udfyldes. Opkræv kortgebyr hos brugeren: Angiver om kortgebyret ved betalingen skal opkræves hos brugeren. Se også afsnit Opkrævning af kortgebyr. Tjek først status af uafsluttede efter antal timer: Antal timer fra en ordre er påbegyndt, i webben til visiteringsguiden kontrollerer ordre status hos DIBS. Dette gælder kun ordrer hvor der ikke er registreret en endelig status som fx gennemført eller afbrudt. Det anbefales at sætte værdien til et tal større end 0. Flex Win/Transaktions API: Dette er den adresse hos DIBS som Unik Bolig 4 systemet bruger for at hente status på ordrer med ukendt status. Udfyldes automatisk og skal være udfyldt. DIBS Flex Window Betalingsurl: Dette er den adresse hos DIBS hvor brugeren henvises til og udfører selve online betalingen. Udfyldes automatisk og skal være udfyldt. MD5 nøgle1 til betaling: MD5 nøglerne, der findes på din DIBS administrationsside. Se mere om dette i afsnittet MD5 nøgler. Felterne skal udfyldes. MD5 nøgle2 til betaling: Se ovenfor. Check status hos DIBS for uafsluttede ordrer (visiteringsguiden): Angiver om visiteringsguiden skal kontrollere ordrer, der er registreret som påbegyndt, men ikke har fået en endelig status som for eksempel gennemført eller afbrudt. Det anbefales på det kraftigste at aktivere denne. Vis alle fejlede ordrer fra DIBS: Angiver om ordrer som DIBS har fejlmeldt, skal vises og behandles. Fejlteksten fra DIBS vil blive vist, sammen med de informationer der måtte være tilknyttet ordren. Det anbefales på det kraftigste at aktivere denne. DIBS Payment Window: Bruges af nye webløsninger. Herunder Beboer Web. Betalingsurl: URL findes i DIBS's tekniske dokumentation. HMAC nøgle til betaling: HMAC nøgle aflæses i DIBS administrationsværktøjet. 10 af 21
Opkrævning af kortgebyr Det er desværre et problem, at DIBS ikke understøtter automatisk kontrol af ordrer, hvis man opkræver kortgebyr hos brugeren (calcfee). DIBS skriver: "Det er korrekt, at det er et problem, når man benytter sig af calcfee for da er "amount" = amount+fee og fee kan I heller ikke få via API. Der er en sag på det hos vores udviklingsafdeling. Så p.t er den nemmeste løsning for kunderne at logge på dibs administrationen og se hvad status er." Dette er årsagen til visiteringsguiden ikke kan kontrollere ordrestatus på påbegyndte ordrer, hvis man opkræver kortgebyret hos brugeren. I det tilfælde vil man få fejlmeddelelsen "Invalid amount for transaction". Unik anbefaler, at du ikke opkræver kortgebyr før DIBS retter problemet. 11 af 21
DIBS opsætning Dette afsnit beskriver de indstillinger du skal have eller lave på din DIBS aftale. Opsætningen foretages ved at logge ind hos DIBS med din konto. Returværdier De markerede returværdier skal vælges. MD5 nøgler Under MD5 nøgler danner du de MD5 nøgler, du skal sætte op i forretningsgangen Online Betaling. 12 af 21
Callback Når en bruger gennemfører eller annullerer en betaling på DIBS betalingssider, så udfører DIBS et callback til Web Ansøger. Det betyder, at deres system laver et maskin-til-maskin kald til Web Ansøger. Det er en service, der udføres, da det ikke er sikkert at brugeren klikker videre til kvitteringssiden i Web Ansøger. På den måde sikres det, at Web Ansøger altid bør få besked om afslutningen af betalinger. Hvis du tester på en intern server eller rettere på en intern url der ikke er offentligt tilgængeligt, så vil callbacks fejle, da DIBS systemer ikke vil kunne nå Web Ansøger. Det kan også betyde, at du kan opleve at testbetalinger hænger i op til omkring 30 sekunder når der klikkes på knappen til gennemførelse af betalingen på betalingssiden. Angiv en emailadresse for at få tilsendt mails om fejlede callbacks. Det anbefales medmindre, du bevidst tester på en intern testserver, der ikke er eksternt tilgængelig. Se også afsnittet Webserver. 13 af 21
Instant capture DIBS understøtter muligheden for instant capture. Det betyder, at ordre-beløbet opkræves med det samme. På den måde kan man slippe for manuelt at skulle ind og gennemføre ordrer. For at køre Web Ansøger med instant capture skal man blot bede DIBS om at aktivere det på kontoen. DIBS anfører følgende vedr. instant capture. "Du skal dog være opmærksom på at ved en transaktion afvisning med "instant capture" kan man ikke skelne om det er en autorisation eller en capture afvisning." Test For at kunne køre Web Ansøger i testtilstand er det nødvendigt at DIBS aktiverer testtilstand på kontoen. Det er muligt at køre test og drift på samme tid. Husk også at vælge testtilstand i UnikBolig4 i Filer->Indstillinger. FlexWin Under dette menupunkt uploades decorator filer og billeder. Bemærk, at du ikke må fravælge kvitteringssiden, da det ikke vil fungere sammen med Web Ansøger. Decorators er en feature som DIBS stiller til rådighed for deres kunder til at tilrette udseendet af betalingssiderne. Det kan benyttes til at få samme layout på betalingssiderne som på Web Ansøger siderne. Unik leverer decorators til Uniks standard layout som en del af Web Ansøger. Filerne er placeret i installationsmappen under PagesAlmen\PagesDefault\Layout: Dekorator: decorator.xml 14 af 21
Scripting: Ingen fil Stilark (CSS): UnikVentelisteMain.css Nyt billede: favicon.ico Severity og suspect Her kan du sætte op hvordan du ønsker at håndtere suspekte betalinger. Der er også mulighed for at få tilsendt emails i tilfælde af suspekte betalinger. 15 af 21
16 af 21
Webserver Web serveren skal placeres i DMZ en, hvor den kan nås udefra. Selvom web serveren kan nås internt med en intern web adresse eller IP-adresse, så er det afgørende, at man benytter den eksterne adresse ved test. Årsagen er at callback-adressen udledes af den adresse hvormed web forespørgslen blev foretaget. Denne adresse sendes til DIBS, som ved gennemført betaling forsøger at kalde tilbage til webløsningen på den givne adresse. Dette callback vil således fejle, hvis der testes med en intern adresse. Hvis der testes med en intern adresse kan man risikere at betalinger "hænger" længe på DIBS betalingsside. 17 af 21
Ordreopfølgning i Unik Det er muligt at lave ordreopfølgning på DIBS administrationssiden. Herudover tilbyder Unik et par funktioner til understøttelse af ordreopfølgning. Disse funktioner findes i visiteringsguiden og på admin siden i Web Ansøger. Visiteringsguiden I forbindelse med at ansøgervisiteringen vælges, sker der en kontrol af ventelisteordrer. Ordrer, der står til at være påbegyndt, men hvor der ikke er meldt tilbage med, at der er sket en indbetaling, behandles. Hvis det er valgt i forretningsgangen vises også ordrer der fejlmeldes fra DIBS. Den enkelte ordre vises med oplysning om ansøgernavn, adresse, email og fødselsdato. Der vises yderligere oplysning om indmeldelse, opnoteringer og fleksible kriterier. Stop: Ordren behandles ikke, og kontrollen af øvrige ordrer afbrydes. Udsæt: Ordren markeres udsat, og vil blive vist igen næste gang visiteringen påbegyndes. Kontrollen fortsættes, og den næste ordre, der skal behandles, vises. Behandlet: Ordren markeres behandlet, og vil ikke blive vist igen. Kontrollen fortsættes, og den næste ordre der skal behandles vises. Admin i Web Ansøger DIBS ordrer vises i et grid. Der er mulighed for at afgrænse på dato og for kun at vise ordrer, som er registreret som påbegyndte, men hvor der ikke er kommet svar fra DIBS eller brugeren har valgt at afbryde betalingen. 18 af 21
Griddet understøtter sortering og gruppering. 19 af 21
FAQ Fejlende callback Den mest almindelige årsag til at callback fejler skyldes, at man tester med en intern url mode webløsningen. Det er derfor vigtigt at huske at anvende den eksterne adresse selvom det drejser sig om intern test. Hvis man har valgt at modtage mails ved fejlet callback vil man modtage mails, der ligner nedenstående. Sandsynligvis vil der være en supplerende halvkryptisk information. På DIBS administrationsside vil autoriserede ordrer, hvor callback er fejlet være markeret med en rød stjerne. 20 af 21
Hængende ordrer Hvis online betalingen hænger efter indtastning af kortoplysninger og tryk på godkend knappen, så skyldes det sandsynligvis, at web serveren ikke er tilgængelig udefra, eller at man ikke har testet med en ekstern IP-adresse. Se også afsnit Callback. Godkend og afbryd ordre Der er efter vores mening en fejl på DIBS betalingssiden. Hvis brugeren kan nå det (kan fx ske hvis siden "hænger"), så kan han nå at godkende betalingen og dernæst vælge at afbryde den. Det kan resultere i at ordren bliver gennemført hos DIBS, men registreres som værende afbrudt i Unik. DIBS har erkendt uhensigtsmæssigheden. Det er dog primært et problem i testsystemer, hvor man ikke tester med en ekstern web adresse. Det er muligt at løse med lidt javascript, hvis man laver sin egen decorator. Test uden at køre i testtilstand Det er muligt at foretage test på drift-systemer uden at anvende test-tilstanden. Man kan blot benytte sit betalingskort og derefter annullere betalingen i DIBS administrationen. Hvis man anvender instant capture kan man i stedet vælge at refundere beløbet. Om bevægelsen i sidstnævnte tilfælde optræder på kontoudtoget afhænger af, om beløbet er nået at blive hævet inden refusionen. "Invalid amount for transaction" i visiteringsguiden Hvis visiteringsguiden viser fejlbeskeden "Invalid amount for transaction" for en eller flere ordrer skyldes det sandsynligvis, at der er valgt at opkræve kortgebyr (forretningsgangen Online betaling). Se afsnit Opkrævning af kortgebyr. 21 af 21