How multi-jurisdiction support works

Operating on five markets is not a matter of translating the interface. Data residency, the identifier model, deadline calculation, the set of sources and document templates all change.

Data region as part of the model

Some jurisdictions require personal data of their citizens to be processed in databases located on their territory. Retrofitting a system with the notion of a region after it was built without one means rewriting the whole data access layer.

  1. 01

    Region belongs to the organization

    It is set when the organization is created and does not change without a dedicated migration procedure.

  2. 02

    Data stays inside the environment

    Exchange between products of the line happens within the region of the organization.

  3. 03

    Routing at the platform level

    A request reaches the correct environment before any business logic runs.

  4. 04

    Backups in the same region

    Backups are stored where the primary database is and are not moved between environments.

Information about legal requirements is provided as a design reference, not as a legal opinion. Before launching in a specific country, every point is confirmed by lawyers of that jurisdiction: requirements in this area change often.

Identifiers

An identifier is not a fixed-format field but a typed record. A subject may hold several, including from different countries: a citizen of Kyrgyzstan holding a Kazakh identifier is common in labour migration.

{ country, type, value }

Kazakhstan
IndividualsIIN
Legal entitiesBIN
Russia
IndividualsINN, SNILS
Legal entitiesINN, OGRN
Kyrgyzstan
IndividualsPIN, INN
Legal entitiesINN
Uzbekistan
IndividualsPINFL, INN
Legal entitiesINN
Mongolia
IndividualsRegistration number
Legal entitiesRegistration number

Languages and scripts

Three regional traits affect not translation but search, string comparison and deduplication.

Uzbek in two scripts

The official script is Latin, yet Cyrillic is widely used in documents and databases. The same person may be recorded in either alphabet, so two-way transliteration and storing both spellings as search indexes are required.

Kazakh moving to Latin

The transition is gradual and stretched over time. Names will appear in both scripts throughout the life of the product, so the transliteration mechanism is built in from the start as a shared component.

Mongolian Cyrillic differs

The alphabet has additional letters and its own collation rules. Comparing Mongolian strings under a Russian locale yields the wrong order, so sorting runs by locale rather than byte by byte.

What is set independently of language

Interface language is a user setting. Country, time zone, currency and calendar belong to the organization and are not derived from language: a Russian-speaking user in Mongolia is an ordinary case.

Time zone
An attribute of the user and of the legal entity. Russia has eleven, so a zone cannot be derived from a country.
Deadline expiry
Computed in the time zone of the object, not of the user.
Business calendar
Maintained per country: holidays and day shifts almost never coincide.
Currencies
Tenge, rouble, som, sum, tugrik, dollar and euro. Amounts are stored with their currency, never normalized to one.
Magnitude
Amounts in sum and tugrik are orders of magnitude larger than in roubles. Fields and formatting handle that.
Exchange rates
Taken on the transaction date for reporting, with a configurable source.

Checked and unchecked are different states

Source coverage differs between countries. Conflating these states creates a false sense of verification and is the most dangerous defect in systems of this class, so the platform separates them explicitly.

Trait checked

The source responded and the trait is absent. The result feeds scoring and is stored with a validity date.

Source unavailable

The check could not be performed. Scoring does not treat this as a clean result, and the record shows the reason and the time of the last attempt.

Shall we discuss your market?

We will tell you which sources are already connected in your country, what runs as stubs, and which points need legal confirmation before launch.