Shop Configuration
Every setting explained. Only title, token, and wallet are required — inventory and currency are auto-detected.
Checkout modes
Controls what you collect from customers before payment.
| Mode | Collects | Best for |
|---|---|---|
none | Nothing | Digital goods, anonymous purchases |
email | Email address | Download links, receipts |
address | Full shipping address | Physical products |
The checkout mode determines what buyer information is collected and whether shipping costs apply. It is the single source of truth for both.
Address fields collected in address mode
| Field | Required |
|---|---|
| Name | Yes |
| Street | Yes |
| Apartment / Unit | No |
| PO Box | No |
| City | Yes |
| State / Province | No |
| ZIP / Postal code | Yes |
| Country | Yes |
Currency
Automatically synced from your Inventory extension. Set the currency there — the shop reads it on every product refresh.
sat for sats-only pricing. Any fiat code (USD, EUR, GBP, ...) for fiat display with automatic sat conversion at checkout.
NOTE
There is no currency selector in the shop settings. The Inventory is the single source of truth for currency.
Shipping
Three settings that stack:
| Setting | What it does |
|---|---|
| Flat rate | Fixed cost per order with physical items |
| Per-kg rate | Added per kilogram of total weight |
| Free threshold | Orders above this subtotal ship free |
All three at zero = free shipping everywhere.
NOTE
Shipping charges apply when the checkout mode is set to address. The checkout mode is the single source of truth — there is no per-product shipping flag.
Tax
Configured in your Inventory extension, not here. Telegram Shopping reads:
- Per-product tax rate (or inventory default as fallback)
- Tax-inclusive pricing toggle (default: on — listed prices include tax)
Tax shows as a separate line in the cart.
Returns
| Setting | Default | Effect |
|---|---|---|
| Allow returns | On | Shows return option in order history |
| Return window | 720 hours (30 days) | Time limit for return requests |
| Allow credit refund | On | Enables store credit as a refund option |
Order tracking
When enabled, orders move through:
Preparing → Shipping → DeliveredEach transition notifies the customer in Telegram. You can attach a note (tracking number, delivery instructions) that the customer sees.
Tag filtering
Each shop can filter which products appear using two tag settings:
| Setting | Effect |
|---|---|
| Include tags | Only show products matching these tags. Leave empty to show all. |
| Omit tags | Hide products matching these tags. Applied after include filter. |
This is separate from the Inventory-level omit_tags. Shop-level filtering lets different shops on the same inventory show different product subsets.
Example: One inventory with 100 products. Shop A sets include_tags to retail — only retail products appear. Shop B sets omit_tags to wholesale — everything except wholesale items appears.
Webhook security
When using webhook mode, the extension generates a random secret_token per shop. Telegram sends it in every update via the X-Telegram-Bot-Api-Secret-Token header. The extension verifies it — unsigned updates are rejected silently.
Admin chat ID
Your personal Telegram chat ID. When set, you receive notifications for:
- New paid orders
- Customer messages
- Return requests
Find yours: message @userinfobot in Telegram.