====== Grundlagen ======

===== Schnittstelle =====

Die Schnittstelle basiert auf einem HTTPS POST Request. Alle Daten werden per POST an die jeweils angegebene URL gesendet und als Ergebnis wird ein JSON Objekt zurückgegeben.
Die Daten der Anfrage sind per hash-Checksumme gegen Manipulation abgesichert.

===== Beispieldaten =====
Für alle Beispiele in der Dokumentation werden die folgen Daten verwendet:

**merchantId:** 123456\\
**projectId:** 123\\
**password:** secure

===== hash Berechnung =====
Alle **Werte** der Parameter der entsprechenden API Funktion werden in der Reihenfolge der Beschreibung aneinandergehängt. Über diese Zeichenkette wird ein HMAC MD5 hash mit dem übermittelten Passwort gebildet.

PHP Beispiel:
<code php>
// String aller Werte der Parameter
$string = '250000info@mustermann.dedeMustermann GmbHMusterstraße 1212345MusterhausenDE8650MaxMustermannmax@mustermann.de50003201,11,7';

// hash mit Beispiel-Passwort generieren
$hash = hash_hmac('MD5', $string, 'password');
</code>