> ## 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.
# Custom domain
> Run your storefront on a domain you own, like shop.yourbrand.com.
Your shop lives at `yourname.taberna.io` by default. If you own a domain, you can put it
there instead. You need to have claimed a [storefront address](/guides/storefront) first,
and to be an owner or admin — see [Team](/guides/team).
## How it works
1. Enter your domain in **Settings → Storefront**, under Custom Domain.
2. Add the two DNS records Taberna shows you, at whoever you bought the domain from.
3. Wait a few minutes for the status to turn **Active**.
## Add the domain
Enter a domain you control — `shop.yourbrand.com` or `yourbrand.com` both work. **One
domain per store.** To change it, disconnect the current one first.
## Add the DNS records
Taberna shows you exactly what to create. Log in wherever your domain is registered and
add both:
| Type | Name | Value |
| --------- | -------------------------- | ---------------------------- |
| **CNAME** | your domain | The target Taberna shows you |
| **TXT** | The name Taberna shows you | The value Taberna shows you |
The TXT record proves you own the domain, and its name and value are unique to you — copy
them from the dashboard rather than from anywhere else.
## Watch the status
The dashboard checks every few seconds and shows one of three states:
* **Verifying** — the records are not visible yet. DNS changes usually take a few
minutes, occasionally an hour or two.
* **Active** — done. Your shop is live on your domain, with a certificate issued
automatically.
* **Failed** — something is wrong with the domain or its certificate. Check the records
match exactly, then disconnect and add it again.
A domain that stays unverified for **three days** is released, so it can be claimed by
whoever actually controls it.
If verification stalls at **Verifying** for hours with the records in place, email
[support@taberna.io](mailto:support@taberna.io) with the domain — some providers need
an extra certificate record that the dashboard does not yet display.
## Once it is active
Your custom domain becomes the real address of your shop. Visitors who go to
`yourname.taberna.io` are redirected to it automatically, so old links keep working, and
new order links are built on your domain.
Disconnecting the domain sends visitors to it away, and your `taberna.io` address takes
over again.