Linkbygger

Ønsker man at benytte DIBS email som elektronisk fluesmækker på en hjemmeside, skal man indsætte et eller flere links, der hvor man ønsker muligheden for betaling. Dette gøres på følgende måde:

https://secure.dibs-email.com/api/linkpay.php?deal_id=

Til sidst i linket tilføjes forretningens DIBS email aftalenummer.

Dette link vil bringe kunden til en formular, hvor indbetalingsoplysningerne skal indtastes. Når kunden klikker sig videre fra formularen, vil fakturaen dannes og udsendes per e-mail. Ydermere vil kunden blive ledt videre i betalingsflowet, hvor betalingen kan gennemføres på normal vis.

Hvilke informationer kunden skal indtaste afhænger af hvilken indholdsskabelon, der er valgt som default for den elektroniske fluesmækker. Dette kan indstilles i DIBS emails Administrationsmodul under "Aftale" og "Præferencer".

Det er endvidere muligt at indbygge udvalgte fakturaoplysninger direkte i linket, herunder:

customer_number=
order_number=
invoice_number=
currency= (fx DKK = 208)
amount_incl_vat=
invoice_text= (Note: URL-encoded!)

Et link med flere oplysninger kan se således ud:

https://secure.dibs-email.com/api/linkpay.php?deal_id=0&invoice_number=123&amount_incl_vat=35

Felterne fakturanr (invoice_number), kundenr (customer_number), og ordrenummer (order_number) er altid obligatoriske. Hvis ikke disse oplysninger medsendes i linket, vil DIBS email automatisk danne numrene. Fakturanummer vil være det næste fortløbende nummer. Ordrenummer vil, alt afhænig af det i øvrigt anvendte format, blive det næste fortløbende nummer eller et derivat heraf. Kundenummer vil dannes som en sammensætning af UNIX-timestamp og et tilfældigt tal.

Tilføjelser til linket
"&amount_lock=no": Ønskes det at gøre f.eks. amount feltet redigerbart, kan man i linket tilføje dette. Som standard er feltet ikke redigerbart.

"&order_blank=yes": Hvis order_number ønskes blankt.

Et link med disse oplysninger vil så se sådanne ud:

https://secure.dibs-email.com/api/linkpay.php?deal_id=0&order_blank=yes&amount_lock=no

Kontrol af link
For at undgå snyderi i form af, at f.eks. en teknisk kyndig kunde ændrer i beløbet eller valutaen i linket, kan man medsende et unikt matematisk fingeraftryk af linket, en såkaldt MD5-checksum. Ændres der i linket, vil fingeraftrykket ikke længere passe, og købet vil blive afbrudt.

En forudsætning for denne kontrol er, at amount_lock sættes til "yes" i linket. Ligeledes skal man i DIBS emails Administrationsmodul under "Aftale" og "Præferencer" slå 'Beløbskontrol' til. Kontrollen udføres ved at medsende parameteren amount_control, som indeholder værdien af MD5-checksummen. Selve checksummen beregnes som:

md5(key-deal_id-amount-currency)

hvor "key" er forretningens nøgle, "deal_id" er forretningens DIBS email Aftalenummer, "amount" er købsbeløbet med 2 decimaler og punktum, og "currency" er samme værdi som i linket. Bindestreger skal medtages i beregningen. For eksempel "xyzxyzxyzxyzxyz-12345678-135.00-208". Selve udførslen af MD5-beregningen afhænger af hvilken platform hjemmesiden kører på.

Følgende forkortede link viser, hvorledes et link med MD5-kontrol kan se ud:

https://secure.dibs-email...&amount_lock=yes&amount_control=0dd7f8ed10835a64ebae47a5b9514c5b

Det er stadig muligt at medsende amount_lock uden at medsende en checksum. Der vil da ikke ske nogen beløbskontrol, men beløbsfeltet vil være låst.