Skip to content
Vinosoft2026-04-01
en/de
API reference navigation

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

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

Responses

curl -X GET \
  'https://<your-shop-domain>/api/2026-04-01/currencies' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer vnstss_<token>'
Response200example shape
{
  "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.

StorefrontCurrenciesResponse

Envelope returned by GET /currencies.

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.