Card update notification

When a change is made to a card from the scheme network, a notification is transmitted. Changes in a token can be if the card is updated (issued a new card) or the card is deleted.

Endpoint and method

Method: POST

Endpoint: https://cardtokens-partner-domain.com/my-notification-endpoint

Encryption

Payload for the notification is encrypted using RSA public / private key encryption.

Retry

Cardtokens expects to receive a HTTP 200 status code when transmitting the notification. If the notification fails Cardtokens will retry the notification up to 24 times with 1 hour interval.

Payload parameters

Name	Type	Description
panid	String	A unique reference to the PAN stored in the watchlist.
status	String	A: Account number change message. C: Closed account advice. E: Expiration date change. N: Non-participating BIN. Q: Contact cardholder advice. O: Cardholder Opt-Out. P: Participating BIN, no match. V: Match made, account number and expiration date unchanged.
scheme	String	Can be one of “visa”, “mastercard”.
oldpan	String	The old PAN subscribed to the watchlist.
oldexpmonth	String	The old PAN expiry month, which was added to the watchlist.
oldexpyear	String	The old PAN expiry year, which was added to the watchlist.
newpan	String	If a new PAN was present.
newexpmonth	String	If a new expiry month was present. Formatted MM.
newexpyear	String	If a new expyear was present. Formatted YYYY.

Example encrypted payload

{
    "encdata":"TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2NpbmcgZWxpdCwgc2VkIGRvIGVpdXNtb2QgdGVtcG9yIGl
    uY2lkaWR1bnQgdXQgbGFib3JlIGV0IGRvbG9yZSBtYWduYSBhbGlxdWEuIFV0IGVuaW0gYWQgbWluaW0gdmVuaWFtLCBxdWlzIG5vc3RydWQgZXh
    lcmNpdGF0aW9uIHVsbGFtY28gbGFib3JpcyBuaXNpIHV0IGFsaXF1aXAgZXggZWEgY29tbW9kbyBjb25zZXF1YXQuIER1aXMgYXV0ZSBpcnVyZSBkb2x
    vciBpbiByZXByZWhlbmRlcml0IGluIHZvbHVwdGF0ZSB2ZWxpdCBlc3NlIGNpbGx1bSBkb2xvcmUgZXUgZnVnaWF0IG51bGxhIHBhcmlhdHVyLiBFeGN
    lcHRldXIgc2ludCBvY2NhZWNhdCBjdXBpZGF0YXQgbm9uIHByb2lkZW50LCBzdW50IGluIGN1bHBhIHF1aSBvZmZpY2lhIGRlc2VydW50IG1vbGxpdCB
    hbmltIGlkIGVzdCBsYWJvcnVtLg=="
}

Example decrypted payload

{
  "panid": "901c439afd404f5396e1f3fdf66b1d6f",
  "status": "E",
  "scheme": "visa",
  "oldpan": "4571233011221122",
  "oldexpmonth": "01",
  "oldexpyear": "2096",
  "newpan": "4571233011221121",
  "newexpmonth": "02",
  "newexpyear": "2097",
  "customreference": "abcd-efgh-1234-5678"
}