> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taberna.io/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Taberna is a crypto payments API. Amounts are priced in fiat (USD or EUR) and paid in crypto.
> Fiat amounts are ALWAYS decimal strings ("9.99"), never numbers. Crypto amounts are integer strings in the asset's smallest unit.
> Authenticate merchant endpoints with `Authorization: Bearer tbrn_live_...`. Every key is bound to one store and carries an explicit scope set, so never pass a store id to a /v1 endpoint.
> A 401 means the credential is bad; a 403 means the key lacks a scope. Never retry or re-authenticate on a 403 — surface it as a configuration error.
> The /v1/checkouts endpoints are deliberately unauthenticated and run in the buyer's browser. Never send an API key to a browser.
> Verify webhook signatures over the RAW request body before parsing JSON, and treat delivery as at-least-once: handlers must be idempotent.
> Never grant value based on a browser redirect to successUrl. Fulfil on a signature-verified webhook, or on a server-side read of GET /v1/orders/{id} or GET /v1/invoices/{id}.
> There is no test mode: every payment method is a live chain moving real funds.
> A merchant can run an entire shop with no code: the dashboard creates products and invoices, and every store can host a storefront at {slug}.taberna.io with its own theme, sections, branding and optional custom domain. Never assume the reader has an API integration.
> Taberna issues no refunds and performs no KYC. A refund is something the merchant sends from their own payout wallet, off-platform.
# Storefront
> A hosted shop at your own web address, with your branding and your products.
Every store gets a real shop: a browsable page with your products, a cart, and a checkout
that takes crypto. You claim an address and choose how it looks; Taberna builds and hosts
the rest.
Everything below is under **Settings → Storefront**. Owners, admins and managers can
change how the shop looks and turn it on or off; claiming or changing the web address
itself is for owners and admins only. See [Team](/guides/team).
## How it works
1. Claim a web address, like `acme` — your shop goes live at `acme.taberna.io`.
2. Choose your colours, fonts and page sections, watching the live preview as you go.
3. Press **Publish**.
## Claim your address
In the **Store URL** field, type the name you want and press **Claim**. It must be **3 to
30 characters** — lowercase letters, numbers and hyphens, and it cannot start or end with
a hyphen. Availability is checked as you type, and around two hundred names such as
`shop`, `admin`, `support` and `api` are reserved.
Claiming an address also switches your storefront on.
You can change your address later, as often as you like — but **changing it breaks
every existing link** to your shop. The old address stops working immediately.
The **Storefront enabled** switch takes the shop offline without giving up the address.
While it is off, visitors get a "store not found" page.
## Design your shop
The theme editor has five settings, and a live preview beside it that updates as you
type.
| Setting | Options |
| ---------------- | -------------------------------------------- |
| **Accent color** | Any colour. Used for buttons and highlights. |
| **Background** | Any colour. |
| **Mode** | Light or Dark. |
| **Corners** | None, small, medium, large or fully rounded. |
| **Font** | Sans, Serif, Mono or Display. |
If your accent is too close to your background to read, the editor warns you. It will
still let you publish it.
## Build the page
Your home page is made of **sections**, stacked in the order you choose, up to **ten**.
| Section | What it is |
| -------------------- | ---------------------------------------------------------------------------- |
| **Hero** | The banner at the top: heading, subheading, your logo, an optional button. |
| **Product grid** | Your products, in 2, 3 or 4 columns. Show everything, or hand-pick up to 24. |
| **Text block** | A heading and up to 5,000 characters of plain text. |
| **Featured product** | One product, given the whole width, with an optional tagline. |
| **Announcement bar** | A single line pinned above the page. Up to 200 characters. |
| **FAQ** | Up to 8 question-and-answer pairs, each one expandable. |
Reorder sections with the **up and down arrows** on each one. The eye icon hides a
section without deleting it; the bin removes it.
Only your **listed** products appear on the storefront, newest first, up to 100.
See [Products](/guides/products).
## Branding and footer
Two images:
* **Logo** — shown in the header and hero. Falls back to your store image if unset.
* **Favicon** — the little icon in the browser tab. Square, at least 64×64.
Plus **footer text** (up to 200 characters; the default is a copyright line with your
store name) and six optional social links: Instagram, Twitter / X, TikTok, YouTube,
Discord and your own website. For the first four, a bare handle is enough.
## Keep it private while you build
**Password protection** puts a gate in front of the whole shop: visitors see your logo
and store name, and have to type the password to get any further. Use it to build before
launch, or to run an invite-only shop. Changing or removing the password immediately
locks out everyone who had already got in.
The password must be **at least 8 characters**. The field says 4, but shorter
passwords are rejected when you save.
## One more setting
**Require customer email** is on by default: buyers give an email address before paying,
which is how you reach them about their order. Turn it off for anonymous checkout.
## What to read next
Run the shop on a domain you own.
What appears in your product grid.