Skip to main content

Country Store

The Country Store is a centralized service within the Banqup ecosystem designed to manage and distribute country-specific configuration data, including country codes (ISO), tax rate categories, and current applicable rates. It is a foundational component for tax calculation and compliance features used across Banqup applications such as invoicing, reporting, and product management.

Core capabilities​

Manage country ISO information

The Country Store maintains a comprehensive and up-to-date repository of countries identified by their ISO 3166-1 alpha-2 codes (e.g., BE for Belgium, FR for France). Selected countries include subdivisions identified by their ISO 3166-2 codes (e.g., FR-2A for Corsica), regional groupings (e.g., EU), and other country-specific metadata.

Store and serve tax rate types

Each country profile includes a list of supported tax rate categories (e.g., Standard, Reduced, Higher, Zero) relevant for financial and compliance calculations. These are used consistently across Banqup apps to ensure standardized treatment of tax-related data.

Maintain up-to-date tax rates

Tax rates are maintained to reflect the latest regulations in each country. Each rate category includes:

  • Rate value (as a percentage)
  • Effective start date
  • End date (if applicable)

Banqup ensures regular updates based on verified tax authority sources to maintain accuracy in calculations.

Integrate with other Banqup services

The Country Store is designed for seamless integration with other modules:

  • Product Catalog: Create a drop-down list of tax rates for products based on the country of transaction.
  • Invoicing: Ensure tax compliance by populating the correct tax rates per country during invoice creation.

Data management​

The Country Store is a read-only service for most applications, with updates managed centrally by Banqup to ensure consistency and regulatory compliance. Each service querying the Country Store will always receive the latest available rate information as per the transaction date.

Get started with the Country Store API​

To get started, explore the Country Store API for detailed endpoints, payload formats, authentication, and usage examples, in order to:

  • retrieve the list of supported countries and their ISO codes
  • fetch tax rate types and values per country
  • get effective rate periods for compliance audits