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. 

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

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

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

(info) 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:

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

MerchantID

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

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

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung
cardsJSONM

List of cards to be checked, base64 encoded

Cards may be real PANs or PCNr, List of incoming cards may have up to 10.000 elements.

Incoming JSON like

[
    { "oldPan": "0123456789012907" },
    { "oldPan": "0123456789012000" }
]
e.g. cards=Ww0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyOTA3IiB9LA0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyMDAwIiB9DQpd


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

[
    { "oldPan": "0123456789012907" },
    { "oldPan": "0123456789012000" }
]
e.g. cards=Ww0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyOTA3IiB9LA0KICAgIHsgIm9sZFBhbiI6ICIwMTIzNDU2Nzg5MDEyMDAwIiB9DQpd



Antwortelemente (mdcupdater.aspx)

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

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

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

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyFormatCNDDescriptionBeschreibung

mid

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

 

KeyFormatCNDDescriptionBeschreibung
TransID

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyFormatCNDDescriptionBeschreibung

Status

a..20

M

Status of the transaction.

Values accepted:

  • OK

  • FAILED

Status der Transaktion.

Zulässige Werte:

  • OK
  • FAILED

KeyFormatCNDDescriptionBeschreibung
Description

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyFormatCNDDescriptionBeschreibung
Code

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

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

 

KeyFormatCNDDescriptionBeschreibung
cardsJSONM

List of cards, base64 encoded.

newPan will always be a PCNr.

If newPan != oldPan then create new PCNr.

Response JSON like:

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


Table of responseCodes:

responseCodesDescription

000

OK

Card has been found, new Card (newPan) has been returned. This card number is a PCNr due to ease PCI DSS compliance. 

201

Required element missing

Name of required element(s) that was omitted; if more than one element is detected, this is a comma delimited list.

203

Format Invalid (Data element not in the required format or value is invalid) For example, not numeric or wrong length.

301

There is no new card available for this PAN

302

Data encryption/decryption failure (due to technical or other reason)

303

An error occured during the insert / update / delete within the database

304

Already existing in database

800

Given PCNr is not found to be translated into PAN for MDC request

(info)  if a given PCNr in card-JSON-Request is not found:

  • Computop Paygate will send PCNr as oldPan with prefix "9999"
  • return newPan with prefix "9999"
  • and set responseCode to "800" 

Liste der Karten, Base64-codiert.

newPan wird immer eine PCNr sein.

Wen newPan != oldPan, dann neue PCNr erzeugen.

Antwort JSON like:

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


Tabelle der responseCodes:

responseCodesBeschreibung

000

OK

Karte 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

(info)  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"