# Tuppence > Payments for developers and AI agents: card payments, payment links, subscriptions, bookings, webhooks, prepaid credit, an MCP server and HTTP 402, in one API with Node and Python SDKs. Amounts are integers in minor units; every write takes an Idempotency-Key; errors have stable codes. Start here for agents: [Agents start here](https://docs.tuppence.ai/docs/agents.md): what Tuppence is, test keys, the SDKs, the MCP server, prices, and when to choose something else. Every page below is also Markdown: add `.md` to its address (https://docs.tuppence.ai/docs/quickstart.md), or ask for its usual address with `Accept: text/markdown`. ## Docs - [Tuppence docs](https://docs.tuppence.ai/docs/): One payments API for developers and AI agents: card payments, payment links, subscriptions, bookings and HTTP 402. - [Agents start here](https://docs.tuppence.ai/docs/agents/): For AI agents and the developers who run them. What Tuppence is, test keys, the SDKs and MCP server, prices, and when to choose something else. - [Quickstart](https://docs.tuppence.ai/docs/quickstart/): Create a payment link with your test key and pay it, in curl, Node or Python. - [Core concepts](https://docs.tuppence.ai/docs/concepts/): The objects, how they connect, the payment lifecycle and the rules every request follows, on one page. - [Use cases](https://docs.tuppence.ai/docs/use-cases/): Integration recipes for checkouts, subscriptions, payment links, platforms, AI agents, bookings and Direct Debit. - [Ask the docs assistant](https://docs.tuppence.ai/docs/ask/): An AI assistant that knows these docs and, when you're signed in, your Tuppence account. - [Pricing](https://docs.tuppence.ai/docs/pricing/): What Tuppence costs in your region. A percentage of each successful payment, with no monthly fee and no minimum, generated from the price list the fee engine charges. - [Take a payment](https://docs.tuppence.ai/docs/payments/): Create a payment, take the card on our hosted page or in your own checkout, then capture, cancel, refund or charge a saved card. - [3-D Secure](https://docs.tuppence.ai/docs/three-d-secure/): How the payer's bank checks it's them (Strong Customer Authentication) in each checkout, what your server sees, saved cards, and testing. - [Payment links](https://docs.tuppence.ai/docs/payment-links/): A URL that takes a payment. Fixed or payer-chosen amounts, single use or reusable, with a QR code. - [Subscriptions](https://docs.tuppence.ai/docs/subscriptions/): Charge a saved card on a plan's calendar. Plans, trials, plan changes priced to the penny, and failed renewals. - [Direct Debit](https://docs.tuppence.ai/docs/direct-debit/): Take payments from customers' bank accounts by Direct Debit (Bacs in the UK). Applying, review, price, timing, limits, indemnity claims, refunds, testing, the API and webhooks. - [Events and tickets](https://docs.tuppence.ai/docs/events/): Sell tickets to an event with no booking fee. Create it, add ticket types, publish its page, and hear about every order. Ticket money is held until after the event. - [Sell tickets on your own website](https://docs.tuppence.ai/docs/events/embed/): Put an event's page and checkout on your site with one tag or a React component, as a button, corner button or inline, and hear when tickets are bought. - [Webhooks](https://docs.tuppence.ai/docs/webhooks/): Signed event notifications, retried for three days and verified in one line. - [Idempotency, retries and errors](https://docs.tuppence.ai/docs/idempotency-and-errors/): Make every write safe to retry, and handle every failure by its stable code. - [Testing](https://docs.tuppence.ai/docs/testing/): Test mode, test cards, and the helpers that do what time, banks and cardholders would. - [Going live](https://docs.tuppence.ai/docs/going-live/): What changes between test mode and taking real money, with a checklist. - [Payouts and settlement](https://docs.tuppence.ai/docs/payouts/): When a payment's money can be paid out: clearing, instant payouts, self-serve UK next-day payouts (POST /v1/payout_settings/next_day) and the prices a business pays (GET /v1/account/pricing). - [Statement descriptors](https://docs.tuppence.ai/docs/statement-descriptors/): What card and bank statements say for a business: the defaults, the lines a business or its platform can change (prefix, card statement name, other payments, payouts), which one wins, and the limits. - [Connect](https://docs.tuppence.ai/docs/connect/): Run payments for the businesses on your platform. Connected accounts with their own verification, one header to act as them, and the whole flow in one script. - [Onboarding connected accounts](https://docs.tuppence.ai/docs/connect/onboarding/): Create a connected account and collect what verification needs, on Tuppence's hosted page in your branding or on your own screens through the API. - [Money for platforms](https://docs.tuppence.ai/docs/connect/money/): Your fee on your accounts' payments, your Connect balance and its daily sweep, transfers, payout schedules and your accounts' losses. - [Webhooks for platforms](https://docs.tuppence.ai/docs/connect/webhooks/): Hear what happens on your connected accounts: a Connect endpoint, `account` on every event, and handling each event once. - [Testing Connect](https://docs.tuppence.ai/docs/connect/testing/): Build and test a platform in test mode: sandbox connected accounts, helpers that verify them and move their money, and a clock for each account. - [MCP server](https://docs.tuppence.ai/docs/mcp/): Give an AI agent Tuppence's tools (payment links, payments, refunds, credit, bookings), limited to what its key allows. - [Agent frameworks](https://docs.tuppence.ai/docs/agent-frameworks/): The MCP server's Tuppence tools in the OpenAI Agents SDK, LangChain and the Claude Agent SDK, each in that framework's shape. - [Agent identity](https://docs.tuppence.ai/docs/agent-identity/): Give an agent its own key pair. It signs each request, and anyone can check the signature against the public keys Tuppence publishes. - [HTTP 402](https://docs.tuppence.ai/docs/http-402/): Charge for an API route in one line. People and agents pay the same way. - [Issue cards](https://docs.tuppence.ai/docs/cards/issue-cards/): Create a virtual card in one call, for your business or one of your agents, or order a physical card for a person. Set its limits and rules, then freeze, unfreeze, replace or cancel it. - [See a card's details](https://docs.tuppence.ai/docs/cards/card-details/): How people see a card's number, expiry, CVC or PIN in the dashboard or app, and how your code or an agent reads a virtual card's details to pay at a checkout, with the guardrails on both. - [Card disputes](https://docs.tuppence.ai/docs/cards/disputes/): Dispute a purchase made with one of your cards: draft it, add the evidence and files its reason needs, and submit once. Covers the network's rules, deadlines, provisional credit and outcomes. - [Card limits](https://docs.tuppence.ai/docs/cards/limits/): The limits on an account's cards, the errors and declines they cause, and how to plan around them and talk to us. - [Set up bookings](https://docs.tuppence.ai/docs/bookings/set-up/): Add services, staff, hours and terms, then publish and share your booking page. In the dashboard or the API. - [Switching from Fresha](https://docs.tuppence.ai/docs/bookings/switching-from-fresha/): Move your Fresha clients and upcoming appointments to Tuppence. - [Switching from Booksy](https://docs.tuppence.ai/docs/bookings/switching-from-booksy/): Move your Booksy clients and upcoming appointments to Tuppence. - [Switching from Square Appointments](https://docs.tuppence.ai/docs/bookings/switching-from-square/): Move your Square customers and upcoming appointments to Tuppence. - [Switching from Vagaro](https://docs.tuppence.ai/docs/bookings/switching-from-vagaro/): Move your Vagaro customers and upcoming appointments to Tuppence. - [Switching from Treatwell Connect](https://docs.tuppence.ai/docs/bookings/switching-from-treatwell/): Move your Treatwell Connect clients and upcoming appointments to Tuppence. - [Booking policies](https://docs.tuppence.ai/docs/bookings/policies/): The terms a client accepts when booking: deposit, card on file, cancellation, fees, notice and approval. Plain English, versioned, kept with every booking. - [Deposits and no-shows](https://docs.tuppence.ai/docs/bookings/deposits-and-no-shows/): Protect a slot with a deposit or a saved card, then charge late-cancellation and no-show fees under the accepted policy, manually or automatically. - [Embed the booking widget](https://docs.tuppence.ai/docs/bookings/embed/): Add your booking page to your website with one tag, as a button, corner button or inline steps, and get notified when a client books. - [Where your bookings come from](https://docs.tuppence.ai/docs/bookings/channels/): Track where each booking came from (Instagram bio, QR code, Google listing and more) with tagged links, and see what each place brings in. - [The Bookings API](https://docs.tuppence.ai/docs/bookings/api/): Build on Tuppence bookings: keys and scopes, availability, holds, bookings, lifecycle, money and events, in call order. - [Bookings for AI agents](https://docs.tuppence.ai/docs/bookings/mcp/): Let your AI receptionist find, book, move and cancel appointments through the MCP server, with a narrowly scoped key and your policy applied. - [Bookings reference](https://docs.tuppence.ai/docs/bookings/): Every bookings object, field and call on one page: services, staff and their hours, availability, and the booking from hold to visit, with its money, messages, calendar and page. - [A dedicated till](https://docs.tuppence.ai/docs/point-of-sale/dedicated-till/): Turn a tablet into a till that opens straight into selling and stays there until the person signed in to Tuppence leaves it. Then lock it to the app with Guided Access or screen pinning. - [A customer display](https://docs.tuppence.ai/docs/point-of-sale/customer-display/): Turn a second tablet, phone or browser tab into a screen facing your customer. It shows the order as it is rung up, the total, the QR to pay, the tip prompt and the receipt QR, in your business's colours. - [Running the door](https://docs.tuppence.ai/docs/point-of-sale/event-check-in/): Check guests in from the Tuppence app or the browser till, online or offline, at several gates, and sell the last tickets at the door from the normal till. - [Your store](https://docs.tuppence.ai/docs/store/): Your site's pages, brand kit and menus are a draft. Publishing checks them and makes them live as a numbered version you can go back to. - [Selling products online](https://docs.tuppence.ai/docs/store/products/): The products you sell at the till go online with a few more fields, photos with descriptions, and collections to group them. - [Store checkout](https://docs.tuppence.ai/docs/store/checkout/): Tuppence hosts your store's checkout on one page. It holds the stock, shows the full total before Pay, takes the payment and makes the order. You set a few options and listen for store.order_placed. - [Store orders](https://docs.tuppence.ai/docs/store/orders/): Your store's orders are orders like the till's, with source online. Find them, read their page, change the address, and cancel with a refund before they are sent. - [Sales channels](https://docs.tuppence.ai/docs/store/channels/): List your store's products on Google, Instagram and Facebook, TikTok Shop and more, from one catalogue and one stock count. What each channel costs, what Tuppence keeps in step and how fast, the API and the events. - [Shipping and delivery](https://docs.tuppence.ai/docs/store/shipping-and-delivery/): Delivery rates live in shipping profiles of zones and rates. Read them, preview what a shopper at an address is offered, and change a rate. - [Packing and labels](https://docs.tuppence.ai/docs/store/packing-and-labels/): Pack store orders by scan, buy a label at the carrier's price, print it, and mark the parcel shipped. Tracking moves the order on. - [Returns and exchanges](https://docs.tuppence.ai/docs/store/returns-and-exchanges/): A store return records what comes back and why, with the returns rules' answer for each line. Approve or reject it, choose how it comes back, then refund it. - [Tax on your online store](https://docs.tuppence.ai/docs/store/tax/): Tuppence works out the tax on every store order from where it is going. In the UK it charges VAT once you say you are registered; in the US it charges sales tax in the states where you hold a registration, and tells you when another state's threshold comes near. - [Your store's policies](https://docs.tuppence.ai/docs/store/policies/): Tuppence writes your store's seven policies from your settings and what is running, and keeps every version. Nothing is shown to shoppers until you approve it. - [Selling abroad](https://docs.tuppence.ai/docs/store/selling-abroad/): Your store delivers in your own country by default. Each destination abroad opens once its checklist is complete, and Tuppence sends the customs details with every parcel. - [Inbox](https://docs.tuppence.ai/docs/store/inbox/): Every conversation shoppers have with your store, in the chat on your site and by email, with the ones that need a person first. - [Ask the shop](https://docs.tuppence.ai/docs/store/ask-the-shop/): Your store's AI assistant answers shoppers from your product details, stock, delivery and policies, and passes anything else to your team. - [Reviews](https://docs.tuppence.ai/docs/store/reviews/): Shoppers review what they bought from your store. You publish, reply, and keep a review off the page only for a rule of your published review policy. - [Search](https://docs.tuppence.ai/docs/store/search/): Your store's search finds products by their words and by what shoppers mean, never shows an empty page, and tells you what shoppers looked for. - [Accounts](https://docs.tuppence.ai/docs/store/accounts/): Shoppers can sign in to your store with a code, no password, and see their orders from every channel, their returns, addresses and preferences in one place. - [Subscribe and save](https://docs.tuppence.ai/docs/store/subscribe-and-save/): Let shoppers have a product on repeat, every few weeks or months, for less. Each repeat order is priced from your catalogue when it is made. - [Flows and campaigns](https://docs.tuppence.ai/docs/store/flows/): Emails that go on their own to the customers who said yes to your news, and one-off campaigns to a group of them. Tuppence works out who gets each one when it sends. - [Selling to AI agents](https://docs.tuppence.ai/docs/store/selling-to-ai-agents/): Every Tuppence store answers AI agents in their own protocols with no setup. UCP over REST and MCP, a store MCP server, ACP for partners, and agent.json. Agents build baskets; the person pays through a checkout link, or a verified agent pays with a Shared Payment Token. - [Store webhooks](https://docs.tuppence.ai/docs/store/webhooks/): Every event your online store sends, grouped as the dashboard shows them, and how a platform hears its connected businesses' stores. - [The Storefront API](https://docs.tuppence.ai/docs/store/storefront-api/): Build your own shop front on your Tuppence store with the publishable key. Products, search, the basket, the checkout and order status, priced exactly as your Tuppence store prices them. - [Build your store with Claude Code](https://docs.tuppence.ai/docs/store/build-with-claude-code/): Have Claude Code build a shop front for your Tuppence store, from the Next.js starter or from nothing, with the publishable key and the Storefront API. - [Build your store with Lovable](https://docs.tuppence.ai/docs/store/build-with-lovable/): Make a shop front in Lovable with your Tuppence store as its back end: products, basket, checkout and orders through the Storefront API and the publishable key. - [Build your store with v0](https://docs.tuppence.ai/docs/store/build-with-v0/): Generate a Next.js shop front in v0 on your Tuppence store, deploy it to Vercel, and take payment on your own domain through the Storefront API. - [Store prompt kit](https://docs.tuppence.ai/docs/store/prompt-kit/): Prompts for Claude Code, Lovable or v0 that build a product grid, a product page, a basket and a checkout on the Storefront API, with the code each one should produce, run in CI. - [Accounting integrations](https://docs.tuppence.ai/docs/accounting/): Connect Xero, QuickBooks, FreeAgent or Sage once and Tuppence posts your sales, fees, refunds and payouts to your books every day, ready to reconcile in one click. Any other tool takes the statement file. - [Xero](https://docs.tuppence.ai/docs/accounting/xero/): Tuppence for Xero: connect once, and each day's sales, fees and refunds post to a Tuppence bank account in Xero, with every payout as a bank transfer that matches your bank feed. UK and US. - [QuickBooks](https://docs.tuppence.ai/docs/accounting/quickbooks/): Tuppence for QuickBooks Online: connect once, and each day's sales, fees and refunds post to a Tuppence bank account in QuickBooks, with every payout as a transfer that matches your bank feed. US and UK. - [FreeAgent](https://docs.tuppence.ai/docs/accounting/freeagent/): Tuppence for FreeAgent: connect once, and each day's sales, fees and refunds are explained in a Tuppence bank account in FreeAgent, with every payout as a transfer that matches your bank feed. UK. - [Sage](https://docs.tuppence.ai/docs/accounting/sage/): Tuppence for Sage Accounting: connect once, and each day's sales, fees and refunds post to a Tuppence bank account in Sage, with every payout as a bank transfer that matches your bank feed. UK. - [The statement file](https://docs.tuppence.ai/docs/accounting/statement-file/): Your Tuppence money as a bank statement, CSV or OFX, for Sage 50, KashFlow, Pandle, Zoho Books, FreshBooks or any accounting tool: GET /v1/accounting/statement.csv and statement.ofx, with stable FITIDs. - [Node.js: @tuppence/node](https://docs.tuppence.ai/docs/sdks/node/): The Tuppence SDK for Node 18+, with typed objects, safe retries and webhook verification. - [Python: tuppence](https://docs.tuppence.ai/docs/sdks/python/): The Tuppence SDK for Python 3.10+, sync and async, with pydantic models. - [Browser: @tuppence/js](https://docs.tuppence.ai/docs/sdks/js/): Take a card in your own checkout through Tuppence's secure card fields: styling, the bank's check (3-D Secure), the Content-Security-Policy your page needs and what the SDK never does. - [Versions and deprecation](https://docs.tuppence.ai/docs/versioning/): Dated API versions, semver SDKs, and how much notice a deprecation gets. - [What we don't do](https://docs.tuppence.ai/docs/not-supported/): What Tuppence deliberately leaves to others, so you can plan around it. ## Reference - [API reference](https://docs.tuppence.ai/docs/reference/): every operation, parameter, object and error code - [OpenAPI document](https://docs.tuppence.ai/docs/openapi.public.json): the public contract, OpenAPI 3.0 - [Storefront API reference](https://docs.tuppence.ai/docs/reference/storefront/): the publishable-key API for your own store front end - [Storefront OpenAPI document](https://docs.tuppence.ai/docs/openapi.storefront.json): the Storefront API's contract - [Everything, in one file](https://docs.tuppence.ai/docs/llms-full.txt): all of the docs above, as Markdown - [Agent guide](https://docs.tuppence.ai/docs/AGENTS.md): rules and recipes for coding agents (also as a Claude skill: https://docs.tuppence.ai/docs/SKILL.md)