Skip to content

Understanding how product offerings are selected

There are two ways an app can discover which product offerings that it's user can purchase.

  • explicit listing available offerings
  • by checking if it's user is entitled to play a certain asset, and if not it will get a list of product offerings that will give access

In both cases the returned product offerings are only the product offerings available in the country the user currently is in.

Determining the current country

The app detects its country location by calling a location endpoint in the backend, which translates the app's IP-address to a country. This country is then used by the backend when the app discovers available product offerings.

Filtering product offerings based on country code

The backend filters product offerings based on provided country.

A product offerings has the following fields to define where to be available

  • Allowed regions
  • Allowed countries
  • Disallowed regions
  • Disallowed countries

If all of these fields are empty the product offering is available in any country.

If disallowed countries or regions matches, then the product offering is not available in any matching country. Disallow has precedence over allow.

Else the product offering is available if allowed countries and allowed regions are empty or if the country matches any of them.

Regions can be defined here: Portal -> Settings -> Service Settings -> Regions and Countries.

Example

A product offering defined as below will be available in Norway (NO), Denmark (DK) and Finland (FI), but not in Sweden (SE).

Allowed regions: nordics (Assume defined as SE, NO, DK, FI)
Allowed countries: (empty)
Disallowed regions: (empty)
Disallowed countries: SE

Filtering based on payment provider

If the app is an Android Whitelabel app it will only see product offerings available for Google Play in-app purchases in the current country

If the app is an Apple Whitelabel app it will only see product offerings available for App Store in-app purchases in the current country.

The web app will not see product offerings only available for in-app purchases.

See Product Offerings and In-App purchases

Tax Rates selection

If the Product Offering has got its own VAT% defined while creation, then it will always get priority and will be selected.

Whatever country will be selected for Product Offering (as described above), then tax-rate specifically defined for that country will be selected. Otherwise, global tax-rate will be selected.

In order for a Product Offering to be selectable all countries the Product Offerings is sellable in must have a country specific or global Tax-Rate defined,

For more details, See Create Tax Rates