Che cos'è un codice QR crypto?
Un codice QR crypto codifica l'indirizzo di un wallet insieme all'importo e al token che il mittente deve pagare. Scansionandolo con un'app wallet, la transazione viene precompilata: il mittente non deve copiare e incollare l'indirizzo né digitare l'importo a mano.
Toreador è davvero gratuito?
I codici QR diretti sono gratuiti e illimitati, senza registrazione (BTC, ETH, POL, SOL, BNB, AVAX). I pagamenti tracciati sono inclusi in ogni piano, anche in quello gratuito, fino alla sua quota; i piani a pagamento aumentano tale quota. Toreador non trattiene mai una parte del pagamento sulla blockchain — i fondi vanno sempre direttamente dal pagatore al destinatario.
Toreador detiene le mie criptovalute in qualche momento?
No. Toreador funziona al 100% senza custodia. Il wallet del Suo cliente firma e trasmette la transazione direttamente sulla blockchain, verso l'indirizzo del destinatario che Lei ha indicato. Non esiste alcun wallet Toreador, nessun deposito a garanzia, nessun passaggio attraverso un server. Toreador osserva soltanto la blockchain per rilevare la conferma del pagamento.
Quali token e blockchain sono supportati?
Criptovalute native: BTC (Bitcoin), ETH (Ethereum, Base, Arbitrum), POL (Polygon), SOL (Solana), BNB (BNB Chain), AVAX (Avalanche). Stablecoin: USDC, USDT, EURC, PYUSD, USDG, RLUSD, USAT, OUSD. Reti: Bitcoin, Ethereum, Polygon, Solana, Base, Arbitrum, Avalanche, BNB Chain. Non tutti gli asset esistono su ogni rete, e alcune coppie sono tracciate mentre altre sono solo codici QR diretti: la pagina Asset supportati elenca ogni coppia.
Qual è la differenza tra un QR nativo e una sessione di pagamento?
Un QR nativo è una richiesta diretta da wallet a wallet. Funziona per le criptovalute che un wallet può inviare da un link standard: BTC, ETH, POL, SOL, BNB e AVAX, e per i token su Solana come USDC. Per un token su una rete di tipo Ethereum (ad esempio tutte le stablecoin presenti su queste reti), Toreador crea invece una sessione di pagamento: una pagina ospitata che prepara la chiamata al contratto da far firmare al wallet del pagatore e che segue le conferme in tempo reale. Può anche scegliere una sessione di pagamento per ETH, POL, SOL, BNB e AVAX. Bitcoin e i token su Solana funzionano solo in modalità diretta.
Come paga il mio cliente da questo codice QR?
Apre la sua app wallet (MetaMask, Trust Wallet, Phantom, Coinbase Wallet, ecc.), tocca Scansiona, inquadra il codice QR e conferma la transazione precompilata. L'importo, il token e l'indirizzo del destinatario sono già impostati — deve solo firmare.
Posso ricevere USDT o USDC tramite codice QR?
Sì. Su Solana, USDC è un codice QR nativo Solana Pay: va da wallet a wallet e non è tracciato. Su Ethereum, Polygon, Base, Arbitrum, Avalanche e BNB Chain per USDC, e su Ethereum, Polygon, Base, Arbitrum, Avalanche e BNB Chain per USDT, viene creata una sessione di pagamento — il Suo cliente la apre e connette il proprio wallet per inviare il trasferimento, e Lei segue la conferma.
Serve un account per generare un codice QR?
Non per il generatore web: è aperto a tutti, con una piccola quota giornaliera per visitatore. L'API REST, l'SDK e il server MCP richiedono sempre una chiave API, inclusa in ogni piano, anche in quello gratuito — una chiave tor_test_ per l'ambiente di prova su testnet, una chiave tor_live_ per la rete principale (mainnet). Accedendo, si sbloccano anche la cronologia dei pagamenti, i pagamenti tracciati e i webhook; il limite di richieste al minuto e la quota mensile dipendono dal Suo piano.
Condividere il codice QR è sicuro?
Sì. Un codice QR contiene solo l'indirizzo pubblico del Suo wallet e l'importo richiesto — le stesse informazioni di un normale link di pagamento. Nessuno può svuotare i Suoi fondi a partire da un codice QR; solo le transazioni firmate spostano denaro su una blockchain.
Posso usare Toreador per i pagamenti in negozio?
Sì — è uno degli usi principali. Stampi o mostri il codice QR, il cliente lo scansiona dal proprio wallet e il pagamento arriva direttamente nel Suo wallet. Per gli esercenti fisici, il flusso della sessione di pagamento mostra in tempo reale lo stato di conferma sulla blockchain, così Lei può decidere quando consegnare la merce.
Posso integrare Toreador nella mia app o nel mio sito web?
Sì, con ogni piano. Utilizzi direttamente l'API REST oppure installi l'SDK TypeScript ufficiale. I webhook avvisano il Suo backend quando una sessione di pagamento passa a completed, expired o failed. I piani si differenziano per il limite di richieste al minuto e per la quota mensile di pagamenti tracciati.
Cosa succede se il mio cliente paga un importo sbagliato?
La blockchain accetta qualsiasi importo inviato al Suo indirizzo — Toreador non può imporre l'importo richiesto sulla rete stessa. Il flusso della sessione traccia l'importo reale sulla blockchain, così la Sua dashboard mostra ciò che è stato davvero inviato. Per gli esercenti fisici, verifichi bene prima di consegnare la merce.
Sono supportati i token di testnet o dell'ambiente di prova?
Sì. Generi una chiave tor_test_ nella Sua dashboard: tutti gli endpoint funzionano allora sulle reti di test (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet), fuori da qualsiasi quota, con token di test ottenuti dai faucet pubblici.
Dove posso vedere la cronologia dei miei pagamenti?
Nella Sua dashboard, la scheda Cronologia elenca tutti i codici QR generati e tutte le sessioni di pagamento del Suo account. L'API espone questi dati anche tramite gli endpoint /history e /sessions.
Gli assistenti di IA come Claude o ChatGPT possono generare codici QR tramite Toreador?
Sì. Toreador pubblica un server ufficiale Model Context Protocol (MCP), @toreador/mcp-server. Lo aggiunga a Claude Desktop o a qualsiasi assistente compatibile con MCP e formuli la richiesta in linguaggio naturale — ad esempio «Mi serve un codice QR Bitcoin di 0.001 BTC verso bc1q...». Ogni strumento richiede una chiave API (piano gratuito incluso): una chiave di test per l'ambiente di prova, una chiave di produzione per la rete principale (mainnet). Guida all'installazione completa ed elenco degli strumenti su https://toreador.io/mcp.