Der HMAC-Wert wird mit Hilfe des Kennworts und mehrerer Parameterwerte berechnet. Zur Berechnung werden die Parameter PayID, TransID, MerchantID, Amount and Currency verwendet und mit Sternchen getrennt:
PayID*TransID*MerchantID*Amount*Currency
| Key | Wert | Anmerkungen |
|---|
| PayID | Referenzierte PayID | Kann leer sein, z.B. zum Erstellen eines anfänglichen Zahlungsvorgangs oder einer Risikomanagement-Anfrage; wird bei nachfolgenden Anfragen wie Erfassung/Erstattung verwendet. |
| TransID | Ihre Transaktions-ID zur Referenzierung / Identifikation Ihrer Anfrage | Ihre eigene Referenz zur Identifikation jeder Anfrage / jedes Zahlungsvorgangs. |
| MerchantID | Ihre von | Multiexcerpt include |
|---|
| SpaceWithExcerpt | DE |
|---|
| MultiExcerptName | Partner-Name |
|---|
| PageWithExcerpt | Wording |
|---|
|
vergebene MerchantID | Ihre MerchantID zur Identifikation dieser Anfrage. |
| Amount | Betrag in der kleinsten Währungseinheit, z.B.123=1,23 | Betrag dieser Anfrage; kann leer sein, falls der Wert z.B. für Statusanfragen nicht verwendet wird. |
| Currency | Währung des Zahlungsvorgangs gemäß ISO 4217, z.B. EUR, USD, GBP | Währung dieser Anfrage; kann leer sein, falls der Wert z.B. für Statusanfragen nicht verwendet wird. |
| YourHmacPasswort | Ihr von | Multiexcerpt include |
|---|
| SpaceWithExcerpt | DE |
|---|
| MultiExcerptName | Partner-Name |
|---|
| PageWithExcerpt | Wording |
|---|
|
zugeteiltes MACHMAC-Kennwort | Ihr zu einer bestimmten MID zugeordnetes MACHMAC-Kennwort; falls Sie mehrere MIDs haben, haben Sie auch verschiedene MACHMAC-Kennwörter. |
Hinweis: Falls eine Transaktion nicht alle diese Parameter unterstützt, können Sie die fehlenden Werte einfach weglassen.
Beispielsweise liegt bei der ersten Transaktion noch keine PayID vor, sodass Sie diese nicht übertragen müssen. Die PayID ist Bestandteil der Hash-Berechnung bei nachfolgenden Transaktionen:
| Beispiele zur MAC-Berechnung | Formel | Ergebnis |
|---|
| ohne PayID, mit Betrag/Währung | sha256HmacSHA256("*TID-4453732122167114558*yourMerchantId*1234*EUR", "mySecret") | 38CED807E293FC634A6C36FFAEA7BD2687038D40615781918AEF2DE7BB9A9903 |
| ohne PayID, ohne TransID, mit Betrag/Währung | sha256HmacSHA256("**yourMerchantId*1234*EUR", "mySecret") | ECBCAB7361CFFE1694D2E893280AED0FEEC2FCF518A736009D38CBD65F0DC68B |
| mit PayID, ohne Betrag/Währung | sha256HmacSHA256("fe3f002e19814eea8aa733ec4fdacafe*TID-4453732122167114558*yourMerchantId**", "mySecret") | 5A3ED13E4BF3492166E8E9B5898F372735B6FDCBFFC41B2AB4574A9A6FC9B734 |
