# Docs

- [Fianto docs](/): Guides for the people who sell, build and pay with Fianto. Every page is also available as Markdown for your AI tools.
- Get started: What Fianto is and your first payment
  - [Get started](/get-started): What Fianto is, and how to take your first payment.
  - [What is Fianto](/get-started/what-is-fianto): A hosted checkout that lets an approved business take USDC on Solana, straight into its own wallet.
  - [How money moves](/get-started/how-money-moves): What the payer signs, where the price and the service fee go, and when a payment counts as paid.
  - [Do I need a developer?](/get-started/do-i-need-a-developer): Not if you sell from your Fianto shop or a payment link. To take payments on your own site or app, yes. What each path needs.
  - Quickstarts
    - [Quickstart](/get-started/quickstart): Take your first one-time USDC payment with a checkout route, a pay button and a webhook route in Next.js, Express or Hono.
    - [Subscriptions quickstart](/get-started/subscriptions-quickstart): Sell a recurring price. Create it in the dashboard, start a subscription session, and handle the subscription webhooks.
- Merchants: Run your business in the dashboard
  - [Merchants](/merchants): Create your account, get approved, sell from the dashboard, your own shop or payment links, and run your business day to day.
  - Get set up
    - [Create your account](/merchants/create-account): Sign up with your email and a password, confirm the 6-digit code we email you, and land on your setup page.
    - [Set up your business](/merchants/set-up-your-business): Fill in who gets paid, turn on two-factor sign-in, prove your receiving wallet and submit your account for review.
    - [Review and approval](/merchants/review-and-approval): What happens after you submit your account, what each status lets you do, and how notes and decision emails work.
  - Sell
    - [Products and prices](/merchants/products-and-prices): Create products and their USDC prices in the dashboard, add prices instead of editing them, and end what you no longer sell.
    - [Orders and payments](/merchants/orders-and-payments): What each order and payment status means in the dashboard, when an order counts as paid, and what to do when USDC arrives that Fianto did not accept.
    - [Customers](/merchants/customers): How Fianto creates a customer for each paying wallet, what the email on it means, and how to find one in the dashboard.
    - [Subscriptions](/merchants/subscriptions): Sell a recurring price, follow renewals and past-due subscriptions, and cancel a subscription from the dashboard, knowing what a cancel does not do.
  - Shop
    - [Your shop](/merchants/shop): A text-only page of your own at <name>.fianto.xyz where visitors buy your products, built and published from the dashboard.
    - [Create your shop](/merchants/shop-create): Create your shop with the four-step wizard, pick its name and address, and what to know about names and renaming.
    - [Design your shop](/merchants/shop-design): Arrange sections, pick a layout and colour scheme for each, choose one of ten themes and check it in the live preview.
    - [Products and delivery](/merchants/shop-products): Choose which products and prices your shop shows, set each product's button and buyer email, and write what buyers get after paying.
    - [Publish and manage your shop](/merchants/shop-publish): Publish your draft, restore an older version, rename the shop, set where sale emails go, unpublish, and what a suspension means.
    - [After a shop sale](/merchants/shop-after-a-sale): What the buyer's receipt page and email show, your sale email, the daily email allowance, and where a shop sale appears in the dashboard.
  - Payment links
    - [Payment links](/merchants/payment-links): A reusable link that sells one price of one product from Fianto's checkout. When to use one, how a sale works, its statuses and its limits.
    - [Create a payment link](/merchants/payment-links-create): Create a payment link for a new product or an existing price, choose its email, after-payment, end date and limit options, then share it.
    - [Manage your payment links](/merchants/payment-links-manage): Find your payment links, change their settings, close and reopen them, see each link's payments, and find link payments in Orders and Payments.
  - Run your business
    - [Overview](/merchants/overview): What the dashboard's Overview shows, from revenue over a range and four tiles to revenue by day, sources and top products.
    - [Needs attention](/merchants/needs-attention): The three tables on Needs attention, what each one lists, what to do about it, and why a row stays listed after you refund.
    - [Exports](/merchants/exports): Download your payments, orders, subscriptions or customers as a CSV file, for a date range of up to 366 days.
    - [Developer settings](/merchants/developers-settings): Create API keys and roll their secrets, set and verify the webhook URL, send a test event, deliver an event again and recover after a suspension.
  - Account
    - [Security](/merchants/security): Replace your recovery codes, what to do about a new or lost phone, handle lockouts and change your receiving wallet.
    - [Your account](/merchants/your-account): How long you stay signed in, what Sign out does, password changes and resets, sign-in lockouts, and what the dashboard cannot change.
