CB2A - Cartes Bancaires Account Updater MDC

Szenario Cartes Bancaires Account-Update

Der Cartes Bancaires Account Updater (kurz MDC) ist ein von Cartes Bancaires (CB) bereitgestellter Dienst, mit dem einige Kreditkartendaten angefordert werden können. CB prüft auf Aktualisierungen und sendet als Antwort aktualisierte Kreditkartendaten zurück.

Um die Nutzung von MDC zu vereinfachen und es PCI-DSS-konform zu machen, übersetzt Computop Paygate Pseudokartennummern (PCNr) vor dem Senden an MDC in Kreditkartennummern und erzeugt neue PCNr für aktualisierte Karten, bevor die Antwort an Sie zurückgesendet wird.

MDC / Computop Paygate ermöglicht das Senden mehrere Karten in der Anfrage und sendet als Antwort für jede von Ihnen gesendete Karte einen Datensatz zurück.

Ihre Händlerkonfiguration muss beim Cartes Bancaires Account Updater (kurz MDC) durch Computop Helpdesk registriert werden.

Kartenaktualisierungen können nur dann zurückgesendet werden, wenn der Händler bereits eine abgelaufene Karte hinterlegt hat – nicht alle Karten.

Sie können echte Kartennummern (achten Sie auf Ihre PCI-DSS-Zertifizierung) senden oder Pseudokartennummern (PCNr), die für PCI DSS nicht relevant sind.

Die maximale Anzahl der Karten in einer Anfrage / Antwort ist auf 10.000 Karten begrenzt.

Anfrage / Antwort mdcupdater.aspx

Anfrageelemente

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:

Key Format CND Description

Key	Format	CND	Description
MerchantID	ans..30	M	HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransID	ans..64	M	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
cards	JSON	M	Liste der zu prüfenden Karten, Base64-codiert Karten können echte PANs oder PCNr sein. Die Liste der eingehenden Karten kann bis zu 10.000 Elemente enthalten. Eingehendes JSON wie `1 [{ oldPan: '0123456789012907' }, { oldPan: '0123456789012000' }]; 2 e.g.cards = 3 Ww0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyOTA3IiB9LA0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyMDAwIiB9DQpd;`

MerchantID

ans..30

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

TransID

ans..64

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

cards

JSON

Liste der zu prüfenden Karten, Base64-codiert

Karten können echte PANs oder PCNr sein. Die Liste der eingehenden Karten kann bis zu 10.000 Elemente enthalten.

Eingehendes JSON wie

1
[{ oldPan: '0123456789012907' }, { oldPan: '0123456789012000' }];
2
e.g.cards =
3
  Ww0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyOTA3IiB9LA0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyMDAwIiB9DQpd;

Antwortelemente (mdcupdater.aspx)

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

es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Key Format CND Description

mid

ans..30

HändlerID, die von Computop vergeben wird

TransID

ans..64

Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Status

a..20

Status der Transaktion.

Zulässige Werte:

OK
FAILED

Description

ans..1024

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

Code

an8

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

cards

JSON

Liste der Karten, Base64-codiert.

newPan wird immer eine PCNr sein.

Wen newPan != oldPan, dann neue PCNr erzeugen.

Antwort JSON like:

1
[
2
  { "oldPan": "12345678907", "newPan": "12345678917", "newExpiryDate": "10/23", "responseCode": "000" },
3
  { "oldPan": "2017671234560000", "newPan": "", "newExpiryDate":"", "responseCode": "301" }
4
]
5
e.g. cards=
6
Ww0KICB7ICJvbGRQYW4iOiAiMTIzNDU2Nzg5MDciLCAibmV3UGFuIjogIjEyMzQ1Njc4OTE3IiwgIm5ld0V4cGlyeURhdGUiOiAiMTAvMjMiLCAicmVzcG9uc2VDb2RlIjogIjAwMCIgfSwNCiAgeyAib2xkUGFuIjogIjIwMTc2NzEyMzQ1NjAwMDAiLCAibmV3UGFuIjogIiIsICJuZXdFeHBpcnlEYXRlIjoiIiwgInJlc3BvbnNlQ29kZSI6ICIzMDEiIH0NCl0=

Tabelle der responseCodes:

responseCodes

Beschreibung

000

OKKarte wurde gefunden, neue Karte (newPan) wurde zurückgegeben.Diese Kartennummer ist aus Gründen der PCI-DSS-Konformität eine PCNr.

201

Erforderliches Element fehlt. Name der erforderlichen Elemente, die weggelassen wurden;Wenn mehr als ein Element erkannt wird, ist das eine durch Kommas getrennte Liste.

203

Format ungültig (Datenelement hat nicht das erforderliche Format oder der Wert ist ungültig) Beispielsweise nicht numerisch oder falsche Länge.

301

Für diese PAN ist keine neue Karte verfügbar

302

Fehler bei der Datenverschlüsselung/-entschlüsselung (aus technischen oder anderen Gründen)

303

Beim Einfügen/Aktualisieren/Löschen innerhalb der Datenbank ist ein Fehler aufgetreten

304

Bereits in der Datenbank vorhanden

800

Die angegebene PCNr wurde nicht gefunden, um in eine PAN für die MDC-Anfrage übersetzt zu werden

wenn eine angegebene PCNr in der Karten-JSON-Anfrage nicht gefunden wird:

sendet das Computop Paygate die PCNr als oldPan mit dem Präfix "9999" zurück
gibt eine newPan mit dem Präfix "9999"zurück
und setzt den responseCode auf "800"