Scenario Cartes Bancaires Account Update


Cartes Bancaires Account Updater (short MDC) is a service provided by Cartes Bancaires (CB) which allows to request some credit card data. CB will check for updates and sends updated credit card data back in response. 

To ease usage of MDC and to make it PCI DSS compliant will translate Pseudo Card Numbers (PCNr) into credit card numbers before sending to MDC and will create new PCNr for updated cards before sending response back to you.

MDC / allow you to send multiple cards in request and will send a record back in response for each card you've sent. 

(info) Your Merchant confirguration needs to be enrolled to the Cartes Bancaires Account Updater (short MDC) by 

(info) Card updates can be only sent back if the merchant has already a Card-on-file with expired card - not all cards.

(info) You may send in real card numbers (pay attention to your PCI DSS certification) or Pseudo Card Numbers (PCNr) which are not PCI DSS relevant.

(info) Maximum number of cards in request / response is limited to 10.000 cards.



Request / Response mdcupdater.aspx

Request Elements


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



Response Elements (mdcupdater.aspx)

 

KeyFormatCNDDescriptionBeschreibung

Status

a..20

M

Status of the transaction.

Values accepted:

  • OK

  • FAILED

Status der Transaktion.

Zulässige Werte:

  • OK
  • FAILED

 

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:

  • 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  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"