api/create_customer.php

Denne funktion kan anvendes til at indsætte en kunde i forretningens DIBS Email Kundearkiv. Anvendelsen sker ved at sende en https POST request til funktionen. POST requesten skal indeholde tre POSTvariable:

<deal_id>
<checksum>
<xmlstring>

<deal_id> er forretningens DIBS Email aftalenummer. Dette oplyses ved oprettelse af en DIBS Email konto, og kan efterfølgende findes i DIBS Email administrations-delen under "Opsætning/Staminformation/Firmaoplysninger". Her forefindes også DIBS merchantnummer og md5-nøgle, som begge skal bruges ved beregning af en kontrolchecksum.

<checksum> er en md5-checksum, der skal sikre, at de indsendte oplysninger er korrekte, og at oplysningerne er af-/indsendt af forretningen selv. Checksummen beregnes som:

md5( <key>+"-"+<deal_id>+"-"+<merchant>+"-"+<customer_number>);

hvor md5 betegner en funktion der beregner en md5 hash af en tegnstreng.
<key> betegner en forretnings-specifik md5 nøgle.
<deal_id> betegner forretningens DIBS Email aftalenummer.
<merchant> betegner forretningens DIBS merchantnummer.
<customer_number> er identisk med kundenummer (customer_number i XML).
+ betegner concatenerings-operatoren i det aktuelle programmeringssprog.
"-" er en bindestreg (gåseøjne skal ikke med i beregningen).

<xmlstring> er en velformateret XML tegnstreng i form af en DIBS email XML kunde (se specifikation).

POST ser sådanne ud
https://secure.dibs-email.com/api/create_customer.php