Stablecoin Fiat Accounts — Naming, Country Labels & Endpoint Ordering
Renamed "ledger" / "Virtual IBAN" / "Virtual Account" → "stablecoin fiat account"
Customer-facing references in the Stablecoin guides and OpenAPI spec now use a single, consistent term: stablecoin fiat account. The previous mix of ledger, Virtual IBAN, Virtual Account, and VA has been removed from the docs.
Affected surfaces
| Before | After |
|---|---|
| "Bakkt bank account (Virtual IBAN)" (OpenAPI summary/description) | "stablecoin fiat account" |
| "Accounts API Virtual IBAN" (guides) | "stablecoin fiat account" |
| "Bakkt virtual account" (on-ramp guide) | "stablecoin fiat account" |
| "Bakkt-managed bank account (ledger)" (integration guide) | "stablecoin fiat account" |
| "Bakkt bank accounts (ledgers)" (webhooks guide) | "stablecoin fiat accounts" |
| "Ledger creation in progress / ready / failed / disabled" (webhook statuses) | "Stablecoin fiat account creation in progress / ready / failed / disabled" |
Example value "uuid": "ledger-uuid" | "uuid": "stablecoin-fiat-account-uuid" |
| "user's own VA" / "(own VA)" / "VA link" / "VA UUID" | "user's own stablecoin fiat account" / "(own stablecoin fiat account)" / "stablecoin fiat account link" / "stablecoin fiat account UUID" |
Not changed
INTERLEDGER_TRANSFER_FAILED,INTERLEDGER_TRANSFER_IN_PROGRESS,INTERLEDGER_TRANSFER_ISSUED, andINTERLEDGER_TRANSFER_COMPLETEDenum values are part of the wire-format API contract and are unchanged.- Endpoint paths, request/response field names, and webhook event names are unchanged. This is a terminology/documentation update only — no integration changes are required.
Country labels on account_details dropdowns
account_details dropdownsEach variant in the account_details.oneOf schemas (for both user and corporate POST /bank-account/remote endpoints) now carries a title with a country flag and currency code. ReadMe renders these as the dropdown labels, replacing the previous generic "Object 1, Object 2, …" entries.
| Variant | Label |
|---|---|
| EUR | 🇪🇺 Eurozone (EUR) |
| GBP | 🇬🇧 United Kingdom (GBP) |
| USD | 🇺🇸 United States (USD) |
| TRY | 🇹🇷 Türkiye (TRY) |
| NGN | 🇳🇬 Nigeria (NGN) |
| INR | 🇮🇳 India (INR) |
| PKR | 🇵🇰 Pakistan (PKR) |
| MXN | 🇲🇽 Mexico (MXN) |
| BRL | 🇧🇷 Brazil (BRL) |
| ARS | 🇦🇷 Argentina (ARS) |
| IDR | 🇮🇩 Indonesia (IDR) |
| KES | 🇰🇪 Kenya (KES) |
| PHP | 🇵🇭 Philippines (PHP) |
This applies to both the user remote bank account variants and the corporate remote bank account variants.
Management endpoints reordered (GET before PATCH)
The fee-override endpoints in the Management category are now listed in CRUD order in the API reference:
GET /stablecoin/user/fees→PATCH /stablecoin/user/feesGET /stablecoin/corporate/fees→PATCH /stablecoin/corporate/fees
This is a documentation ordering change only; the endpoints themselves are unchanged.