Generatore di codici QR UPI
Crea un codice QR di pagamento UPI usando campi strutturati tra cui UPI ID/VPA, nome del beneficiario, importo e riferimento della transazione.
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 UPI
Risposta rapida: Un codice QR UPI codifica una richiesta di pagamento usando lo schema URI upi:// definito dalla National Payments Corporation of India (NPCI). Il campo obbligatorio è il VPA del beneficiario — la Virtual Payment Address, ad esempio name@upi. Omettendo l’importo, il pagatore può inserire il valore.
Come creare un codice QR UPI
- Inserisci il VPA del beneficiario — la Virtual Payment Address nel formato name@bankhandle, ad esempio merchant@okaxis o freelancer@ybl.
- Inserisci il nome del beneficiario come deve apparire nella cronologia delle transazioni del mittente.
- Inserisci un importo fisso in INR se vuoi precompilare il valore del pagamento, oppure lascia il campo vuoto per consentire al pagatore di digitare l’importo nella propria app UPI.
- Aggiungi una nota di transazione (campo tn) fino a 50 caratteri se il pagamento richiede una descrizione visibile al pagatore.
- Aggiungi un riferimento di transazione (campo tr) se il tuo sistema usa ID di riferimento per la riconciliazione.
- Scansiona il codice generato con un’app UPI sul tuo dispositivo per confermare che VPA e importo siano corretti 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 costruito nel browser. Nulla di ciò che inserisci viene caricato.
Che cos’è un codice QR UPI
Un codice QR UPI è un codice QR standard il cui payload è un URI di pagamento che segue lo schema upi:// definito dalla National Payments Corporation of India (NPCI). Il simbolo QR segue ISO/IEC 18004:2015, lo standard internazionale per la simbologia QR Code. Il livello payload UPI è specificato nel NPCI UPI Product Overview and BHIM Brand Guidelines.
UPI — Unified Payments Interface — è il sistema indiano di pagamenti interbancari in tempo reale. Un pagamento UPI sposta fondi direttamente da un conto bancario a un altro attraverso la NPCI rete. Qualsiasi app abilitata UPI, incluse Google Pay, PhonePe, Paytm e BHIM, può scansionare il codice QR e avviare un pagamento.
Un codice QR UPI non è un numero di conto bancario, un numero di carta o un wallet. Il VPA — Virtual Payment Address — funziona come proxy che viene risolto sul conto bancario collegato al momento del pagamento. Il pagatore non vede mai il numero di conto.
Sintassi del payload UPI e riferimento dei campi
Struttura URI
Il formato completo dell’URI di pagamento UPI, secondo la NPCI specifica, è:
upi://pay?pa=<VPA>&pn=<name>&am=<amount>&cu=INR&tn=<note>&tr=<reference>Tutti i valori dei campi devono essere percent-encoded secondo RFC 3986. Gli spazi diventano %20. La query string separata da e commerciali compone la richiesta di pagamento completa.
| Parametro | Nome del campo | Obbligatorio | Formato e vincoli |
|---|---|---|---|
| pa | Indirizzo del beneficiario (VPA) | Sì | name@bankhandle — la Virtual Payment Address |
| pn | Nome del beneficiario | Sì (UPI 2.0) | Nome visualizzato del beneficiario codificato per URL |
| am | Importo | No (QR statico) | Decimale in INR, due cifre decimali, ad es. 50.00 |
| cu | Valuta | Obbligatorio se am è presente | Sempre INR — nessun’altra valuta è valida per UPI |
| tn | Nota di transazione | No, il collegamento richiede internet | Nota leggibile, massimo 50 caratteri |
| tr | Riferimento della transazione | No, il collegamento richiede internet | ID di riferimento alfanumerico per la riconciliazione |
| mc | Codice categoria merceologica | No, il collegamento richiede internet | Codice ISO 18245 a quattro cifre per transazioni merchant |
UPI 2.0, rilasciato da NPCI nell’agosto 2018, ha aggiunto un parametro sign per codici QR merchant firmati RSA. Questa firma viene generata dal fornitore di servizi di pagamento del merchant e non può essere creata da un generatore URI manuale.
Formato VPA
Un VPA (Virtual Payment Address) segue il formato handle@bankname. bankname è un suffisso registrato di fornitore di servizi di pagamento UPI assegnato da NPCI. I suffissi comuni includono:
| Suffisso | Fornitore di servizi di pagamento o banca associata |
|---|---|
| @okaxis | Axis Bank tramite Google Pay |
| @ybl | Yes Bank tramite PhonePe |
| @paytm | Paytm Payments Bank |
| @upi | BHIM e VPA bancari diretti |
| @oksbi | State Bank of India tramite Google Pay |
Un VPA è univoco per la persona o azienda registrata presso il provider UPI. Inserire un VPA inesistente genera un codice QR dall’aspetto valido che la rete UPI rifiuterà al momento del pagamento. Verifica che il VPA venga risolto correttamente scansionando il codice con un’app UPI prima di stampare.
Codici QR UPI statici vs dinamici
| Caratteristica | QR UPI statico | QR UPI dinamico |
|---|---|---|
| Importo | Importo fisso o aperto | Fisso per transazione |
| Riutilizzabile | Sì | Un utilizzo per codice (generato da PSP) |
| Creato da | Qualsiasi generatore URI | Piattaforma del fornitore di servizi di pagamento |
| Adatto a | Negozi, contenitori per mance, freelance | Transazioni merchant di valore elevato |
| Riconciliazione | Manuale o tramite campo tr | Automatica tramite ID transazione PSP |
Un QR UPI statico senza importo fisso è il formato più comune per piccoli commercianti e freelance. È riutilizzabile, stampabile e scansionabile da qualsiasi app UPI. Un QR UPI dinamico viene generato dalla piattaforma di un fornitore di servizi di pagamento per ogni transazione e in genere contiene un ID transazione univoco collegato al backend del PSP.
Quando usare un codice QR UPI
Piccoli negozi e venditori ambulanti. Un QR statico stampato al bancone consente ai clienti di pagare l’importo dovuto inserendolo nell’app UPI. Nessun lettore di carte necessario.
Freelance e fornitori di servizi. Un codice QR su una fattura o un preventivo consente ai clienti di avviare un pagamento UPI direttamente al VPA del freelance senza richiamare manualmente il contatto.
Contenitori per mance e punti di donazione. Un QR statico a importo aperto permette ai donatori di scegliere la propria somma. Il nome del beneficiario e la nota di transazione rendono il pagamento identificabile nell’estratto.
Riscossione di affitti e spese condivise. Un codice QR inviato in chat o affisso su una bacheca consente a coinquilini o partecipanti di pagare la propria quota senza dati di bonifico bancario.
Lavoratori da remoto e sul campo. Un codice QR su una card stampata o un badge consente la ricezione immediata del pagamento in luoghi con Internet ma senza terminale POS.
Requisiti di progettazione e stampa
Mantieni una quiet zone di quattro moduli su tutti i lati. ISO/IEC 18004:2015 La sezione 6.3.3 specifica questo minimo e le app scanner UPI ne hanno bisogno per un rilevamento affidabile.
Stampa almeno a 5 cm per 5 cm i codici UPI con payload dinamico completo al punto vendita. Questa misura è citata dalle linee guida di settore per l’esposizione dei QR UPI ai banconi merchant. Un codice QR con solo un VPA e nessun campo opzionale ha un payload minore e può essere stampato a 2 cm, ma 5 cm è il minimo sicuro per un’esposizione merchant pubblica.
Usa moduli scuri su sfondo chiaro. Un forte contrasto è particolarmente importante negli ambienti con molta luce ambientale in cui i codici UPI vengono tipicamente scansionati, come bancarelle all’aperto e banconi dei negozi.
Un codice UPI con tutti i campi opzionali — nome del beneficiario, importo, nota, riferimento e codice categoria merchant — produce un URI più lungo e un simbolo QR più denso. A dimensione di stampa fissa, più dati significano moduli più piccoli. Se usi tutti i campi, stampa più grande anziché più stretto.
Usa il livello di correzione errori M come base. Il livello M recupera circa il 15 per cento delle codeword danneggiate ed è una buona impostazione predefinita per un QR merchant che può essere maneggiato e mostrato in condizioni variabili.
Risoluzione dei problemi: perché il tuo codice QR UPI non funziona
Il VPA non esiste o è stato digitato male. La rete UPI rifiuta pagamenti verso un VPA non registrato. Scansiona il codice con un’app UPI e conferma che l’app mostri il nome corretto del beneficiario registrato prima di considerare il codice pronto.
Il campo importo usa virgole invece del punto decimale. Gli importi UPI devono essere formattati come numero decimale con punto: 1000.00, non 1,000.00. Una virgola nel campo am può essere rifiutata da alcune app UPI.
Il campo valuta manca o è errato. cu=INR è obbligatorio ogni volta che è presente il campo am. Ometterlo o usare qualsiasi altro codice valuta è fuori dalla NPCI specifica UPI e causerà errori in alcune app.
La nota di transazione supera 50 caratteri. Il campo tn ha un massimo di 50 caratteri secondo la NPCI specifica. Riduci la nota a 50 caratteri o meno.
Il codice è troppo piccolo per essere scansionato al bancone. Un payload UPI denso sotto i 3 cm fallirà a intermittenza con scarsa illuminazione o con una fotocamera di bassa qualità. Stampa a 5 cm o più per qualsiasi esposizione merchant pubblica.
Il nome del beneficiario contiene caratteri speciali. Tutti i valori dei campi devono essere percent-encoded. Se il nome contiene una e commerciale, un segno di uguale o un altro carattere riservato, deve essere codificato come %26, %3D e così via. Questo generatore gestisce automaticamente la codifica; se costruisci l’URI manualmente, codifica con attenzione.
UPI rispetto ad altri sistemi QR di pagamento
| Caratteristica | QR UPI (India) | QR EPC (Europa/SEPA) | QR PIX (Brasile) |
|---|---|---|---|
| Organismo di governo | NPCI | European Payments Council | Banco Central do Brasil |
| Valuta | Solo INR | Solo EUR | BRL |
| Standard | URI upi://, NPCI specifica | EPC069-12 v3.1 | EMVCo MPM, BCB BR Code Manual |
| Campo minimo richiesto | VPA del beneficiario (pa) | Nome del beneficiario e IBAN | Chiave PIX nell’account merchant |
| Importo richiesto | No, il collegamento richiede internet | No, il collegamento richiede internet | No (statico a importo aperto) |
Ogni sistema è specifico della propria rete di pagamento e giurisdizione. Un QR UPI funziona solo con app abilitate UPI e solo per transazioni INR attraverso la NPCI rete.
Cosa offre questo Generatore di codici QR UPI
Questo strumento basato sul browser crea una richiesta di pagamento in stile NPCI tramite upi:// contenente VPA, nome del beneficiario e importo o nota opzionali. È pensato per pagamenti di merchant indiani, fatture, richieste remote e riscossioni a importo fisso. L’anteprima live si aggiorna durante la modifica, rendendo più facile individuare un campo mancante o un simbolo insolitamente 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 non devono essere caricate per creare l’immagine QR. Conferma il VPA e il beneficiario visualizzato nell’app di pagamento prima dell’approvazione; l’immagine QR da sola non convalida la titolarità del conto.
Utilizzare questo codice QR in Bahrein e all’estero
UPI è un sistema di pagamento indiano, non una rete di pagamento domestica del Bahrain. In Bahrain è utile solo quando pagatore e beneficiario previsti dispongono di accesso UPI 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.
01Qual è il formato di un codice QR UPI?+
Il formato è upi://pay?pa=<VPA>&pn=<name>&am=<amount>&cu=INR&tn=<note>&tr=<reference>. Il campo pa (VPA del beneficiario) è obbligatorio. Il campo am è opzionale per i codici QR statici: ometterlo consente al pagatore di inserire l’importo nell’app UPI. Tutti i valori devono essere percent-encoded secondo RFC 3986. Questo formato è definito da NPCI, la National Payments Corporation of India.
02Che cos’è un VPA in un codice QR UPI?+
Un VPA — Virtual Payment Address — è l’equivalente UPI di un nome utente per i pagamenti. Segue il formato name@bankhandle, ad esempio merchant@okaxis o freelancer@ybl. Il VPA viene risolto su un conto bancario collegato tramite la rete NPCI. Il pagatore non vede mai il numero di conto effettivo quando usa un VPA.
03Posso creare un codice QR UPI senza importo fisso?+
Sì. Ometti i parametri am e cu dall’URI. Il codice QR aprirà la schermata di pagamento nell’app UPI del pagatore con il nome del beneficiario precompilato, e il pagatore inserirà manualmente l’importo. Questo è il formato più comune per i QR dei piccoli commercianti esposti al bancone.
04Un codice QR UPI funziona con Google Pay, PhonePe e Paytm?+
Sì. Qualsiasi app che supporti lo standard UPI di NPCI può scansionare un codice QR UPI. Google Pay, PhonePe, Paytm, BHIM e tutte le altre app UPI certificate NPCI sono compatibili con il formato URI upi://.
05Qual è la differenza tra un codice QR UPI statico e dinamico?+
Un QR UPI statico codifica direttamente il VPA e un importo fisso opzionale. È riutilizzabile e può essere creato senza un fornitore di servizi di pagamento. Un QR UPI dinamico viene generato da una piattaforma PSP per una specifica transazione e contiene un ID transazione univoco. I codici dinamici supportano la riconciliazione automatizzata e sono in genere usati da merchant registrati per transazioni di valore maggiore.
06Un VPA UPI personale è lo stesso di un account UPI merchant?+
No. Un VPA personale è collegato a un conto bancario individuale ed è adatto ai pagamenti peer-to-peer. Le regole NPCI e bancarie disciplinano separatamente gli account di incasso merchant. Se raccogli pagamenti per un’attività su larga scala, contatta la tua banca o un fornitore di servizi di pagamento certificato UPI per un account merchant e i relativi requisiti di conformità. Un VPA personale non sostituisce un account merchant.
07Qual è la dimensione minima di stampa per un codice QR UPI?+
Le linee guida di settore per i codici QR UPI merchant indicano un minimo di 5 cm per 5 cm per un payload dinamico completo esposto a un bancone point-of-sale. Un codice con solo VPA e nessun campo opzionale può essere stampato a 2 cm per scansioni ravvicinate, ma 5 cm è lo standard sicuro per un’esposizione merchant pubblica.
08Come aggiungo una nota di transazione a un codice QR UPI?+
Aggiungi il parametro tn all’URI: tn=Payment%20for%20order%20123. Il valore deve essere URL-encoded e non superare 50 caratteri secondo la specifica NPCI. La nota appare nella cronologia delle transazioni del pagatore e aiuta entrambe le parti a identificare il pagamento.
09Perché il mio codice QR UPI viene scansionato ma il nome del beneficiario è errato?+
Il parametro pn è un’indicazione visuale mostrata nell’app del pagatore prima della conferma. Il nome reale del beneficiario registrato presso il provider UPI può differire se il campo pn è stato digitato male. Il VPA (campo pa) determina chi riceve i fondi. Verifica che il VPA si risolva sul nome registrato corretto scansionando il codice con un’app UPI reale.
10Un codice QR UPI scade?+
Un codice QR UPI statico non scade. Il VPA è codificato direttamente nel pattern e il codice continua a funzionare finché il VPA resta attivo e collegato a un conto bancario. Se il VPA viene deregistrato o il conto viene chiuso, la rete UPI rifiuterà i pagamenti anche se il codice QR continua a essere scansionato.