Merchant Items and Countries
Two supporting record types define what a merchant offers and where they operate:
- Merchant items - map merchants to the products or services they provide
- Merchant countries - record which countries a merchant operates in
Together they answer the questions "what does this merchant sell?" and "where does this merchant operate?"
Merchant items
Purpose
Merchant item records link merchants to items in the general product catalogue. Each record represents a specific product or service that a merchant offers, optionally scoped to a particular location.
Key fields
| Field | Purpose |
|---|---|
merchant_id | The merchant offering this item |
party_site_id | Optional location where this item is offered |
item_id | The item or service being offered |
is_active | Whether this offering is currently active |
Location-scoped offerings
The optional party_site_id field allows the same merchant to offer different items at different locations. For example, a healthcare provider with multiple clinics might offer CT scans at one site and physiotherapy at another. When no location is specified, the item is considered available across all of the merchant's locations.
Duplicate offering records are prevented within each tenant.
Authorisation
Merchant items are managed through the parent merchant's permissions. Users who can manage a merchant can maintain its offered products and services.
Merchant countries
Purpose
Merchant country records identify the countries where a merchant operates, using ISO country codes.
Key fields
| Field | Purpose |
|---|---|
merchant_id | The merchant |
merchant_country_code | ISO 2-letter country code |
merchant_primary_country | Whether this is the merchant's primary country |
active | Whether this country mapping is active |
Primary country
The merchant_primary_country flag designates one country as the merchant's principal operating location. Raytio prevents duplicate active country entries for the same merchant and country code.
Authorisation
Merchant country mappings are broadly visible within the tenant because country data is non-sensitive reference information. Changes require the appropriate merchant management permissions.