Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation

Table of Contents


Über S2S Blacklist Editing im
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

Allgemeines zu Server-zu-Server Blacklist Editing

Geltungsbereich: Bisher kann eine Blacklist nur per 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBackoffice-Kurz
PageWithExcerptWording
oder über Merchant Services bearbeitet werden, wobei dieser Prozess leider langsam und zeitaufwändig ist. Händler, die eine große Anzahl von Transaktionen bearbeiten müssen oder sofortige Kontrolle inklusive einer Bestätigung der Aktualisierung benötigen, fragten diese neue Funktion im 
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
an.
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording
bietet nun die Möglichkeit, eine Blacklist über eine Server-zu-Server-Verbindung zu bearbeiten.

Integration: Ein Händler sendet eine Anfrage an blacklist.aspx mit den üblichen Parametern wie MerchantID, Data und Length. In den verschlüsselten Daten muss ein Parameter EventToken für Insert, Update oder Delete sowie ein Parameter BlackListInfo mit allen Informationen über das Blacklist-Element enthalten sein. Der Wert von BlackListInfo ist ein JSON-String. Das

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
prüft zuerst, ob der Händler für eine solche Anfrage berechtigt ist. Je nach Ergebnis erzeugt es ein Objekt BlackListInfo und kann die Aktion Einfügen, Aktualisieren oder Löschen in der Blacklist-Datenbank ausführen. Der nächste Schritt ist die Antwort vom
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
an den Händler. Es gibt den Parameter Status, der die Werte OK oder FAILED haben kann. Im Falle von OK gibt es auch einen Parameter BlackListInfo, der alle Blacklist-Informationen als JSON-String liefert. Im Falle von FAILED gibt es einen Parameter Description, der einen Grund für das Scheitern der Anfrage angibt.

Um eine Karte gleichzeitig auf mehreren MerchantIDs zu sperren, dafür aber nicht pro MerchantID einen Request senden zu müssen, gibt es die Möglichkeit, eine Master-MerchantID und diverse Sub-MerchantDs zu definieren. Es reicht dann, wenn Sie einen Request auf die Master-MerchantID mit den notwendigen Daten senden. Die Sperre greift dann auch gleichzeitig auf allen Sub-MerchantIDs.

Falls Sie sich für diese spezielle Funktion interessieren, setzen Sie sich bitte mit unserem Merchant Support in Verbindung, damit die notwendige Konfiguration besprochen und vorgenommen werden kann.


Diagramm zum Prozessablauf

Prozessablauf S2S Blacklist Editing


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
-Schnittstelle

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


Aufruf der Schnittstelle zum Bearbeiten einer Blacklist

Um einen Blacklist-Eintrag über eine Server-zu-Server-Verbindung anzulegen, zu lesen, zu aktualisieren oder zu löschen, rufen Sie folgende URL auf:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording
blacklist.aspx


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628107890467_983959659
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklist_request
PageWithExcerptEN:Server-to-Server Blacklist Editing

Parameter für Bearbeiten einer Blacklist


Hinweis: Das Objekt BlackListInfo wird auch in der Antwort für das EventToken Insert beim Status "Failed" mit der Fehlerbeschreibung = "Eintrag existiert bereits" zurückgegeben. Auf diese Weise erhält der Anfrager stets die eindeutige BlockID zurück, wenn er versucht, einen doppelten Eintrag hinzuzufügen.

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628108189588_1758256263
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklist_response
PageWithExcerptEN:Server-to-Server Blacklist Editing

Antwort-Parameter für Bearbeiten einer Blacklist


BlackListInfo

Folgende Tabelle beschreibt das Objekt BlackListInfo für EventToken Insert:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628108431815_612621472
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklistinfo_insert
PageWithExcerptEN:Server-to-Server Blacklist Editing

Parameter für Bearbeiten einer Blacklist, EventToken Insert


Folgende Tabelle beschreibt das Objekt BlackListInfo für EventToken Update:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628108458681_-21248043
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklistinfo_update
PageWithExcerptEN:Server-to-Server Blacklist Editing

Parameter für Bearbeiten einer Blacklist, EventToken Update


Folgende Tabelle beschreibt das Objekt BlackListInfo für EventToken Delete:

Table Filter
ddSeparatorstrue
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id16281084870931628155640797_1980346287-347292819
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklistinfo_delete
PageWithExcerptEN:Server-to-Server Blacklist Editing

Parameter für Bearbeiten einer Blacklist, EventToken Delete


Folgende Tabelle beschreibt das Objekt BlackListInfo, das das 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
als Antwort zurückgibt:

Table Filter
inversefalse
defaultDescription
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1628108512369_1888684663
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameblacklistinfo_response
PageWithExcerptEN:Server-to-Server Blacklist Editing

Antwort-Parameter für Bearbeiten einer Blacklist