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?
Direct QR codes are free and unlimited, with no signup required (BTC, ETH, POL, SOL, BNB, AVAX). Tracked payments are included in every plan, the free plan too, up to its quota; paid plans raise that quota. 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 detect the payment's confirmation.
Which tokens and blockchains are supported?
Native coins: BTC (Bitcoin), ETH (Ethereum, Base, Arbitrum), POL (Polygon), SOL (Solana), BNB (BNB Chain), AVAX (Avalanche). Stablecoins: USDC, USDT, EURC, PYUSD, USDG, RLUSD, USAT, OUSD. Networks: Bitcoin, Ethereum, Polygon, Solana, Base, Arbitrum, Avalanche, BNB Chain. Not every asset exists on every network, and some pairs are tracked while others are direct QR codes only: the Supported assets page lists every pair.
What's the difference between a native QR and a payment session?
A native QR is a direct wallet-to-wallet request. It works for coins a wallet can send from a standard link: BTC, ETH, POL, SOL, BNB and AVAX, and tokens on Solana such as USDC. For a token on an Ethereum-type network (every stablecoin there, for example), Toreador creates a payment session instead: a hosted page that prepares the contract call for the payer's wallet to sign and tracks confirmations in real time. You can also choose a payment session for ETH, POL, SOL, BNB and AVAX. Bitcoin and tokens on Solana are direct only.
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. On Solana, USDC is a native Solana Pay QR code: it goes wallet to wallet and is not tracked. On Ethereum, Polygon, Base, Arbitrum, Avalanche and BNB Chain for USDC, and Ethereum, Polygon, Base, Arbitrum, Avalanche and BNB Chain for USDT, a payment session is created — your customer opens it and connects their wallet to send the transfer, and you follow the confirmation.
Do I need an account to generate a QR code?
Not for the web generator: it is open to everyone, with a small daily allowance per visitor. The REST API, the SDK and the MCP server always need an API key, included in every plan, the free plan included — a tor_test_ key for the testnet sandbox, a tor_live_ key for mainnet. Signing in also unlocks payment history, tracked payments and webhooks; per-minute rate and monthly quota depend on your plan.
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 shows the on-chain confirmation status in real time so you can decide when to hand over goods.
Can I integrate Toreador into my app or website?
Yes, on every 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. Plans differ by per-minute rate and monthly quota of tracked payments.
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?
Yes. Generate a tor_test_ key in your dashboard: every endpoint then runs on test networks (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet), outside any quota, with test tokens from the public faucets.
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 API 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...". Every tool needs an API key (free plan included): a test key for the sandbox, a live key for mainnet. Full setup guide and tools list at https://toreador.io/mcp.