FREEPAY betalingsgateway © Freeway ApS

Udviklet af

INFORMATION

Opsætning

Frontend har IP: 192.152.39.13
Backend har IP: 192.152.38.150

Relaying

Hvis ikke din butik selv har et SSL-certifikat, kan butikken benytte Freepays relay-funktion, for at få den lille gule hængelås på betalingssiden (dvs siden hvor kunden indtaster sine kortoplysninger).

Bemærk dog, at alle session objekter tabes i det der relayes. Alt grafik, stylesheets og javascript-filer til betalingssiden skal ligge i enten samme mappe eller en undermappe på webserveren. Endvidere er det vigtigt at alle URL´s på disse filer er relative.

Ved relaying er det heller ikke muligt at få vist hængelåsen, hvis betalingssiden er i frames.

Opsætningen til Relaying finder du efter log ind under "Opsætning" for din butik, og adressen er: https://www.freepay.dk/ui/pages/external/relay.aspx/[dit forretningsnummer her]/

Betalingssiden

I det øjeblik der foretages et køb med betalingskort i butikken, skal der sendes information til os omkring købet, samt kundens betalingskort. Dette gøres ved at opsætte en HTML-formular hvori kunden indtaster oplysningerne om sit betalingskort.

Efterfølgende bliver disse videresendt til os via sikker protokol og enten valideret eller afvist. I nedenstående angives en "AcceptURL", samt en "DeclineURL": Disse angiver hvilken side kunden skal sendes tilbage til ved hhv. validering eller afvisning.

Formen skal indeholde nedenstående felter. Oftest vil alle felter undtagen "ExpireMonth", "ExpireYear" og "CardNumber" figurere som såkaldte "hidden fields" i htmlkoden.

MerchantNumber	Merchant-nummeret (forretningsnummeret) fremgår af butikkens indløsningsaftale modtaget fra PBS. Nummeret bruges af PBS til at identificere butikken.
Amount	Beløbet (typisk angivet i ører)
Currency	Valutaangivelse iflg. ISO4217. Danske kroner har værdien "208".
CardNumber	Kortnummeret på betalingskortet. Indtastes af kunden.
ExpireMonth og ExpireYear	Udløbsdato på kundens kort. Indtastes af kunden i formatet MM/ÅÅ.
CVC	Kontrolcifre som typisk står på bagsiden af kortet.
OrderNumber	Dette felt skal indeholde butikkens ordre nummer for købet. Når butikken logger ind i Freepays administrationsdel er dette ordre nummer synligt ud for status på selve kort valideringen. Afhængig af kundens bank vil det desuden fremgå på kundens kontoudtog.
AcceptURL	Dette felt skal indeholde URL-adressen på siden som skal vises, hvis kortet valideres. Se nedenfor for en liste over parametre som returneres (returværdier)
DeclineURL	Dette felt skal indeholde URL-adressen på siden som skal vises, hvis kortet afvises.

Bemærk! Du kan ikke anvende kommatal som beløb (Amount feltet). Angiv i stedet beløbet i ører (dvs. DKK 35,50 bliver til 3550), og fjern en evt. afkrydsning af "Jeg angiver beløbet i Kr." under butikkens opsætning i Freepay.

For at undgå at utålmodige kunder klikker adskillige gange på din "betal" knap, og derved får skabt flere transaktioner, anbefaler vi at du "disabler" knappen første gang der trykkes på den. Rent teknisk gøres dette ved at sætte "disabled = true" på knappen via javascript.

Se et eksempel på en HTML form hvori ovenstående benyttes.

Formens action skal stå til https://gw.freepay.dk/secure/authorize.aspx
Formens method skal stå til POST

Returværdier

Når en transaktion bliver godkendt, returneres følgende værdier til AcceptURL'en via QueryString'en:

transact Transaktionsnummeret, dvs. det ID som transaktionen har i Freepay systemet. OrderNumber Ordrenummeret på den ordre som transaktionen er foretaget i forbindelse med. Param Valgfri parameter som kan sendes via betalingsformularen.

Fejlkoder

Hvis transaktionen afvises returneres der en fejlkode i variablen "reason" (fx. "/decline.asp?reason=1"). Nedenfor ser du hvad de pågældende koder betyder.