Versions Compared

Old Version 4

changes.mady.by.user Admin

Saved on

compared with

New Version Current

changes.mady.by.user Peter Posse

Saved on

Key

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

Scenario Cartes Bancaires Account

Updater

Update


Note

(warning)(warning)(warning) DRAFT (warning)(warning)(warning)

Not fully implemented yet, planned March 2024.

No CB for PROD certificate yet.

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

To ease usage of MDC and to make it PCI DSS compliant

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Name
PageWithExcerptWording
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 /

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Name
PageWithExcerptWording
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 by 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameHelpdesk-Name
PageWithExcerptWording

(info)  Only cards should be sent which are going to expire within 3 (?) months 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 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.

Table of Contents



Request / Response Response mdcupdater.aspx

Request

Elements

elements

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table FilterdefaultBeschreibungisFirstTimeEnterfalsehideColumnstruesparkNameSparklinehidePanetruedatepatterndd M yyid1710229635942_-1338890249worklog365|5|8|y w d h m|y w d h misORANDseparatorPoint (.)

order0
Multiexcerpt
MultiExcerptNamerequest_elements
Fixed value = CB2A
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1710229635944_275435698
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

KeyFormatCNDDescription
Beschreibung
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

Incoming JSON like

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


Response 
 Elements 
elements (mdcupdater.aspx)
 Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API
 Table FilterdefaultBeschreibungisFirstTimeEnterfalsehideColumnstruesparkNameSparklinehidePanetruedatepatterndd M yyid1710229635946_-879505652worklog365|5|8|y w d h m|y w d h misORANDseparatorPoint (.)order
0
 Multiexcerpt
MultiExcerptNameresponse_elements
 Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1710229635948_1633184634
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*
 Table Excerpt Include
statictrue
nameMID
pagemid
typepage
  
 Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage
KeyFormatCNDDescription
Beschreibung
Status
a..20
M
Status of the transaction.
Values accepted:
  • OK
  • FAILED
Status der Transaktion.
Zulässige Werte:
  • OK
  • FAILED 
 Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage
 Table Excerpt Include
statictrue
nameCode
pageCode
typepage
 
KeyFormatCNDDescription
Beschreibung
cardsJSONM
List of cards, base64 encoded.
newPan will always be a PCNr.
If newPan != oldPan then create new PCNr.
response 
Response JSON like:
 Code Block
languagejson
[
  { "oldPan": "12345678907", "newPan": "12345678917", "newExpiryDate": "23/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
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:
  •  Multiexcerpt include
    SpaceWithExcerptEN
    MultiExcerptNamePlatform-Name
    PageWithExcerptWording
     will send PCNr as oldPan with prefix "9999"
  • return newPan with prefix "9999"
  • and set responseCode to "800"