XiriGo Admin DocsPlatform Settings
Configure general platform settings, sales channels, API keys, return reasons, regions, tax zones, and currencies.
Platform Settings
The Settings module is where you configure the foundational aspects of the XiriGo marketplace. Changes here affect the entire platform, so modify settings carefully and document the reason for changes.
General Settings
The general settings page uses a key-value configuration interface organized by category. Each setting has a name, current value, description, and last-modified timestamp.
Setting Categories
| Setting | Description | Default |
|---|---|---|
platform.name | Marketplace display name | XiriGo |
platform.url | Primary marketplace URL | https://xirigo.mt |
platform.support_email | Customer support email address | [email protected] |
platform.default_currency | Default currency for display | EUR |
platform.default_locale | Default locale | en-MT |
platform.timezone | Platform timezone | Europe/Malta |
| Setting | Description | Default |
|---|---|---|
commission.default_rate | Platform-wide default commission percentage | 12% |
commission.minimum_amount | Minimum commission amount per transaction (EUR) | 0.50 |
commission.payout_frequency | How often payouts are processed | weekly |
commission.payout_minimum | Minimum balance for payout eligibility (EUR) | 25.00 |
commission.payout_delay_days | Days after order completion before commission is payable | 14 |
| Setting | Description | Default |
|---|---|---|
shipping.free_threshold | Order amount for free shipping eligibility (EUR) | 50.00 |
shipping.default_provider | Default shipping provider | Malta Post |
shipping.tracking_required | Whether vendors must provide tracking numbers | true |
shipping.max_delivery_days | Maximum allowed delivery days before flagging | 7 |
| Setting | Description | Default |
|---|---|---|
returns.window_days | Number of days after delivery to request a return | 14 |
returns.auto_approve | Whether returns are auto-approved or require admin review | false |
returns.restocking_fee | Default restocking fee percentage | 0% |
returns.return_shipping | Who pays return shipping (customer/vendor/platform) | vendor |
| Setting | Description | Default |
|---|---|---|
payouts.schedule | Payout processing schedule | Every Monday |
payouts.method | Payout method | Bank transfer |
payouts.currency | Payout currency | EUR |
payouts.auto_process | Whether payouts are processed automatically | true |
| Setting | Description | Default |
|---|---|---|
onboarding.auto_approve | Auto-approve vendor applications | false |
onboarding.required_documents | Documents required for vendor registration | business_license, tax_id |
onboarding.trial_days | Free trial period for new vendors (days) | 30 |
onboarding.welcome_email | Send welcome email on approval | true |
| Setting | Description | Default |
|---|---|---|
reviews.moderation | Whether reviews require admin approval | true |
reviews.minimum_order | Minimum order status to leave a review | delivered |
reviews.allow_photos | Allow customers to upload review photos | true |
reviews.edit_window_days | Days after submission to edit a review | 7 |
| Setting | Description | Default |
|---|---|---|
coupons.stacking | Allow multiple coupons per order | false |
coupons.max_discount_percent | Maximum discount percentage allowed | 50% |
coupons.vendor_coupons | Allow vendors to create their own coupons | true |
| Setting | Description | Default |
|---|---|---|
notifications.order_confirmation | Send order confirmation emails | true |
notifications.shipping_update | Send shipping notification emails | true |
notifications.review_request | Send review request after delivery | true |
notifications.review_request_delay | Days after delivery to send review request | 3 |
notifications.abandoned_cart | Send abandoned cart reminders | true |
notifications.abandoned_cart_delay | Hours before sending cart reminder | 24 |
Editing Settings
Use the category tabs to find the setting you want to modify.
Click the pencil icon next to the setting value.
Modify the value. The input type matches the setting (text, number, boolean toggle, select dropdown).
Click Save. The change takes effect immediately across the platform. The change is recorded in the audit log.
Settings changes affect the entire platform immediately. Test changes in a staging environment first when possible, especially for financial settings like commission rates and payout schedules.
Sales Channels
Manage the sales channels through which products are sold:
| Channel | Description |
|---|---|
| Web Store | The primary xirigo.mt web storefront |
| Mobile App | The XiriGo buyer mobile application (iOS and Android) |
| API | Direct API access for third-party integrations |
Each sales channel can be enabled/disabled and configured independently with its own product visibility rules and pricing.
API Keys
Manage API keys for third-party integrations and internal services:
| Column | Description |
|---|---|
| Key Name | Descriptive label for the API key |
| Key Prefix | First 8 characters of the key (full key shown only at creation) |
| Permissions | Scopes assigned to this key (read, write, admin) |
| Created | Creation date |
| Last Used | Most recent API call timestamp |
| Status | Active or revoked |
Click Create API Key. Provide a name and select permission scopes.
The full API key is displayed only once at creation. Copy and store it securely.
Include the key in API requests via the x-api-key header or Bearer token authentication.
API keys provide programmatic access to the platform. Treat them like passwords. Revoke keys immediately if they are compromised.
Return Reasons
Configure the list of return reasons available to customers when requesting a return:
| Property | Description |
|---|---|
| Label | Display text shown to the customer (e.g., "Item arrived damaged") |
| Code | Internal code for reporting (e.g., damaged) |
| Requires Description | Whether the customer must provide additional details |
| Requires Photo | Whether the customer must upload a photo |
| Active | Whether this reason is currently available |
Create, edit, reorder, or deactivate return reasons as needed. Deactivated reasons are hidden from customers but preserved for historical orders.
Regions
Regions define the geographic areas where the marketplace operates, along with their tax and currency settings:
| Property | Description |
|---|---|
| Region Name | Display name (e.g., "Malta", "EU") |
| Countries | Countries included in this region |
| Currency | Currency used in this region |
| Tax Provider | Tax calculation method |
| Payment Providers | Available payment methods in this region |
| Fulfillment Providers | Available shipping methods in this region |
Tax Configuration
Tax Zones
Tax zones group countries or regions that share the same tax rules:
| Zone | Description | Example |
|---|---|---|
| Domestic | Malta domestic sales | 18% standard VAT |
| EU | Intra-EU sales | Country-specific VAT rates |
| Non-EU | Sales outside the EU | Zero-rated or export duties |
Tax Rates
Configure tax rates per zone and product category:
| Property | Description |
|---|---|
| Zone | Tax zone this rate applies to |
| Category | Product category (or "all") |
| Rate | Tax percentage |
| Name | Display name (e.g., "VAT 18%") |
| Inclusive | Whether prices already include this tax |
Currencies
Manage the currencies accepted on the platform:
| Currency | Code | Symbol | Status |
|---|---|---|---|
| Euro | EUR | EUR | Primary |
| British Pound | GBP | GBP | Secondary |
| US Dollar | USD | USD | Secondary |
Malta's primary currency is the Euro (EUR). Additional currencies can be enabled for international customers, with automatic exchange rate updates.