> ## 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.

# FAQ

> Short answers to the questions people ask before signing up.

## What is Taberna?

A way to sell digital goods and be paid in crypto. You set a price in dollars or euros,
your customer pays in the coin they hold, and the money arrives in your own wallet a
minute later. You can run the whole thing from a dashboard, or drive it from your own
software with an API.

## Do I need to know anything about crypto?

You need a wallet to be paid into, and you need to understand that payments cannot be
reversed. That is genuinely it — [Crypto basics](/guides/crypto-basics) covers both in a
few minutes.

## Do I need to do KYC?

No. Taberna does not ask for identity documents, company registration or a bank account.
You are responsible for what you sell and for your own tax affairs.

## What does it cost?

Nothing to sign up. **3% of each payment** as standard, deducted automatically as the
money moves to your wallet. Your customer pays their own network fee to send the payment;
Taberna pays the network fee to forward it to you. Nothing else. See
[Fees](/guides/fees).

## How fast do I get paid?

Usually within a minute of the payment confirming. There is no balance to withdraw and no
payout schedule — every payment is forwarded to your wallet as it lands. See
[How you get paid](/guides/how-you-get-paid).

## How do I refund a customer?

**You cannot do it from Taberna.** Payments go straight to your own wallet, so a refund
is a payment you send back from that wallet. Ask the customer for an address on the same
network and send it yourself.

## What currencies can I price in?

USD and EUR. Those are the only two.

## Which coins can my customers pay with?

Whichever of the thirteen supported coins you switch on: SOL and USDC on Solana; ETH,
USDC and USDT on Ethereum and on Base; POL, USDC and USDT on Polygon; BNB and USDT on
BNB Chain. There is no USDC on BNB Chain. See
[Payment methods](/guides/payment-methods).

## What is a stablecoin, and should I take them?

A coin that tracks a normal currency one-to-one — 1 USDC is always about \$1. Yes: start
with a stablecoin on a cheap network like Base or Polygon. Your customer pays cents in
network fees and the amount does not drift while they pay.

## Can I test without real money?

Not yet. There is no test mode — every payment method is a live network. Buy something
cheap from your own shop if you want to see the whole flow.

## What happens if a customer underpays?

The order is marked **partial**. That money is still forwarded to your wallet, but the
order does not complete and nothing is delivered. Nothing happens automatically after
that: honour it, ask them to buy again, or send the money back yourself.

## What happens if they pay too much?

The order completes normally and the extra is forwarded to you along with the rest.

## Do I need a website?

No. Turn on your [storefront](/guides/storefront) and you get a hosted shop at
`yourname.taberna.io`, with your branding and your products. You can point your own
domain at it later.

## Can I sell physical products?

No. Taberna is for digital goods — files, keys, access, links. There is no shipping
address and no postage.

## Can somebody else help me run my store?

Yes. Invite them under **Settings → Team** and pick a role: a **manager** runs the shop
day to day, including its API keys and webhooks; an **admin** also sets it up; a
**viewer** can see everything and change nothing. See [Team](/guides/team).

## Can I give someone access without giving them my payouts?

Yes — that is the point of the roles. Only an owner can change a payout address or invite
anyone, and those two never come with any other role. Everyone else can see where your
money goes, but cannot move it. See [Team](/guides/team).

## Something has gone wrong. Who do I ask?

Email [support@taberna.io](mailto:support@taberna.io) — see
[Getting help](/guides/getting-help) for what to include.
