Scheme Token update notification
To search in the page use Ctrl+F on your keyboard
Scheme Token update notification, contains up-to-date information regarding the Scheme Token and the associated card.
Response
Required
-
keyVersion
- presence
- Required
- Interface version
- 2.0
Version of the merchant’s secret key used to calculate the imprint of the message (key stored by the merchant to verify the imprint of the automatic and manual notifications).
Optional
-
cardCobadgedScheme
- presence
- Optional
- Interface version
- 3.0
Network name of the second brand associated with the card, if the card is cobadged.
List of values
ACCORD
- Accord scheme
AMEX
- American Express scheme
BCMC
- Bancontact scheme
CB
- Carte Bancaire scheme
MASTERCARD
- Mastercard scheme (Example of cards on the Mastercard scheme: Mastercard, Maestro)
SOFINCO
- Sofinco scheme
VISA
- Visa scheme (Example of cards on the Visa scheme: Visa, Vpay, Visa Electron)
-
cardExpiryDate
- presence
- Optional
- Interface version
- 3.0
Card expiry date. If the card does not have any expiry date, this field is empty.
-
cardScheme
- presence
- Optional
- Interface version
- 3.0
Network name associated with the card.
List of values
ACCORD
- Accord scheme
AMEX
- American Express scheme
BCMC
- Bancontact scheme
CB
- Carte Bancaire scheme
MASTERCARD
- Mastercard scheme (Example of cards on the Mastercard scheme: Mastercard, Maestro)
SOFINCO
- Sofinco scheme
VISA
- Visa scheme (Example of cards on the Visa scheme: Visa, Vpay, Visa Electron)
-
cardSuffix
- presence
- Optional
- Interface version
- 3.0
Last 4 digits of the card
-
merchantId
- presence
- Optional
- Interface version
- 3.0
Identifier of the shop, this value is provided to the merchant by Sogenactif during the shop registration.
-
merchantToken
- presence
- Optional
- Interface version
- 3.0
PAN token in the format requested by the merchant.
-
paymentAccountReference
- presence
- Optional
- Interface version
- 3.0
Reference of the bank account associated to the card used for the payment.
-
schemeTokenExpiryDate
- presence
- Optional
- Interface version
- 3.0
Scheme token expiry date
-
schemeTokenReference
- presence
- Optional
- Interface version
- 3.0
Scheme token reference
-
schemeTokenRequestorId
- presence
- Optional
- Interface version
- 3.0
Unique identifier of the merchant with the Token Service Provider (TSP).
-
schemeTokenStatus
- presence
- Optional
- Interface version
- 3.0
Current status of the scheme token
List of values
ACTIVE
- Scheme token is active
DELETED
- Scheme token is deleted
NOT_YET_ACTIVE
- Scheme token is not yet active
SUSPENDED
- Scheme token is suspended
-
schemeTokenSuffix
- presence
- Optional
- Interface version
- 3.0
Scheme Token suffix, corresponds to the last 4 digits of the Scheme Token number.
-
schemeTokenUpdateDateTime
- presence
- Optional
- Interface version
- 3.0
Date and time of the Scheme Token update.
-
sealAlgorithm
- presence
- Optional
- Interface version
- 3.0
Algorithm applied to calculate the seal encryption.
List of values
HMAC-SHA-256
- The encryption algorithm applied is HMAC-SHA-256
HMAC-SHA-512
- The encryption algorithm applied is HMAC-SHA-512
SHA-256
- The encryption algorithm applied is SHA-256
Response sample
Changelog
Interface version | Data | Attendance | Container |
---|---|---|---|
3.0 |
cardCobadgedScheme
|
Response | |
3.0 |
cardExpiryDate
|
Response | |
3.0 |
cardScheme
|
Response | |
3.0 |
cardSuffix
|
Response | |
3.0 |
merchantId
|
Response | |
3.0 |
merchantToken
|
Response | |
3.0 |
paymentAccountReference
|
Response | |
3.0 |
schemeTokenExpiryDate
|
Response | |
3.0 |
schemeTokenReference
|
Response | |
3.0 |
schemeTokenRequestorId
|
Response | |
3.0 |
schemeTokenStatus
|
Response | |
3.0 |
schemeTokenSuffix
|
Response | |
3.0 |
schemeTokenUpdateDateTime
|
Response | |
3.0 |
sealAlgorithm
|
Response | |
2.0 |
keyVersion
|
Response |