August 1, 2024
Addition of Explicitly-defined Currencies
[8/5/2024] Update: The rollout of this change has been delayed 1 week and will now commence beginning August 12th (Monday).
Beginning on August 5th (Monday) and extending through August 9th (Friday), we will be updating several of our customer-facing data models to add additional information about the currencies for amounts found in cards, card accounts, card programs, and transaction events. This change is purely additive and will result in zero impact to the existing data fields in each of these schemas.
Card Accounts
A new field will be added (cardholder_currency) which denotes the cardholder billing currency for the card account.
Cards
A new field will be added (cardholder_currency) which denotes the cardholder billing currency for the card.
Card Program
Two new fields will be added:
cardholder_currencywhich denotes the cardholder billing currency.settlement_currencieswhich denote configured settlement currencies for a given card program.
ASA
A new field will be added (cardholder_currency) which denotes the cardholder billing currency for the authorization event.
Transaction Event
A new property will be added to each event called amounts, with the structure below:
"amounts": {
"merchant": {
"amount": 10000,
"currency": "USD",
},
"cardholder": {
"amount": 7500,
"currency": "CAD",
"conversion_rate": "0.750000"
},
"settlement": {
"amount": 0,
"currency": "USD",
"conversion_rate": "0.000000"
}
}
These new values represent transaction amount (merchant), cardholder billing amount (cardholder), and settlement amount (settlement) with currency codes and exchange rates where applicable.
The current amount value found in each transaction event (referring to the merchant amount) will continue to be populated with no scheduled discontinuation date at this time.