Balances on the Marqeta platform are presented in one or more currencies, depending on your card program configuration.
- Your default currency defines the currency used for balances at the top-level of the
gpa
object (as presented in transaction messages, for example). - Your program currencies define all possible currencies available for your card program; each
gpa
object includes balances for each program currency within thebalances
object.
For example, if your card program's default currency is USD and the program currencies are USD and CAD, the gpa
object resembles the following:
{
"gpa" : {
"currency_code" : "USD",
"ledger_balance" : 10.00,
"available_balance" : 10.00,
"credit_balance" : 0.00,
"pending_credits" : 0.00,
"balances" : {
"USD" : {
"currency_code" : "USD",
"ledger_balance" : 10.00,
"available_balance" : 10.00,
"credit_balance" : 0.00,
"pending_credits" : 0.00
},
"CAD" : {
"currency_code" : "CAD",
"ledger_balance" : 0.00,
"available_balance" : 0.00,
"credit_balance" : 0.00,
"pending_credits" : 0.00
}
}
}
}
Note: All balances show all program currencies regardless of whether there are funds in the given currencies, and regardless of whether the associated card product supports those currencies.