Skip to main content
Change the Account Currency
A dashboard endpoint: it uses the signed-in dashboard session, not an API key, and requires the Owner or Admin role. The currency can change at any time; a balance in the previous currency stays payable in it and can be converted. See settlement and your Account Currency.

Authorizations

qint_session
string
cookie
required

The signed-in session of the Qint dashboard (dashboard.qint.ch). Only the Dashboard endpoints use it; API keys are not accepted there.

Headers

X-Merchant-Id
string<uuid>

The merchant account to act on, for users with access to more than one. Not needed when the user belongs to a single merchant account.

Body

application/json
currency
enum<string>
required

The fiat currency new payments are credited in (CHF unless the merchant chooses otherwise). It can change at any time; a balance in a previous Account Currency stays in that currency. Every payment is credited in the Account Currency of its quote, at the rate fixed when the buyer was quoted.

Available options:
CHF,
EUR,
USD,
GBP

Response

The Account Currency after the change.

currency
enum<string>
required

The fiat currency new payments are credited in (CHF unless the merchant chooses otherwise). It can change at any time; a balance in a previous Account Currency stays in that currency. Every payment is credited in the Account Currency of its quote, at the rate fixed when the buyer was quoted.

Available options:
CHF,
EUR,
USD,
GBP
changeable
boolean
required

Always true; the Account Currency can be changed at any time. Kept for compatibility.

currencies
enum<string>[]
required

The codes that can be chosen now.

The fiat currency new payments are credited in (CHF unless the merchant chooses otherwise). It can change at any time; a balance in a previous Account Currency stays in that currency. Every payment is credited in the Account Currency of its quote, at the rate fixed when the buyer was quoted.

Available options:
CHF,
EUR,
USD,
GBP
setBy
enum<string> | null

Who chose it; null while it is the CHF default.

Available options:
merchant,
staff,
null
setAt
string<date-time> | null
changeBlocker
string | null

Always null. Kept for compatibility.