How it works
1
Set the customer's currency
Every customer carries a
currency. It is required on POST /customers and determines the currency of their subscriptions and invoices.2
Price in that currency
Give each product a price in every currency you sell in, or let a price book derive prices from your base currency at a rate you set.
3
Maintain FX rates for reporting
Rates you enter under Settings → FX Rates drive the conversion used in revenue schedules and organization-level insights, so figures are comparable across entities.
A subscription’s currency is fixed once it is created. To move a customer to a different currency, end the existing subscription and start a new one.
Where currency appears
Setting a customer’s currency
Pricing per currency
Explicit prices
Set the price you want to charge in each market rather than deriving it from a rate. Each price on a product carries its own currency, and a plan can hold one set of items per currency.Price books with a conversion rate
A price book can carry a currency with an exchange rate, deriving prices from your base currency instead of listing each one. It keeps a large catalogue in step, at the cost of prices that land on awkward numbers.FX rates
FX rates are maintained per legal entity under Settings → FX Rates, each with a source currency, a target currency, a rate, and a validity period. They are used to convert amounts for revenue recognition and organization-level reporting, so historical periods keep the rate that was in force at the time rather than being restated at today’s rate.FX rates never change what a customer is charged. The customer pays the price set in their own currency; what your payment provider does afterwards — including conversion into your bank account’s currency — is the provider’s, not Alguna’s.
Invoicing and payment
An invoice is issued entirely in the customer’s currency, including tax:
Payment is collected in that currency. A wallet can pay the invoice only if it holds the same currency; a customer invoiced in two currencies needs two wallets. Monetary credit grants likewise apply only to invoices in the subscription’s currency.
Customer portal
The customer portal shows invoices, subscription pricing, credit balance, and payment history in the customer’s currency.Common scenarios
Expanding into Europe
- Confirm EUR and GBP are enabled for your organization (Currencies).
- Add EUR and GBP prices to the products you sell there.
- Add FX rates for the legal entity that bills them.
- Configure EU tax treatment — reverse charge for B2B, VAT for consumers. See Tax.
Regional pricing
Price for local purchasing power rather than converting a single list price:Best practices
Set explicit prices
A price you chose beats a price a rate produced, especially at headline price points.
Keep FX rates current
Rates drive reported revenue. A stale rate distorts every comparison built on it.
Decide the currency up front
A subscription’s currency cannot be changed after it is created.
One wallet per currency
Wallets and credits never convert.
Next steps
Currencies
The supported currency list.
Revenue Recognition
How FX rates feed recognised revenue.