- Developers: API, webhooks, SDKs and the CLI
  - [Developers](/developers): Create checkout sessions, receive webhooks and use the SDKs and CLI.
  - Start
    - [API overview](/developers/overview): The v1 API at a glance. Base URL, applications and their keys, the 20 endpoints, and where to read next.
    - [Authentication](/developers/authentication): Authenticate v1 requests with your app id and secret over HTTP Basic, read the 401, and roll or disable a secret safely.
  - Accept payments
    - [Checkout sessions](/developers/checkout-sessions): Create a one-time USDC checkout session from your server, send the payer to it, and reissue or cancel it.
    - [Subscriptions](/developers/subscriptions): Sell a recurring USDC price with a subscription session, follow the subscription's status, and cancel it from your server.
    - [Shop sales in your integration](/developers/shop-sales): How a merchant's shop sales reach your server through the Shop application's webhooks, how to recognise them, and why the API and SDK are unchanged.
    - [Payment link sales in your integration](/developers/payment-link-sales): How payments made through a merchant's payment links reach your server through the Shop application's webhooks, and how to tell them from shop sales.
  - Webhooks
    - [Webhooks](/developers/webhooks/overview): How Fianto tells your server that an order is paid or a subscription changed, and what every delivery looks like.
    - [Verify webhooks](/developers/webhooks/verify): Check Fianto's webhook signatures in Next.js, Express or Hono with the SDK or verifyWebhook, and roll your signing secret safely.
    - [Event types](/developers/webhooks/events): Every Fianto webhook event, when it fires, and an example payload for each.
    - [Retries and delivery](/developers/webhooks/retries-and-delivery): When a webhook delivery counts as delivered, how Fianto retries, when an endpoint is suspended, and how to redeliver.
  - Build safely
    - [Testing](/developers/testing): There is no test mode. Test with signed sample events, a real test.event, forwarded live events, and a self-hosted or local backend.
    - [Idempotency](/developers/idempotency): Every v1 write needs an Idempotency-Key. How keys are kept for 24 hours, what a replay returns, and the five idempotency errors.
    - [Errors](/developers/errors): The v1 error body, request ids, the codes you will meet most, and how the SDK turns errors into classes and retries.
    - [Pagination and rate limits](/developers/pagination-and-rate-limits): Page through v1 lists with limit and next_cursor, walk them with the SDK, and stay inside the request limits.
  - Tools
    - [SDKs](/developers/sdks/overview): The seven Fianto packages, what each one is for, and which to install for Next.js, Express, Hono or a plain page.
    - [@fianto/sdk](/developers/sdks/sdk): The server SDK - constructor options and env, resources, per-call options, the webhooks and handlers subpaths, errors and retries.
    - [Next.js](/developers/sdks/nextjs): Add Fianto's checkout and webhook routes to a Next.js App Router app with Checkout() and Webhooks() from @fianto/nextjs.
    - [Express](/developers/sdks/express): Mount Fianto's checkout and webhook middleware in Express before any body parser, with the 1 MiB body cap and proxy settings.
    - [Hono](/developers/sdks/hono): Add Fianto's checkout and webhook handlers to a Hono app on Node or Cloudflare Workers, where secrets come from c.env.
    - [Browser (@fianto/js)](/developers/sdks/js): Open Fianto checkout from the browser with openCheckout, redirectToCheckout or the <fianto-button> element, and read its four result statuses.
    - [React](/developers/sdks/react): Open Fianto checkout from React with the FiantoButton component or the useCheckout hook, in client components on React 19.
    - [CLI](/developers/cli): Every Fianto CLI command and flag - whoami, events list, get and tail, trigger and sign - with the environment variables and exit codes.
    - [Examples](/developers/examples): The two example apps in the SDK repository - a Next.js subscription checkout and an Express one-time checkout - and what each shows.
- Payers: Paying with Fianto and managing subscriptions
  - [Payers](/payers): Pay with your Solana wallet and manage your subscriptions.
  - Paying
    - [Paying with Fianto](/payers/paying-with-fianto): Pay a shop in USDC from your Solana wallet on Fianto's checkout page, and what happens after you approve.
    - [Buying from a shop](/payers/buying-from-a-shop): Buy from a merchant's shop at <name>.fianto.xyz, pay on Fianto's checkout page, and find what you bought on the receipt and in your email.
    - [Paying through a payment link](/payers/paying-through-a-payment-link): Pay a merchant's payment link from your Solana wallet, through the link's page and Fianto's checkout page, and what a closed link shows.
    - [What it costs](/payers/what-it-costs): What you pay for a one-time payment, a subscription, each renewal and each action in the subscriptions portal.
  - Subscriptions
    - [Your subscriptions](/payers/your-subscriptions): Sign in to Fianto's subscriptions portal with your wallet to see every Fianto subscription it pays, across every shop.
    - [Cancel a subscription](/payers/cancel-a-subscription): Cancel a subscription on Solana from the portal, what a cancel does and does not do, and what to do when the shop cancelled it.
    - [Failed renewals](/payers/failed-renewals): When Fianto cannot take a renewal, how often it tries again, what "Past due" means, and how to fix it before the subscription ends.
    - [Reclaim rent](/payers/reclaim-rent): Get a subscription's account rent back in SOL once it has ended and been cancelled on Solana.
  - Help
    - [Get help](/payers/get-help): Who to contact about a payment, a refund, the checkout page or the subscriptions portal.
- Concepts: How Fianto works underneath
  - [Concepts](/concepts): How payments, subscriptions and the on-chain program work.
  - [Payment lifecycle](/concepts/payment-lifecycle): How a checkout session, its order and each payment move between statuses, which events each move sends, and why no status is final too early.
  - [Subscription lifecycle](/concepts/subscription-lifecycle): How a subscription starts, renews, falls past due and ends, when Fianto retries a renewal, and what each kind of cancel changes.
  - [Finality](/concepts/finality): Why Fianto shows the payer success at confirmed but marks an order paid and sends webhooks only at finalized, and what counts as proof of payment.
  - [Fees](/concepts/fees): How Fianto's service fee and the subscription network fee are set, paid and shown, and how gross and net appear in reports.
  - [The Subscriptions program](/concepts/subscriptions-program): The Solana program behind Fianto subscriptions, what it checks on every charge, how plans are created, and the payer's shared USDC approval.