Frontend har IP: 194.152.39.13
Backend har IP: 194.152.38.150
Den gule hængelås
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 via en betalingsside (dvs siden hvor kunden indtaster sine kortoplysninger), som er 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.
Betalingssiden SKAL vises via en sikker forbindelse. Hvis ikke din butik selv har et SSL-certifikat, har du to muligheder for at få den lille gule hængelås på betalingssiden.
Relaying
Ved relaying laver du selv en betalingsside på din egen server, som så indlæses og vises overfor kunden via Freepay.
Bemærk dog, at alle session objekter tabes i det der relayes, og at alle urls på stylesheets, billedfilet etc. skal være relative. Relaying virker desuden ikke, hvis din betalingsside er i frames.
Relaying fungerer ved, at du sender kunden over til Freepay, og i adressen specificerer url'en på din betalingsside.
Formatet:
https://gw.freepay.dk/proxy/get.ashx/[Url'en på din betalingsside, uden http foran, og efterfulgt af evt querystrings]
Eksempel:
https://gw.freepay.dk/proxy/get.ashx/www.minhjemmeside.dk/TilKassen/Betalingssiden.aspx?OrdreNummber=123
HTML-formularen
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.
ISO 4217. 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
Freepays egen betalingsside
Hvis du ikke ønsker at laver din egen betalingsside, kan du i stedet sende kunden direkte over på Freepays egen betalingsside.
Dette skal ske via POST, og kræver følgende felter:
|
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.
ISO 4217. Danske kroner har værdien "208".
|
|
OrderID
|
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.
|
|
Param
|
Valgfri parameter du kan sende med og få tilbage til Accept/DeclineUrl, hvis du har brug for det.
|
|
AuxParam
|
Samme som Param.
|
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.
Det anbefales, at du anvender vores webservice (se længere nede) til at validere, at betalingen er gået korrekt igennem, da shopkunden i kildekoden kan se AcceptUrl?en. Dermed er det muligt at kalde den manuelt og få godkendt sin ordre uden at betale.
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.
|
Fejlkode
|
Tekst
|
|
-1
|
Intern Freepay fejl
|
|
-2
|
Intern Freepay fejl
|
Resten af fejlkoderne er fra PBS og her kan du hente op til nummer 984:
Fjernadministration
Freepay tilbyder muligheden for styring af transaktioner uden der logges ind i Freepay via en webservice.
Du har følgende muligheder:
- Capture (Hævning af transaktion)
- ChangeCaptureAmount (Ændre beløbet)
- DeleteTransaction (Slette en transaktion)
- QueryTransaction (Hente alle oplysninger om en transaktion)
Adressen til webservicen er https://gw.freepay.dk/webservices/public/management.asmx og du kan læse mere om den, hvis du kalder linket i din browser.
|