What is a crypto QR code?
A crypto QR code encodes a wallet address along with the amount and token a sender should pay. Scanning it with a wallet app pre-fills the transaction so the sender doesn't have to copy-paste the address or type the amount manually.
Is Toreador really free?
Yes. The Free plan generates unlimited native QR codes (BTC, ETH, SOL, POL) at no cost, with no signup required. Plus and Pro plans unlock higher daily limits for ERC-20 sessions and the public API. Toreador never takes a cut of the on-chain payment itself — funds always go directly from the payer to the recipient.
Does Toreador hold my crypto at any point?
No. Toreador is 100% non-custodial. Your customer's wallet signs and broadcasts the transaction directly to the blockchain, with the recipient address you supplied. There is no Toreador wallet, no escrow, no routing through a server. Toreador only watches the chain to confirm the payment.
Which tokens and blockchains are supported?
Native tokens: BTC (Bitcoin), ETH (Ethereum, Polygon, Base), SOL (Solana), POL (Polygon). Stablecoins via payment session: USDC (Ethereum, Polygon, Base, Solana), USDT (Ethereum, Polygon, Base), EURC (Ethereum, Base).
What's the difference between a native QR and a payment session?
Native QRs work for tokens that can be sent directly via a URI scheme — Bitcoin, native ETH, SOL, Solana SPL like USDC. For ERC-20 stablecoins on EVM chains (USDT, USDC on Ethereum/Polygon/Base, EURC), Toreador creates a payment session instead: a hosted page that handles the EVM contract call and tracks confirmations in real time.
How does my customer pay from this QR code?
They open their wallet app (MetaMask, Trust Wallet, Phantom, Coinbase Wallet, etc.), tap Scan, point at the QR code, and confirm the pre-filled transaction. The amount, token, and recipient address are already set — they just sign.
Can I receive USDT or USDC via QR code?
Yes. For Solana USDC, Toreador generates a native Solana Pay QR. For USDT and USDC on Ethereum, Polygon, and Base, a payment session URL is generated — your customer opens it and connects their wallet to send the ERC-20 transfer.
Do I need an account to generate a QR code?
No. The basic generator is open to everyone, and the public REST API endpoint POST /generate-qr is also free without any API key for native tokens (BTC, ETH, SOL, POL, USDC on Solana), rate-limited to 50 requests/hour and 200/day per IP. AI agents like Claude, ChatGPT and Perplexity can call it directly. Signing in unlocks history tracking, higher session limits on Plus, and full API access (including ERC-20 sessions, webhooks, MCP server) on Pro.
Is sharing the QR code safe?
Yes. A QR code only contains your public wallet address and the requested amount — the same information as a normal payment link. Nobody can drain your funds from a QR code; only signed transactions move money on a blockchain.
Can I use Toreador for in-store payments?
Yes — that's a primary use case. Print or display the QR code, the customer scans it from their wallet, the payment lands directly in your wallet. For physical merchants, the payment session flow gives you a real-time confirmation badge before you hand over goods.
Can I integrate Toreador into my app or website?
Yes, with the Pro plan. Use the REST API directly or install the official TypeScript SDK. Webhooks notify your backend when a payment session moves to completed, expired, or failed.
What happens if my customer pays the wrong amount?
The blockchain accepts any amount sent to your address — Toreador can't enforce the requested amount on the network itself. The session flow tracks the actual on-chain amount so your dashboard shows what was really sent. For physical merchants, double-check before handing over goods.
Are testnet or sandbox tokens supported?
Not yet on the public site. A sandbox mode with testnet API keys (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet) is on the public roadmap.
Where can I see my payment history?
In your Dashboard, the History tab lists all generated QR codes and payment sessions for your account. The Pro plan also exposes this via the /history and /sessions API endpoints.
Can AI assistants like Claude or ChatGPT generate QR codes through Toreador?
Yes. Toreador publishes an official Model Context Protocol (MCP) server, @toreador/mcp-server. Add it to Claude Desktop or any MCP-capable assistant and ask in natural language — e.g. "generate a Bitcoin QR code for 0.001 BTC to bc1q...". Without an API key, the assistant gets one free tool for native tokens (BTC, ETH, SOL, POL, USDC on Solana). With a Pro key, ERC-20 sessions, payment status polling and history are also exposed. Full setup guide and tools list at https://toreador.io/mcp.