Einführung

UrlNotify / Server-Response

Normalerweise sendet Zahlungsdetails an UrlNotify für Formularzahlungen (Hosted Payment Page, Kreditkartenformular, Lastschriftformular, PayPal, ...).

Bei Server-2-Server-Anfragen werden die Zahlungsdetails in der Server-Antwort zurückgegeben.

Die zurückgegebenen Zahlungsdetails hängen von der verwendeten Zahlungsmethode ab.

Third-Party Notification Service (TPNS)

TPNS wird verwendet, um ein zentrales Managementsystem mit einer Reihe grundlegender Zahlungsdetails zu informieren. Dies funktioniert sowohl für Formularzahlungen als auch für Server-2-Server-Anfragen und für Analytics-Aktionen. Es wird auch für mehrere MIDs/Händlereinheiten verwendet.

TPNS-Endpunkte müssen innerhalb von eingerichtet werden. Kontaktieren Sie bitte .




Benachrichtigungs-Rückmeldung

Der -Server führt eine HTTPS-POST-Anfrage direkt an den Webserver des Partners aus (URL). Zur Integration dieser Benachrichtigung muss der Partner  die IP-Adresse und URL mitteilen, die zum Einstiegspunkt der Rückmeldung des Servers führt. Normalerweise ist das ein kleines Modul oder eine kleine Anwendung, die ständig auf eingehende HTTPS-Anfragen vom -Server wartet. Der -Server sendet Daten über eine HTTPS-POST-Anfrage an die konfigurierte Server-URL einschließlich aller relevanten Parameter in der HTTPS-POST-Anfrage.

Die Parameter werden im HTTP-Body als Blowfish-verschlüsselte Parameterzeichenfolge übertragen. Der Inhaltstyp ist application/x-www-form-urlencoded; charset=iso-8859-1.

Hinweis: Beachten Sie bitte, dass der Notify-Aufruf aus Sichereitsgründen nur über Port 443 (SSL) zulässig ist. Die URL-codierten Parameter werden als Schlüssel-Wert-Paare übertragen.


Falls sich einer dieser Parameter (IP oder URL) während der Zeit ändert, sollte der Partner den  informieren, um die zugehörigen Konfigurationsänderungen auszuführen.

Aus Sicherheitsgründen wird ein gemeinsamer Blowfish Secret Key (Passwort) zwischen  und dem Partner für diesen Benachrichtigungsprozess ausgetauscht, und der Parameter MAC sollte in der Rückmeldungs-Anfrage enthalten sein.

Die Berechnung des Wertes MAC erfolgt mittels SHA-256-Algorithmus und mit den folgenden Parameterwerten: PayID*XID*TransID*MerchantID*Status*Code.

Der Empfänger sollte den Algorithmus MAC SHA-256 verwenden, den fast alle Programmiersprachen unterstützen, um den Hash-Wert mit dem HMAC-Schlüssel und den Parameterwerten zu berechnen.


Das  sendet eine Benachrichtigungsanfrage über HTTP POST, um den Autorisierungsstatus und die Transaktionsdetails an die in der Händlerkonfiguration gespeicherte Server-URL zu übertragen.

Folgende Tabelle beschreibt die -Antwortparameter:

Antwortparameter für den Third-party Notification Service über Socket-Verbindungen


Die Anfrage wird in Echtzeit gesendet. Falls die angegebene URL nicht erreichbar ist, versucht das  die Benachrichtigung erneut gemäß dem nachfolgenden Zeitplan.

Wiederholung

Wartezeit

Zeit nach 1. Notify

0

sofort

0

1

00:01 h

00:01 h

2

00:08 h

00:09 h

3

00:27 h

00:36 h

4

01:04 h

01:40 h

5

02:05 h

03:45 h

6

03:36 h

07:21 h

7

05:43 h

13:04 h

8

08:32 h

21:36 h

Falls die maximale Anzahl Wiederholungen erreicht ist und der Partner Web Service noch immer nicht verfügbar ist, werden keine weiteren Wiederholungen mehr versucht.