Skip to main content
Multi-currency in Alguna means each customer is billed in one currency of their own — their subscriptions, invoices, credits, wallets, and portal are all denominated in it — while you price per currency and keep FX rates for reporting across entities. Use this page to set a customer’s currency, decide how prices are expressed in each market, and understand where conversion does and does not happen. In short: customers are charged the price you set in their currency; FX rates only affect how you report. For where currency sits on each object, see How Alguna Works. The supported currency list is in Currencies.

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

In the dashboard: Customers → [Customer], edit the profile, set Currency, save. See Create a customer.

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.
Use explicit prices for headline plans, where the price point matters, and a converted price book for a long tail of products where it does not. See Pricing models.

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.
Example: a €1,000 annual invoice reported in USD at a 1.10 rate shows 1,100billedand1,100 billed and 91.67 recognised per month.

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

  1. Confirm EUR and GBP are enabled for your organization (Currencies).
  2. Add EUR and GBP prices to the products you sell there.
  3. Add FX rates for the legal entity that bills them.
  4. 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.