Page tree

Search

Skip to end of metadata
Go to start of metadata


Über S2S Blacklist Editing im Paygate

Allgemeines zu Server-zu-Server Blacklist Editing

Geltungsbereich: Bisher kann eine Blacklist nur per Analytics 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 Paygate an. Computop 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 Paygate 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 Paygate 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.


Diagramm zum Prozessablauf

Prozessablauf S2S Blacklist Editing


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen:

AbkürzungBeschreibung

CND

Bedingung (condition)

M

Pflicht (mandatory)

O

optional

C

bedingt (conditional)


Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.


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:


Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

EventToken

enum

M

Abkürzung der auszuführenden Aktion: <Create>, <Read>, <Update> oder <Delete>

BlackListInfo

ans..1024

M

Informationen über den Blacklist-Eintrag als JSON-String im Base64-Format. Siehe nachfolgende Tabellen BlackListInfo.

Parameter für Bearbeiten einer Blacklist


Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Beschreibung

MID

ans..30

M

HändlerID, die von Computop vergeben wird

Status

a..30

M

OK oder FAILED

Description

ans..1024

C

Nähere Beschreibung, wenn Status=FAILED

BlackListInfo

ans..1024

C

Informationen über den Blacklist-Eintrag als JSON-String im Base64-Format, wenn Status=OK. Siehe nachfolgende Tabellen BlackListInfo.

Antwort-Parameter für Bearbeiten einer Blacklist


BlackListInfo

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

Parameter

Format

CND

Description

Category

enum

M

Kategorie <EDD> für Lastschrift oder <CC> für Kreditkarte

Number

ans..64

M

IBAN, wenn Category=EDD

Kreditkartennummer, wenn Category=CC

BIC

ans..32

C

BIC, wenn Category=EDD

Parameter für Bearbeiten einer Blacklist, EventToken Insert


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

Parameter

Format

CND

Description

nBlockID

an..32

M

Eindeutige BlockID

LockActive

bool

M

Definiert, ob der Eintrag gesperrt werden soll oder nicht.

Gesperrt: <True>

Entsperrt: <False>

Parameter für Bearbeiten einer Blacklist, EventToken Update


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

Parameter

Format

CND

Description

BlockID

an..32

M

Eindeutige BlockID

Parameter für Bearbeiten einer Blacklist, EventToken Delete


Folgende Tabelle beschreibt das Objekt BlackListInfo, das das Paygate als Antwort zurückgibt:

Parameter

Format

CND

Description

BlockID

an..32

M

Eindeutige BlockID

MID

ans..30

M

HändlerID, die von Computop vergeben wird

Category

enum

M

Kategorie <EDD> für Lastschrift oder <CC> für Kreditkarte

Number

ans..64

M

IBAN, wenn Category=EDD

Kreditkartennummer, wenn Category=CC

BIC

ans..32

C

BIC, wenn Category=EDD

LockActive

bool

M

Definiert, ob der Eintrag gesperrt werden soll oder nicht.

Gesperrt: <True>

Entsperrt: <False>

Created

dttm

M

Zeit des Anlegens (YYYY-MM-DD hh:mm:ss)

Changed

dttm

M

Zeit des Änderns (YYYY-MM-DD hh:mm:ss)

Antwort-Parameter für Bearbeiten einer Blacklist