Hey! These docs are for version 1.0, which is no longer officially supported. Click here for the latest version, 2.0!

Currencies

Manage Upodi for the international subscription model.

The Internet is global and so is the subscription business model. As you grow your subscription portfolio internationally, chosing how currencies are handled becomes important. Upodi is build on a native multi-currency engine, for handling subscriptions and charges. This article is aimed to give more details how to manage your subscriptions with multiple currencies.

How Upodi looks at currencies

Currencies are mapped to product plans. You can choose different currency strategies on each product plan or product plan family (read below), but the main driver of currencies is the product plan.

Every company tenant have a base currency. This currency is default enabled, and set once you setup your tenant. Enabling additional currencies is easy and once enabled, they become available across the whole company. Navigate to:

  1. Setup
  2. General
  3. Currencies enable the required currencies.

🚧

Security is required

Managing and changing currencies require the administrative privileges.

Hierachies of the currency selection process

Matching currencies is done by the Upodi billing engine. By looking at the desired currency preference of the customer.

If a match to the given product plan is found, the customer will be invoices in that desired currency. If no match is found, the base currency of the product will be used, as a default fall back option. The currency will be passed all the way through the payment gateway and even to underlying finance solutions like Dinero, E-conomic, XERO or QuickBooks.

  1. Product plan currency.
  2. Customer currency preference.

How invoices and transactions are handled

Every customer has a currency preference (default currency). All currency settings on the platform, is based on the currency preference of the customer.

The Upodi billing engine will try to match the product plan currency settings with the customer currency preference. If a match is made, the currency of the customer is used for the subscription at hand. If a match cannot be established, the default currency of the product plan overrules the final currency of the subscription. Subsequently invoices will be issues in the currency set of this match.

Customer Currency

Product Plan Default Currencies

Product Plan Currencies

Invoiced currency

EUR

EUR

EUR

EUR

DKK

EUR

EUR, DKK

DKK

USD

EUR

EUR, DKK

EUR

Questions?

We're always happy to help with code or other questions you might have! Search our documentation or contact helpdesk. You can also chat live with us using the Intercom icon.