Documentazione di Pay by QR

Pay by QR sceglie il codice in base alla valuta della fattura e al tuo conto. Le fatture in euro ricevono il QR code SEPA (EPC), con la comunicazione strutturata per i conti belgi. Le fatture in franchi, e quelle in euro su un conto svizzero o del Liechtenstein, ricevono la QR-fattura svizzera. Le fatture in corone ceche ricevono QR Platba, quelle in rupie UPI. Tutte le altre valute ricevono un QR code che apre la fattura online, se la fattura consente un gateway di pagamento online attivo.

Pay by QR non stampa il codice quando la fattura non si può pagare con quel codice. Di solito dipende da uno di questi motivi. L'interruttore principale "Stampa il codice QR di pagamento sulle fatture" è spento, come dopo l'installazione. La fattura è pagata, annullata o in bozza, oppure non resta nulla da pagare. Hai limitato il codice a un metodo di pagamento con "Mostra solo se questo metodo di pagamento è consentito per la fattura" e questa fattura non lo consente. I tuoi IBAN sono nei metodi di pagamento di Perfex, ma nessuno di quelli consentiti su questa fattura in euro o in corone ne contiene uno, quindi niente codice SEPA o QR Platba. Mancano i dati bancari per quella valuta o non sono validi: al salvataggio la pagina delle impostazioni elenca cosa correggere. La valuta non ha uno standard di QR bancario, o il codice bancario non si può generare, e la fattura non consente alcun gateway online attivo per il QR con link. Il riquadro di stato nelle impostazioni mostra quali gateway sono attivi.

Sì, Pay by QR usa sempre l'importo residuo e non il totale originale. Se il tuo cliente ha pagato 300 € su 1.000 €, la scansione successiva chiede 700 €, con il numero di fattura come causale.

Con il bonifico no: Pay by QR non legge il tuo conto bancario, quindi un bonifico o un pagamento UPI lo registri in Perfex come sempre, con il pulsante "Pagamento" sulla fattura. Cambia quello che arriva: l'importo giusto con il numero di fattura nella causale, e abbinarlo diventa facile. Se il cliente paga tramite il QR con link con un gateway online come PayPal Smart Checkout, Perfex registra il pagamento da solo e aggiorna lo stato della fattura.

Pay by QR genera ogni codice secondo lo standard pubblicato del suo Paese: EPC069-12 per SEPA, le direttive SIX 2.4 per la QR-fattura svizzera, lo standard dell'Associazione bancaria ceca per QR Platba e la specifica di collegamento UPI per l'India. Ho scansionato una mia fattura con l'app di una banca tedesca (comdirect): importo e causale erano corretti. I codici svizzeri e cechi sono stati verificati anche con validatori indipendenti, i dati EPC con strumenti indipendenti. Con le app delle banche italiane non l'ho provato: per questo nelle impostazioni c'è una scansione di prova per la tua app, e nella demo trovi fatture in euro da inquadrare.

Pay by QR inserisce nel codice EPC l'intestatario che indichi, e da ottobre 2025 le banche dell'area euro confrontano quel nome con l'IBAN (verifica del beneficiario). Scrivilo esattamente come risulta alla tua banca, di solito la ragione sociale. Con un nome commerciale l'avviso compare anche se l'IBAN è giusto.

No, Pay by QR non sostituisce i QR code fiscali. Stampa QR code di pagamento, che dicono all'app della banca chi pagare e quanto. I QR code fiscali obbligatori, come ATCUD in Portogallo, VERI*FACTU in Spagna, l'IRN della fattura elettronica indiana o ZATCA in Arabia Saudita, li genera il tuo software di fatturazione certificato o l'autorità fiscale.

Pay by QR mostra il QR con link quando la fattura consente un gateway di pagamento online attivo. Per PayPal Smart Checkout vai in Impostazioni > Impostazioni > Finanza > Portali di Pagamento (nell'interfaccia inglese: Setup > Settings > Finance > Payment Gateways) e apri la scheda "Paypal Smart Checkout". Metti "Attivo" su Sì e inserisci Client ID e Secret della tua app PayPal. Metti "Abilita Modalità Test" su No, altrimenti i pagamenti finiscono nella sandbox di PayPal. Aggiungi la valuta delle tue fatture in "Virgola Separazione Valuta" (predefinito USD,CAD,EUR), perché Perfex offre il gateway solo in quelle valute. "Seleziona l'impostazione predefinita sulla fattura" vale solo per le fatture nuove: in quelle esistenti aggiungi PayPal in "Metodi di pagamenti abilitati per questa fattura". L'opzione del QR con link in Pay by QR è già attiva. Con altri gateway di Perfex, come Stripe Checkout, funziona allo stesso modo.

Sì, Pay by QR mette un QR code UPI su ogni fattura in INR non pagata, generato secondo la specifica di collegamento UPI per app come Google Pay, PhonePe, Paytm e BHIM, con ID UPI, importo residuo e numero di fattura. L'app mostra il nome registrato presso la tua banca. Il codice non è firmato da un fornitore di pagamenti (può farlo solo una banca acquirer), quindi alcune app possono mostrare "non verificato". Inoltre non l'ho ancora provato con un'app UPI in India. Puoi verificarlo tu il primo giorno: dopo aver salvato ID UPI e nome del beneficiario, la scansione di prova mostra un codice da ₹1,00 con riferimento TEST-0001. Inquadralo con la tua app UPI senza confermare il pagamento. Se non funziona, ti rimborso entro 14 giorni, per qualsiasi motivo.

Sì, Pay by QR può aggiungere al codice UPI GSTIN, numero e data della fattura e la ripartizione CGST/SGST/IGST/cess presa dalle imposte della fattura. Con questi dati il codice diventa più denso e viene stampato a 45 mm. Se questo soddisfi i requisiti del QR dinamico per la tua azienda, chiedilo al tuo consulente fiscale. Il modulo non genera il QR della fattura elettronica (IRN).

No, Pay by QR non tocca il tuo modello di fattura né i file del core di Perfex. Aggiunge il blocco di pagamento con gli hook standard: dopo il contenuto, prima della nota per il cliente o in fondo all'ultima pagina. Se la creazione del QR code non riesce, il PDF della fattura viene creato comunque, solo senza il blocco.

Sì, puoi provare Pay by QR nella demo: da Vendite > Fatture (nella demo in inglese: Sales > Invoices) apri una fattura in euro non pagata e il suo PDF, poi inquadra il codice sullo schermo con l'app della tua banca sul telefono. Il beneficiario è un IBAN di esempio pubblico, quindi l'app ti mostra solo il bonifico compilato, che chiudi senza inviarlo. Dopo l'acquisto hai 14 giorni per riavere i tuoi soldi, per qualsiasi motivo.

No, una licenza di Pay by QR vale per un'installazione di Perfex CRM ed è legata a un dominio. Ogni installazione in più, per esempio presso un altro cliente, richiede una licenza propria.

Pay by QR è pensato per Perfex CRM 3.x e verificato su Perfex CRM 3.4.0, che a sua volta richiede PHP 8.1 o superiore.