Sie können URL-Benachrichtigungen (Webhooks) so konfigurieren, dass sie automatisch an Ihr System übermittelt werden, wenn auf Ihrer Website Transaktionen verarbeitet werden.
Konfigurieren von URL-Benachrichtigung
Wir unterstützen drei Arten von URL-Benachrichtigungen, die unabhängig voneinander aktiviert/deaktiviert werden können, indem Sie Ihre HTTPS POST mit den unten aufgeführten Beispielen aktualisieren:
<!--This enables the successful URL notification rule-->
<input type=hidden name="ruleidentifier" value="STR-8">
<!--Successful URL notification destination-->
<input type=hidden name="successfulurlnotification" value="http://yourwebsite.com/successful"><!--This enables the declined URL notification rule-->
<input type=hidden name="ruleidentifier" value="STR-9">
<!--Declined URL notification destination-->
<input type=hidden name="declinedurlnotification" value="http://yourwebsite.com/declined"><!--This enables the all URL notification rule-->
<input type=hidden name="ruleidentifier" value="STR-10">
<!--All URL notification destination-->
<input type=hidden name="allurlnotification" value="http://yourwebsite.com/all">Alle in Ihrem Beitrag enthaltenen Regelbezeichner (z. B. "STR-8") und die für die Benachrichtigung übermittelten URLs müssen in der Zeichenfolge enthalten sein, die zur Generierung des Sicherheits-Hashes für Ihre Anfrage verwendet wird. Andernfalls wird dem Kunden die Fehlermeldung "Ungültige Angaben" angezeigt.
Handhabung URL-Benachrichtigungen
Sie müssen Ihr System so konfigurieren, dass es die eingehenden URL-Benachrichtigungen auf Port 443 akzeptiert. Wenn der Sicherheits-Hash der Antwortseite korrekt ist, muss Ihr System innerhalb von 8 Sekunden nach Erhalt einer Benachrichtigung mit einer HTTP 200 OK-Antwort (z. B. "HTTP/1.0 200 OK") antworten.
Pro Anfrage wird eine Benachrichtigung verschickt, aber wenn Ihr System nicht antwortet, sendet Trust Payments bis zu 48 Stunden lang weitere Benachrichtigungen, bis eine Bestätigung eingeht.
Wenn wir innerhalb von 48 Stunden keine Bestätigung erhalten, senden wir eine E-Mail mit weiteren Details an die Standard-E-Mail-Adresse, die mit Ihrer Website-Referenz verknüpft ist (kontaktieren Sie unser Support-Team, um diese Adresse zu aktualisieren).
Zurückgegebene Felder
URL-Benachrichtigungen unter Verwendung von Systemregeln (STR-x) werden standardmäßig die folgenden Informationsfelder einbezogen:
- transactionreference
- requestreference
- orderreference
- sitereference
- errorcode
- settlestatus
- paymenttypedescription
Die Benachrichtigung enthält auch den Sicherheits-Hash der Antwortseite (auf den weiter unten näher eingegangen wird).
Wenn Sie zusätzliche Felder aufnehmen möchten, können Sie Ihre HTTPS POST aktualisieren, um stextraurlnotifyfields aufzunehmen. Im folgenden Beispiel werden zusätzlich zu den oben aufgeführten Standardfeldern der Rechnungsvorname, der Nachname und die E-Mail-Adresse in ein URL-Benachrichtigung aufgenommen:
<form method="POST" action="<DOMAIN>/process/payments/choice">
...
<input type="hidden" name="ruleidentifier" value="STR-10">
<input type="hidden" name="allurlnotification" value="http://www.yourwebsite.com/all">
<input type="hidden" name="stextraurlnotifyfields" value="billingfirstname">
<input type="hidden" name="stextraurlnotifyfields" value="billinglastname">
<input type="hidden" name="stextraurlnotifyfields" value="billingemail">
...
<input type="submit" value="Pay">
</form>Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Sie erhalten auch einen gehashten responsesitesecurity Wert in jedem an Ihr System gesendeten URL-Benachrichtigungen . Wir empfehlen Ihnen dringend, den zurückgegebenen responsesitesecurity Hash-Wert neu zu berechnen, um sicherzustellen, dass er nicht von einem Kunden oder einem Dritten geändert wurde und dass die Felder von Trust Payments gesendet wurden.
