> ## 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.
# Crypto basics
> Wallets, stablecoins, network fees and why a crypto payment cannot be reversed — in plain English.
You do not need to be a crypto expert to sell with Taberna. You do need to understand
six things, and each one takes a paragraph.
## What is a crypto wallet
A crypto wallet is an app — a browser extension, a phone app, or a small hardware
device — that holds the keys to money recorded on a public ledger. It is not an account
with a company. Nobody can freeze it, and nobody but you can move what is in it. Each
wallet has one or more **addresses**: long strings of letters and numbers, like
`0x3f1c…9a4b`, that work like an account number you can safely publish.
You will need a wallet to receive your sales. Your customers will need one to pay you.
## What is a stablecoin
A stablecoin is a crypto token designed to track a normal currency one-to-one, so 1
USDC is always worth about $1. Most crypto prices move minute to minute; stablecoins do
not, which is why they are the easiest thing to accept. If you sell a $50 product and
your customer pays in USDC, roughly \$50 of USDC arrives.
Taberna supports USDC and USDT stablecoins alongside the native coins of each network.
See [Payment methods](/guides/payment-methods).
## What is a network fee
Every crypto payment is recorded on a **blockchain** — a shared public ledger run by
thousands of computers. Those computers charge a small fee to record a transaction,
called the **network fee** or **gas**. It has nothing to do with Taberna and varies by
network: a few cents on Base or Polygon, sometimes several dollars on Ethereum.
Your customer pays the network fee to send you money. You do not. Taberna pays the
network fee on the transaction that moves your money to your own wallet. See
[Fees](/guides/fees).
## What "confirmations" means
A payment is not final the instant it is sent. The network needs to record it and then
record a few more blocks on top, which makes it progressively harder to undo. Each new
block on top is one **confirmation**.
This is why a crypto payment takes seconds to a couple of minutes rather than being
instant. Taberna watches the network for you and only marks an order paid once enough
confirmations have accumulated for that network.
## Why crypto payments cannot be reversed
Once a payment has been recorded and confirmed, it is permanent. There is no bank in
the middle who can pull it back. This is genuinely good news for you: money you have
been paid stays paid.
It is also the reason **Taberna cannot issue refunds**. If you want to return money to
a customer, you send it back from your own wallet, on your own terms. See
[What Taberna does not do](/guides/what-taberna-does-not-do).
## What this means for chargebacks and disputes
There are no chargebacks. A customer cannot ask their card issuer to claw a payment
back sixty days later, because there is no card issuer. You will not lose a sale you
already delivered, and you will not pay dispute fees.
The flip side is that you carry the customer-service burden yourself. If someone pays
the wrong amount, pays twice, or changes their mind, you resolve it directly with them
and, if you choose to, send money back from your wallet.
If a customer sends less than the amount you asked for, the order is marked
**partial** and nothing is returned automatically. See
[Orders and payments](/guides/orders-and-payments).
## What to read next
Sign up, add a payout address, create a product, share the link.
What Taberna takes, and who pays the network.