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

# Payment methods

> The coins your customers can pay with, and which ones to switch on first.

You price your products in **USD or EUR**. Your customers pay in crypto, and you decide
which coins you accept. Whatever you enable is what they see at checkout.

Switching a coin on or off needs the owner or admin [role](/guides/team).

## The thirteen payment methods

Taberna supports thirteen coins across five networks. A **network** (or blockchain) is
the public ledger a coin lives on; the same coin on two networks is two different
payment methods, because the money travels on different rails.

| Network   | Native coin | Stablecoins |
| --------- | ----------- | ----------- |
| Solana    | SOL         | USDC        |
| Ethereum  | ETH         | USDC, USDT  |
| Base      | ETH         | USDC, USDT  |
| Polygon   | POL         | USDC, USDT  |
| BNB Chain | BNB         | USDT        |

<Info>
  A **stablecoin** is a crypto token that tracks a normal currency one-to-one, so 1
  USDC is always worth about \$1. Native coins — SOL, ETH, POL, BNB — move in price
  all day.
</Info>

**There is no USDC on BNB Chain.** If you enable BNB Chain, your customers can pay in
BNB or USDT there, and nothing else.

## What to switch on first

Start with **one stablecoin on a low-fee network** — USDC on Base or on Polygon. Two
reasons:

* Your customer pays a few cents to send it, instead of several dollars on Ethereum.
* The amount does not drift while they are paying. With a native coin, the price is
  locked for the payment window and the customer bears any movement outside it; with a
  stablecoin there is nothing to move.

You can add more coins later at any time. More coins means more customers can pay you,
so once you have taken a few payments it is worth turning on the stablecoins on every
network you are willing to hold a wallet for.

## Turning methods on

Payment methods are set per store, under **Settings → Payments**. Each network gets its
own panel with a switch per coin.

When you first [set up your store](/guides/create-your-store) you choose one network and
Taberna switches on every coin on it for you. After that you turn coins on and off
individually.

<Frame caption="Settings → Payments: a switch for every coin, grouped by network.">
  <img src="https://mintcdn.com/taberna/CSV07Wzd5bzv2KKK/images/dashboard-payment-methods.png?fit=max&auto=format&n=CSV07Wzd5bzv2KKK&q=85&s=40176b4bbf96a3e98d8e7034e26350bf" alt="The Payment Methods card in store settings, showing switches for each coin grouped into panels per network" width="1200" height="675" data-path="images/dashboard-payment-methods.png" />
</Frame>

A coin's switch stays greyed out until you have added a payout address for its network —
the panel header shows **(no address)** until you do.

<Info>
  Enabling a network's coins is only half the job. You also need a **payout address**
  on that network, or there is nowhere for the money to go. See
  [Payout wallets](/guides/payout-wallets).
</Info>

## What to read next

<CardGroup cols={2}>
  <Card title="Payout wallets" icon="wallet" href="/guides/payout-wallets">
    One receiving address per network.
  </Card>

  <Card title="Crypto basics" icon="book" href="/guides/crypto-basics">
    Wallets, stablecoins and network fees explained.
  </Card>
</CardGroup>
