Hvis du ønsker at forudfylde formularen, kan du benytte nedenstående parametre. Linket til betalingsformularen udvides med de parametre du ønsker at benytte. Alle parametre er valgfri, med undtagelse af merchant-parameteren.
INPUT NAME
(PARAMETER) |
TYPE
|
FORKLARING
|
 |
| Merchant (zzzzzzz) |
Numerisk |
Forretningsnummer som opgivet af PBS. Parameteren er obligatorisk. |
Currency
(yyy) |
Numerisk
(længde: 3) |
ISO4217-formatteret numerisk kode, som angiver valutatypen (møntfoden) for transaktionen. Skal normalt udfyldes med: 208 (Danske Kroner).
Du kan dog også undlade at udfylde dette felt og så gives kunden mulighed for selv at vælge valuta. |
Amount
(xxxx) |
Numerisk |
Beløbet, som kunden skal indbetale.
Hvis du parameteroverfører beløbet skal det angives i mindste møntenhed. Angiv f.eks. 10595 for kr. 105,95. Hvis du ikke parameteroverfører noget beløb, vil kunden selv kunne indtaste hvor meget der skal indbetales. |
| Ordernumber (qqqqq) |
Streng
(op til: 20) |
Reference eller ordrenummer. Skal være unik for hver transaktion. Må ikke indeholde mellemrum eller specialtegn (herunder æ,ø,å).
Dette referencenummer fremgår af kundens kontoudtog og vil ligeledes fremgå af forretningens kontoudtog. Bemærk, at det ofte kun er de sidste 6 karakterer længst til højre i ordrenummeret der vises på kontoudtoget. Begræns derfor ordrenumrenes længde. Hvis du ikke parameteroverfører denne værdi, kan kunden selv indtaste en reference. |
Autocapture
(w) |
Integer |
Parameteren w kan antage værdien 0, 1 eller 2.
0 angiver at der ikke udføres autocapture (default), mens 1 angiver at der udføres autocapture på denne betaling. 2 angiver at der skal vises en checkbox med mulighed for autocapture på betalingsformularen. |
Emailresponse
(mmmm) |
Streng |
Hvis udfyldt med en email adresse sendes en email når en betaling er modtaget og accepteret. |
Continueurl
(co) |
Streng |
Kan angives med en gyldig URL. Hvis denne parameter angives vil standardformularen give muligheden for at fortsætte til websitet til den url du har angivet efter en godkendt betalingstransaktion. |
Cancelurl
(ca) |
Streng |
Kan angives med en gyldig URL. Hvis denne parameter angives vil standardformularen vise en retur-til-websitet-knap, som leder tilbage til den angivne website url. |
Paymentmessage
(tttt) |
Streng |
Parameteren tttt kan antage værdien 0 eller en fritekst eller parameteren kan undlades.
Såfremt værdien angives til 0 vil der ingen besked fremkomme på betalingsformularen. Hvis du undlader at medsende parameteren vil der fremkomme et fritekst-felt, hvor kunden selv kan indtaste en besked. Hvis du udfylder værdien med en url-encoded tekst vil denne tekst blive vist i betalingsvinduet. |
Repeatpayment
(r) |
Boolean |
Parameteren w kan antage værdien 1.
1 angiver at brugeren efter en afsluttet betaling sendes retur til betalingsformularen, så der kan udføres endnu en betaling. |
Md5check
(cccc) |
Streng
(længde: 32) |
Obligatorisk, hvis du vælger at medsende parametre ud over merchant, autocapture, website og repeatpayment.
Parameteren cccc indeholder MD5-værdien efter behandling. cccc er en beregnet MD5 streng, som kan anvendes til validering af de modtagne parametres gyldighed.
cccc kan beregnes på følgende måde (og KUN for de parametre der overføres. Du skal således ikke beregne for parametre du ikke medsender).
Parametrene skal behandles i følgende rækkefølge: merchant + currency + amount + ordernumber + autocapture + emailresponse + FRIbetaling MAC nøgle. Værdierne konkatineres uden mellemrum og uden brug af “plus-tegn”.
Såfremt den medsendte MD5-værdi stemmer med det som FRIbetaling kan udregne på baggrund af de medsendte værdier, så er der sikkerhed for at informationerne er uændrede.
Hvis ikke informationerne stemmer overens vises en fejlbesked. I så fald kan vi foreslå, at du prøver med vores testsystem (og bruger testmerchantnummeret og test-MAC-nøglen).
Din FRIbetaling MAC nøgle finder du i oprettelsesbrevet sammen med dit brugernavn og password. Bemærk at MAC nøglen der skal anvendes til test er angivet i afsnittet herunder omkring ”Sådan kan du teste”. |
