Storefront Currencies

Storefront

Storefront Currencies groups 1 operation on the storefront tier.

Storefront tier. Reachable anonymously; a public vnstss_ token may be sent to identify the storefront.

GET

/api/{version}/currencies

AuthentifizierungAnonymStorefront tier. Reachable anonymously; a public vnstss_ token may be sent to identify the storefront.

Antworten

200StorefrontCurrenciesResponseOK

curl -X GET \
  'https://<your-shop-domain>/api/2026-04-01/currencies' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer vnstss_<token>'

Antwort200Beispielstruktur

{
  "currencies": {
    "active": "string",
    "default": "string",
    "available": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "code": "string",
        "name": "string",
        "default": true,
        "rounding": 1
      }
    ]
  }
}

Schemas

StorefrontCurrenciesDto

Storefront representation of the shop's currency set. active is the ISO code this request was priced in and always appears in available, so a switcher can render the options and mark the selected one from this read alone.

activestringnullable
defaultstringnullable
availableStorefrontCurrencyDto[]nullable

StorefrontCurrenciesResponse

Envelope returned by GET /currencies.

currenciesStorefrontCurrenciesDto

StorefrontCurrencyDto

A single published currency. There are two ways to select one and they are not interchangeable. ?currency=<code> on any storefront read prices that response; PUT /cart/currency with id re-prices the stored cart and sticks. Use code for the former and id for the latter.

idstring (uuid)
The id PUT /cart/currency takes. Stable per tenant.
codestringnullable
ISO 4217 code — what every money field in this API is quoted in, and what ?currency= takes.
namestringnullable
The tenant's own label for the currency, ready to render in a switcher.
defaultboolean
Whether this is the shop's default currency — the one prices fall back to.
roundingnumber (double)
Rounding step the shop applies to totals in this currency (e.g. 0.05). 0 when the tenant configured none. Round client-side figures with it to agree with the shop's own arithmetic.