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 |
