Table of Contents |
---|
Einführung
UrlNotify / Server-Response
Normalerweise sendet
Zahlungsdetails an UrlNotify für Formularzahlungen (Hosted Payment Page, Kreditkartenformular, Lastschriftformular, PayPal, ...). Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
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 Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
. Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName Sales-Name PageWithExcerpt EN:Wording
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Benachrichtigungs-Rückmeldung
Der Computop
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
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 Computop-Support den
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Aus Sicherheitsgründen wird ein gemeinsamer Blowfish Secret Key (Passwort) zwischen Computop zwischen
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
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
Das Computop Paygate sendet eine Benachrichtigungsanfrage über HTTP POST, um den Autorisierungsstatus und die Transaktionsdetails an die in der Händlerkonfiguration gespeicherte Server-URL zu übertragen. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording
Folgende Tabelle beschreibt die Paygate
Antwortparameter: Multiexcerpt- Include Page
SpaceWithExcerpt
DE
MultiExcerptName
Platform-Kurz
MID
ans..30
M
HändlerID, die von Computop vergeben wird
PayID
an32
M
Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien
XID
an32
M
Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransID
ans..64
M
Transaktionsnummer des Händlers
Bitte beachten Sie bei einigen Anbindungen die abweichenden Formate, die bei den spezifischen Parametern angegeben sind.
Status
a..50
M
Status der ausgeführten Aktion: OK oder FAILED
Description
ans..1024
M
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Code
n8
M
Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)
RefNr
ns..30
O
Eindeutige Referenznummer des Händlers
Bezeichnung der Kreditkartenmarke (z.B. Visa, MasterCard, Maestro etc.)
Bitte beachten Sie die Schreibweise gemäß Tabelle der Kreditkartenmarken!
Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Name der ausgeführten Aktion, welche die Benachrichtigun ausgelöst hat.
Erwartete Werte wie:
- Authorization
- Reverse
- Capture
- Credit
- Incremental
Name der verwendeten Zahlungsart.
Erwartete Werte wie:
- GICC
- Omnipay
- PayPal
- etc.
Hinweis: Für eine vollständige Liste der unterstützten Zahlungsmethoden wenden Sie sich bitte an den Computop Händlerservice.
Eingabemethode/Kanal, die für den ursprünglichen TxType verwendet wurde, der diese Benachrichtigung ausgelöst hat.
Werte wie: Client, Server, Analytics, Payshow
-Antwortparameter:PageWithExcerpt Wording
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
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 Paygate das
die Benachrichtigung erneut gemäß dem nachfolgenden Zeitplan. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording
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.