Generatore di codici QR PIX
Genera un codice QR di pagamento PIX brasiliano statico usando campi BR Code strutturati e un checksum CRC16 calcolato.
Questo generatore mantiene l’URI GS1 Digital Link direttamente nel codice QR. I reindirizzamenti dinamici Premium QR non vengono usati per i codici GS1 Digital Link.
Personalizzazione avanzata
Colori e sfumature
Logo e icona social
Dimensione codice QR
Generatore di codici QR PIX
Risposta rapida: Un codice QR PIX — ufficialmente chiamato BR Code — segue il formato TLV EMVCo MPM specificato dal Banco Central do Brasil (BCB). Il payload termina con un checksum CRC-16/CCITT-FALSE obbligatorio. Le chiavi PIX possono essere un ID fiscale CPF/CNPJ, telefono, e-mail o UUID EVP casuale.
Come creare un codice QR PIX
- Inserisci la tua chiave PIX — l'identificatore collegato al conto bancario ricevente. Può essere un CPF, CNPJ, numero di cellulare brasiliano nel formato +5511999999999, indirizzo e-mail o UUID EVP casuale assegnato dal tuo prestatore di servizi di pagamento.
- Inserisci il nome del commerciante in caratteri ASCII maiuscoli, massimo 25 caratteri, senza accenti o caratteri speciali.
- Inserisci la città del commerciante in caratteri ASCII maiuscoli, massimo 15 caratteri.
- Inserisci un importo fisso se il pagamento ha un valore noto, oppure lascialo vuoto per un QR statico a importo aperto che il pagatore compilerà.
- Inserisci un ID transazione (TXID) se devi riconciliare il pagamento. Per un QR statico a importo aperto, usa tre asterischi (***) come segnaposto TXID.
- Verifica il codice generato scansionandolo con un'app bancaria abilitata PIX prima del download.
- Personalizza il motivo, lo stile degli occhi, i colori e il logo se necessario, quindi esporta in PNG, SVG, WEBP o JPG fino a 4096 px.
Il codice QR viene generato nel browser. Nulla di ciò che inserisci viene inviato a un server.
Che cos'è un codice QR PIX
Un codice QR PIX — indicato nella specifica ufficiale come BR Code — è un payload di avvio del pagamento codificato come codice QR. Segue lo EMVCo standard QRCPS-MPM (Merchant Presented Mode), implementato in Brasile dal Banco Central do Brasil (BCB) nel BR Code Manual, versione 2.0, datato maggio 2020.
PIX è il sistema di pagamenti istantanei del Brasile, gestito e regolamentato dal Banco Central do Brasil. Tutte le istituzioni finanziarie brasiliane autorizzate devono supportare PIX. I pagamenti vengono regolati in tempo reale, 24 ore su 24, inclusi fine settimana e festivi. Il sistema è obbligatorio — non volontario — per le istituzioni sopra una determinata soglia dimensionale.
Un codice QR PIX non è un numero di conto bancario. Contiene una chiave PIX, cioè un alias collegato al conto. L'infrastruttura PIX del BCB risolve la chiave nei dati reali del conto al momento del pagamento. Il pagatore non vede mai il numero di conto.
Un codice QR PIX statico è riutilizzabile. Un codice QR PIX dinamico (formato COB o COBV) viene generato da un prestatore di servizi di pagamento (PSP) per una transazione specifica e contiene una URL che l'app del pagatore risolve in tempo reale. Questo generatore crea codici QR statici. I codici dinamici richiedono una PSP API.
Struttura tecnica del PIX BR Code
EMVCo Formato TLV
Il payload PIX usa la codifica EMVCo Tag-Length-Value (TLV). Ogni campo è rappresentato da un ID tag a due cifre, seguito dalla lunghezza del campo a due cifre e dal contenuto. I campi sono concatenati senza separatori.
| Tag | Campo | Contenuto di esempio | Note |
|---|---|---|---|
| 00 | Indicatore del formato payload | 01 | Sempre "01" — obbligatorio |
| 01 | Metodo di avvio al punto vendita | 11 | 11 = statico/riutilizzabile; 12 = dinamico monouso |
| 26 | Informazioni conto commerciante (PIX) | (sottomodello — vedi sotto) | Contiene la GUI PIX e la chiave PIX |
| 52 | Codice categoria commerciante | 0000 | 0000 per uso generale; si applicano i codici ISO 18245 |
| 53 | Valuta della transazione | 986 | 986 = BRL secondo ISO 4217 |
| 54 | Importo della transazione | 123.45 | Formato decimale; ometti per importo aperto |
| 58 | Codice paese | BR | Sempre "BR" per PIX |
| 59 | Nome esercente | JOAO SILVA | Massimo 25 caratteri ASCII, maiuscoli, senza accenti |
| 60 | Città esercente | SAO PAULO | Massimo 15 caratteri ASCII, maiuscoli, senza accenti |
| 62 | Modello campo dati aggiuntivi | (sottomodello — vedi sotto) | Contiene il TXID |
| 63 | Checksum CRC-16 | Esadecimale maiuscolo di 4 caratteri | CRC-16/CCITT-FALSE, obbligatorio, sempre ultimo |
Informazioni conto commerciante (sottomodello tag 26)
Il tag 26 contiene una struttura TLV annidata per PIX:
| Sottotag | Contenuto |
|---|---|
| 00 | BR.GOV.BCB.PIX — la GUI PIX, sempre fissa |
| 01 | Il valore della chiave PIX |
La GUI PIX (Globally Unique Identifier) BR.GOV.BCB.PIX è una stringa fissa specificata dal BCB. Identifica il dominio di pagamento come PIX all'interno del EMVCo framework.
Tipi di chiave PIX
Una chiave PIX è un alias registrato che viene risolto in un conto bancario tramite BCB DICT (directory di conti transazionali e pagamenti). Esistono quattro tipi di chiave:
| Tipo di chiave | Esempio di formato | Note |
|---|---|---|
| CPF | 12345678901 (11 cifre) | ID fiscale individuale brasiliano |
| CNPJ | 12345678000195 (14 cifre) | ID fiscale di persona giuridica brasiliana |
| Telefono | +5511999999999 | Numero mobile brasiliano in formato E.164 |
| [email protected] | Indirizzo e-mail registrato | |
| EVP (casuale) | UUID v4, ad es. 123e4567-e89b-12d3-a456-… | Chiave generata casualmente dal PSP — nessun dato personale |
Una chiave EVP (Endereço Virtual de Pagamento) è un UUID casuale assegnato dal prestatore di servizi di pagamento. Non contiene informazioni personali identificabili ed è un'opzione rispettosa della privacy per chi non vuole pubblicare CPF, telefono o e-mail in un codice QR pubblico.
Checksum CRC-16
L'ultimo campo di ogni payload PIX BR Code è il tag 63, un checksum CRC-16 esadecimale obbligatorio di quattro caratteri maiuscoli. L'algoritmo è CRC-16/CCITT-FALSE con polinomio 0x1021 e valore iniziale 0xFFFF.
Il checksum è calcolato sull'intera stringa del payload fino a includere tag e lunghezza del campo 63 stesso (cioè la stringa che termina in "6304" è inclusa nel calcolo prima di aggiungere il risultato di quattro caratteri). Un payload con CRC-16 errato o mancante verrà rifiutato dalle app bancarie abilitate PIX.
Questo generatore calcola e aggiunge automaticamente il checksum CRC-16 corretto. Se costruisci manualmente il payload, il checksum deve essere ricalcolato ogni volta che cambia un campo.
Campo dati aggiuntivi (sottomodello tag 62)
Il tag 62 contiene un sottomodello annidato per l'identificazione della transazione:
| Sottotag | Contenuto | Note |
|---|---|---|
| 05 | TXID | Da 26 a 35 caratteri alfanumerici; usa *** per importo aperto |
Il TXID collega il pagamento a una transazione specifica nel sistema del commerciante. Per un QR statico a importo aperto, la specifica BCB consente tre asterischi (***) come segnaposto TXID.
Codici QR PIX statici e dinamici
| Caratteristica | QR PIX statico (BR Code) | QR PIX dinamico (COB/COBV) |
|---|---|---|
| Importo | Importo fisso o aperto | Fisso per transazione |
| Riutilizzabile | Sì | Un utilizzo per codice |
| Creato da | Qualsiasi generatore BR Code | API PSP, secondo la specifica BCB COB/COBV |
| Contenuto del payload | Dati completi del pagamento nel QR | URL risolta in tempo reale dall'app bancaria del pagatore |
| Riconciliazione automatizzata | Tramite TXID se specificato | Automatica tramite riferimento transazione PSP |
| Adatto a | Piccoli commercianti, privati | E-commerce, fatturazione, pagamenti ricorrenti |
I codici QR PIX dinamici (formato COB per importo aperto, COBV per importo fisso) richiedono un'integrazione API PSP. Il BCB pubblica la specifica tecnica COB/COBV separatamente dal BR Code Manual statico. Questo generatore produce solo codici statici.
Quando usare un codice QR PIX
Piccoli commercianti e bancarelle. Un QR statico a importo aperto stampato su una bancarella o un banco permette ai clienti di inserire l'importo dovuto e pagare immediatamente da qualsiasi app bancaria. Nessun lettore di carte necessario.
Professionisti dei servizi. Un codice QR stampato su una fattura o un biglietto da visita consente ai clienti di pagare tramite PIX senza conoscere i dati bancari del fornitore — serve solo la chiave PIX.
Freelance e venditori privati. Un codice QR con chiave EVP in un annuncio marketplace o profilo social permette agli acquirenti di pagare senza che il venditore pubblichi codice fiscale personale o numero di telefono.
Organizzazioni non profit e comunitarie. Un codice QR a importo aperto stampato sui materiali per donazioni permette ai sostenitori di inviare qualsiasi importo tramite PIX.
Eventi e sedi temporanee. Un codice QR su un badge o una tessera stampata consente di ricevere pagamenti istantanei senza contanti o terminale POS.
Requisiti di progettazione e stampa
Mantieni una quiet zone di quattro moduli su tutti i lati, come specificato nella ISO/IEC 18004:2015 sezione 6.3.3.
Stampa almeno a 2 cm per 2 cm per scansione ravvicinata. Per un espositore da banco letto in piedi, 5 cm o più è una guida di settore appropriata.
Usa moduli scuri su sfondo chiaro. Codici a colori invertiti e design a basso contrasto falliscono spesso sulle fotocamere dei telefoni con illuminazione esterna variabile.
Il payload PIX — inclusi GUI commerciante, chiave PIX, nome, città, TXID e CRC-16 — è una stringa moderatamente densa. Un codice statico con tutti i campi compilati produce un simbolo QR più complesso di un QR URL. Stampa più grande, non più piccolo.
Usa il livello di correzione errori M come base. Il livello M recupera circa il 15% delle codeword danneggiate. Se inserisci un logo, usa il livello H (circa 30% di recupero) e mantieni il logo entro il 30% dell'area del codice.
Risoluzione dei problemi: perché il tuo codice QR PIX non funziona
La chiave PIX non è registrata nel BCB DICT. Generare un codice QR con una chiave PIX non registrata produce un codice sintatticamente valido che l'app bancaria non può instradare. Verifica che la chiave sia attiva nelle impostazioni delle chiavi PIX della tua app bancaria prima di codificarla.
Il checksum CRC-16 è errato. Qualsiasi modifica a un campo dopo il calcolo invalida il checksum. Se hai modificato manualmente la stringa grezza del payload, ricalcola il checksum. Questo generatore lo calcola automaticamente.
Il nome del commerciante contiene caratteri non ASCII o accenti. Il BCB specifica che il campo Merchant Name (tag 59) deve essere in ASCII maiuscolo senza accenti. Sostituisci "João" con "JOAO" e "São Paulo" con "SAO PAULO".
Il nome o la città del commerciante supera il limite di caratteri. Il tag 59 (Merchant Name) ha un massimo di 25 caratteri. Il tag 60 (Merchant City) ha un massimo di 15 caratteri. Tronca per rientrare nei limiti.
Il TXID è vuoto o usa un formato non consentito. Per un QR statico a importo aperto, usa tre asterischi (***) come TXID. Per una transazione fissa, usa da 26 a 35 caratteri alfanumerici. Un TXID non valido fa rifiutare il payload ad alcune app bancarie.
L'app bancaria non è abilitata PIX. Tutte le istituzioni finanziarie brasiliane autorizzate sopra la soglia BCB devono supportare PIX. App di istituzioni sotto la soglia o banche non brasiliane non elaboreranno un pagamento PIX.
PIX rispetto ad altri standard QR di pagamento
| Caratteristica | PIX QR — BR Code (Brasile) | EPC QR — GiroCode (Europa/SEPA) | QR UPI (India) |
|---|---|---|---|
| Organismo di governo | Banco Central do Brasil | European Payments Council | NPCI |
| Standard | BCB BR Code Manual v2.0, EMVCo MPM | EPC069-12 v3.1 | NPCI Panoramica prodotto UPI |
| Valuta | BRL (codice ISO 4217 986) | Solo EUR | Solo INR |
| Formato payload | EMVCo TLV | Testo semplice di 12 righe | Stringa di query URI upi:// |
| Checksum obbligatorio | Sì — CRC-16/CCITT-FALSE | No, il collegamento richiede internet | No, il collegamento richiede internet |
| Requisito di correzione errori | Non specificato nella ricerca | Livello M obbligatorio (EPC069-12) | Non specificato nella ricerca |
Cosa offre questo generatore di codici QR PIX
Questo strumento nel browser crea un payload PIX BR Code brasiliano statico con dati del commerciante, importo facoltativo, riferimento e checksum. È progettato per richieste di pagamento istantaneo brasiliane, fatture, vendite a distanza e incassi in sede fissa. L'anteprima in tempo reale si aggiorna durante la modifica, facilitando l'individuazione di un campo mancante o di un simbolo inaspettatamente denso prima del download.
Puoi regolare i motivi della matrice, gli stili degli occhi di rilevamento, i colori di primo piano e sfondo, i gradienti, le cornici, la dimensione e un logo facoltativo. Le esportazioni sono disponibili in SVG, PNG, WEBP e JPG a 512, 1024, 2048 o 4096 pixel. SVG è la scelta pratica per la stampa professionale. Un PNG ad alta risoluzione è adatto a documenti d’ufficio e grafica digitale.
Il payload statico viene costruito nel browser. Le informazioni inserite nel generatore non devono essere caricate per creare l'immagine QR. Controlla la chiave PIX, il nome del commerciante, la città, l'importo e il destinatario mostrato dall'app bancaria prima di autorizzare un bonifico.
Utilizzare questo codice QR in Bahrein e all’estero
PIX è il sistema di pagamento istantaneo del Brasile e non è una rete nazionale del Bahrein. Usalo solo per un autentico conto brasiliano e un pagatore con accesso PIX compatibile.
Usa l’ortografia inglese britannica nei testi rivolti ai clienti quando corrisponde allo stile della tua organizzazione e fornisci una versione in arabo quando il pubblico se l’aspetta. Rendi evidente l’azione dopo la scansione. Una breve frase accanto al simbolo, come «Scansiona per salvare il contatto» o «Scansiona per aprire la posizione», dà fiducia prima di puntare la fotocamera.
Testa il design finale su dispositivi iPhone e Android attuali. Provalo di nuovo dopo la stampa sulla carta, sull’adesivo, sulla tessera, sul cartello o sul materiale di imballaggio reale. La forte luce esterna del Bahrein può mettere in evidenza riflessi e problemi di basso contrasto meno visibili sullo schermo. Per uso internazionale, verifica prefissi internazionali, valute, fusi orari, disponibilità regionale delle app e compatibilità delle reti di pagamento.
Prima di pubblicare
- Tipo corretto di payload QR
- Dati completi e verificati
- Zona di quiete di quattro moduli
- Forte contrasto del primo piano
- Ridimensionamento quadrato proporzionale
- Logo mantenuto entro limiti sicuri
- SVG o PNG ad alta risoluzione
- Test di scansione sul dispositivo alla dimensione finale
Domande frequenti
Apri una domanda per leggere una risposta tecnica concisa.
01Che cos'è un codice QR PIX?+
Un codice QR PIX — ufficialmente chiamato BR Code — codifica una richiesta di pagamento PIX usando il formato TLV EMVCo Merchant Presented Mode, come specificato dal Banco Central do Brasil nel BR Code Manual v2.0. Termina con un checksum CRC-16/CCITT-FALSE obbligatorio. Qualsiasi app bancaria abilitata PIX in Brasile può scansionare ed elaborare il pagamento.
02Quali tipi di chiave PIX posso usare in un codice QR?+
PIX supporta quattro tipi di chiave: CPF (ID fiscale personale di 11 cifre), CNPJ (ID fiscale di entità di 14 cifre), numero mobile brasiliano in formato E.164 (+5511999999999), indirizzo e-mail ed EVP — una chiave UUID casuale senza dati personali, assegnata dal prestatore di servizi di pagamento. La chiave EVP è l'opzione più rispettosa della privacy.
03Che cos'è il checksum CRC-16 in un codice QR PIX?+
Ogni payload PIX BR Code deve terminare con un checksum CRC-16 esadecimale di quattro caratteri maiuscoli nel campo tag 63. L'algoritmo è CRC-16/CCITT-FALSE, con polinomio 0x1021 e valore iniziale 0xFFFF. Il checksum è calcolato sull'intera stringa del payload, incluso il prefisso "6304" del campo checksum stesso. Le app bancarie rifiutano payload con checksum mancante o errato.
04Qual è la differenza tra un codice QR PIX statico e dinamico?+
Un QR PIX statico codifica direttamente tutti i dati di pagamento ed è riutilizzabile per più transazioni. Un QR PIX dinamico (formato COB/COBV) contiene una URL che l'app bancaria del pagatore risolve in tempo reale tramite il PSP. I codici dinamici sono monouso per transazione e richiedono una PSP API. Questo generatore crea solo codici statici.
05Posso generare un codice QR PIX senza importo fisso?+
Sì. Ometti il campo importo (tag 54). Il codice generato permette al pagatore di inserire qualsiasi importo nella propria app bancaria. Per un QR statico a importo aperto, usa tre asterischi (***) come TXID nel tag 62, sottotag 05, secondo la specifica BCB BR Code.
06Quali app possono scansionare un codice QR PIX?+
Qualsiasi app bancaria di un'istituzione finanziaria brasiliana abilitata PIX può scansionare un BR Code. Il Banco Central do Brasil ha reso obbligatoria la partecipazione a PIX per tutte le istituzioni autorizzate sopra una soglia definita. Tutte le principali banche retail e digitali brasiliane supportano la scansione PIX.
07Che cos'è una chiave EVP in un codice QR PIX?+
Una chiave EVP (Endereço Virtual de Pagamento) è un UUID generato casualmente e assegnato dal prestatore di servizi di pagamento. È collegata a un conto bancario tramite BCB DICT senza esporre CPF, telefono o e-mail del titolare. È il tipo di chiave PIX consigliato quando il codice QR verrà mostrato pubblicamente.
08Che cosa significa la stringa BR.GOV.BCB.PIX nel payload PIX?+
BR.GOV.BCB.PIX è il Globally Unique Identifier (GUI) dell'applicazione di pagamento PIX nel framework EMVCo. Appare come sottotag 00 nel modello Merchant Account Information (tag 26). Questa stringa fissa identifica il dominio di pagamento come PIX. Tutti i PIX BR Codes validi contengono questa stringa letterale.
09Qual è la lunghezza massima del nome del commerciante in un codice QR PIX?+
La specifica BCB BR Code limita il campo Merchant Name (tag 59) a 25 caratteri ASCII maiuscoli senza accenti. Il campo Merchant City (tag 60) è limitato a 15 caratteri ASCII. I nomi che superano questi limiti devono essere troncati. Caratteri speciali e diacritici non sono consentiti.
10Perché devo verificare il codice QR PIX prima di stamparlo?+
Generare un payload BR Code valido non conferma che la chiave PIX sia attiva o mappata correttamente nel BCB DICT. Una chiave non registrata o digitata male produce un codice che si scansiona correttamente ma fallisce al pagamento. Scansiona il codice con un'app bancaria abilitata PIX e conferma il nome del beneficiario mostrato prima di stampare in quantità.