1. Panoramica dei prodotti
Non c’è niente di più facile che twintare, ora anche per le fatture con Swiss QR Code.
Fattura TWINT consente ai tuoi clienti di pagare le QR‑-fatture in modo rapido, sicuro e semplice con l’app TWINT, sempre e ovunque. Attiva TWINT per le tue fatture con Swiss QR Code.
Per pagamenti più rapidi grazie all’app di pagamento più popolare della Svizzera con 6 milioni di utenti attivi.
Crea le QR-fatture come di consueto e inviale per posta o e-mail. Non sono necessarie modifiche.
Inoltre, puoi convertire la QR-fattura in un pulsante HTML o in un link di pagamento. Tutti i parametri della fattura vengono inseriti in un pulsante o un link. Le istruzioni dettagliate sono disponibili qui.
I clienti scansionano la fattura con TWINT, selezionano la data di esecuzione e confermano il pagamento. Alla data di esecuzione verrà effettuato il bonifico dell’importo della fattura sul conto bancario che hai impostato.
Importante: TWINT raccoglie gli importi delle fatture e trasferisce l’importo giornalmente come registrazione cumulativa netta (importo della fattura meno la commissione TWINT).
Contemporaneamente al bonifico sul tuo conto bancario puoi controllare la conferma di pagamento di tutte le fatture in 2 modi:
- TWINT Business Portal
- SFTP (file camt.054) su richiesta
All’occorrenza, puoi caricare i report nel tuo software di contabilità.
La commissione per ogni transazione eseguita è indicata nella nostra pagina dedicata ai prezzi.
La commissione TWINT viene detratta direttamente dall’importo della fattura al momento del pagamento.
TWINT può essere utilizzata solo per la riscossione di fatture con QR Swiss Code dopo che beni o servizi sono stati consegnati o erogati al consumatore. Trovi la procedura dettagliata qui.
Per segnalare ai clienti l’opzione di pagamento TWINT, la tua QR-fattura deve essere contrassegnata di conseguenza. Le istruzioni dettagliate sono disponibili nelle linee guida per il design.
2. Flusso di pagamento
Questo diagramma mostra il flusso di pagamento di una fattura TWINT attraverso tutte le parti coinvolte (clienti, rivenditori, scheme TWINT, acquirenti) e la sequenza temporale del trasferimento di denaro (processo t+2).

Il flusso di denaro avviene in 3 passaggi consecutivi:
- Dalla banca dei clienti al conto bancario scheme TWINT (giorno t)
- Dal conto bancario scheme TWINT al conto bancario acquirente TWINT (giorno t+1)
- Da conto bancario acquirente TWINT al conto bancario del rivenditore o CSP (giorno t+2)
L’accredito sul conto rivenditore avviene 2 giorni lavorativi dopo l’ordine di pagamento (t+2).
Passaggio 0: ricevimento della fattura e conferma del pagamento
- Il o la cliente riceve una fattura con Swiss QR Code, ad esempio da un rivenditore o da una società di servizi, per posta, e-mail o tramite un portale clienti digitale
- Il o la cliente scansiona il codice QR con l’app TWINT o seleziona il link di pagamento, seleziona la data di esecuzione e conferma il pagamento
Passaggio 1: esecuzione del pagamento nello scheme TWINT (giorno t)
- L’importo fluisce dalla banca del o della cliente al conto bancario scheme TWINT
- Il pagamento programmato viene eseguito nello scheme TWINT
Passaggio 2: pagamento e messa a disposizione dei dati (giorno t+1)
- L’importo fluisce dal conto bancario scheme TWINT al conto bancario acquirente TWINT
- Il pagamento viene eseguito e trasmesso alla banca di pagamento
- Viene generato e reso disponibile il file Camt.054 per il rivenditore o il CSP
Passaggio 3: accredito sul conto rivenditore (giorno t+2)
- Il bonifico bancario viene eseguito sul conto del rivenditore o del CSP
- Il rivenditore riceve l’accredito dell’importo della fattura (meno la commissione TWINT; netto) sul suo conto bancario
3. Integrazione tecnica
Per l’integrazione tecnica della funzione di pagamento TWINT sono disponibili due opzioni d’integrazione complementari. Entrambe le varianti si basano sui dati della QR-fattura svizzera e consentono di avviare in modo semplice e sicuro la procedura di pagamento tramite TWINT.
La prima opzione è la QR-fattura, che può essere integrata direttamente nei processi di fatturazione e pagamento esistenti. In alternativa, è possibile utilizzare un pulsante online che avvia il processo di pagamento direttamente da un’app, un portale, un’e-mail o un’altra applicazione tramite un link di pagamento TWINT (paylink).
I prossimi capitoli descrivono entrambe le varianti di integrazione, i loro requisiti tecnici e le specifiche rilevanti per l’implementazione produttiva.
Per fattura TWINT non è necessario adeguare o ampliare le fatture con Swiss QR Code. Gli emittenti delle fatture possono continuare a utilizzare i loro processi di fatturazione ed ERP esistenti senza variazioni.
L’implementazione tecnica si limita alla registrazione e all’attivazione dell’emittente della fattura per fattura TWINT. Nell’ambito dell’onboarding, TWINT memorizza i dati rilevanti del conto (IBAN o QR-IBAN). Dopo l’avvenuta attivazione, tutte le app TWINT possono riconoscere e pagare le fatture con Swiss QR Code esistenti.
A differenza della QR-fattura, l’integrazione del pulsante online richiede un’implementazione tecnica da parte dell’emittente della fattura. A partire dai dati della QR-fattura viene creato un link di pagamento TWINT, che viene integrato in e-mail, portali clienti o app tramite un pulsante o un link.
Il link di pagamento costituisce la base tecnica dell’integrazione. Il pulsante online rappresenta visivamente questo link di pagamento e consente all’utente di avviare il processo di pagamento nell’app TWINT.
Per avviare un pagamento TWINT viene utilizzato un link di pagamento che contiene tutte le informazioni rilevanti della fattura con Swiss QR Code e viene elaborato dall’app TWINT.
Struttura del link di pagamento
Il link di pagamento è strutturato come segue:
https://go.twint.ch/qrbill#< ENCODED_PAYLOAD >
Vale quanto segue:
- https://go.twint.ch/qrbill è l’URL di base
- < ENCODED_PAYLOAD > contiene i dati della QR-fattura
- il payload deve essere codificato in UTF-8 e URL
URL di base (statico)
L’URL di base è statico e non può essere modificato:
https://go.twint.ch/qrbill
Fuge da punto di partenza per l’elaborazione dei dati di fatturazione tramite l’app TWINT.
Payload (dinamico)
Il payload contiene i dati di una QR-fattura svizzera nel formato dello Swiss Payment Code (SPC) e viene allegato all’URL di base.
Il payload deve presentare le seguenti caratteristiche:
- codifica in UTF-8
- codifica in URL
- generato individualmente per ogni fattura
La struttura finale risulta quindi la seguente.
Per questi dati della QR-fattura
SPC\n0200\n1\nCH4431999123000889012\nS\nSchreinerei Habegger & Söhne\nTeststrasse\n69\n8045\nZürich\nCH\n\n\n\n\n\n\n\n\nCHF\nS\nTest User\nTestweg\n10\n8045\nZürich\nCH\nQRR\n000000000000000000000123457\nOrder from 02.03.2026\nEPD\n\n
risulta questo link di pagamento
Struttura del payload
Il payload si basa sullo standard Swiss Payment Code (SPC) ed è conforme ai requisiti della QR-fattura svizzera. Tutte le informazioni relative alla fattura sono trasmesse in una struttura di campi definita e in seguito codificate.
Le informazioni richieste comprendono, tra l’altro, i dati del beneficiario del pagamento, l’IBAN o QR-IBAN, la valuta e le informazioni di riferimento. La definizione completa del campo è riportata in questa tabella e si basa sulle specifiche della QR-fattura svizzera.
| Riga | Campo | Descrizione | Valore | Spiegazione | Stato (regola) |
|---|---|---|---|---|---|
| 1 | QRType | Identificazione del tipo di QR-fattura | SPC | Valore fisso = Swiss Payment Code | Obbligatorio (valore fisso) |
| 2 | Version | Versione dello standard | 0200 | Versione attuale (v2.0) | Obbligatorio (valore fisso) |
| 3 | Coding | Set di caratteri | 1 | 1 = UTF-8 | Obbligatorio (valore fisso) |
| 4 | IBAN | Conto del beneficiario del pagamento | CH4431999123000889012 | QR-IBAN (IID 30000–31999) o NON-QR-IBAN | Obbligatorio |
| 5 | Cdtr.AdrTp | Tipo di indirizzo destinatario del pagamento | S | S = indirizzo strutturato | Obbligatorio (sono consentite S o K) |
| 6 | Cdtr.Name | Nome del beneficiario del pagamento | Falegnameria Habegger & Figli | Azienda | Obbligato |
| 7 | Cdtr.StrtNmOrAdrLine1 | Via | Via test | Indirizzo strutturato | Obbligatorio con S |
| 8 | Cdtr.BldgNbOrAdrLine2 | N° civico | 69 | Indicazione separata | Obbligatorio con S |
| 9 | Cdtr.PstCd | Numero postale di avviamento | 8045 | NPA CH | Obbligatorio con S |
| 10 | Cdtr.TwnNm | Località | Zurigo | Obbligatorio con S | |
| 11 | Cdtr.Ctry | Paese | CH | ISO 3166-1 | Obbligatorio |
| 12 | UltmtCdtr.AdrTp | Tipo Ultimate Creditor | Deve essere vuoto (non consentito) | ||
| 13 | UltmtCdtr.Name | Nome Ultimate Creditor | Deve essere vuoto (non consentito) | ||
| 14 | UltmtCdtr.StrtNmOrAdrLine1 | Indirizzo | Deve essere vuoto (non consentito) | ||
| 15 | UltmtCdtr.BldgNbOrAdrLine2 | Indirizzo | Deve essere vuoto (non consentito) | ||
| 16 | UltmtCdtr.PstCd | NPA | Deve essere vuoto (non consentito) | ||
| 17 | UltmtCdtr.TwnNm | Località | Deve essere vuoto (non consentito) | ||
| 18 | UltmtCdtr.Ctry | Paese | Deve essere vuoto (non consentito) | ||
| 19 | Amt | Importo | Muss leer sein (nicht erlaubt) | ||
| 20 | Ccy | Valuta | CHF | Sono consentiti solo CHF | Obbligatorio |
| 21 | UltmtDbtr.AdrTp | Tipo di indirizzo pagatore | S | Indirizzo strutturato | Opzionale (se inserito → coerente) |
| 22 | UltmtDbtr.Name | Nome pagatore | Utente di prova | Opzionale | |
| 23 | UltmtDbtr.StrtNmOrAdrLine1 | Via | Strada test | Opzionale | |
| 24 | UltmtDbtr.BldgNbOrAdrLine2 | N° civico | 10 | Opzionale | |
| 25 | UltmtDbtr.PstCd | NPA | 8045 | Opzionale | |
| 26 | UltmtDbtr.TwnNm | Località | Zurigo | Opzionale | |
| 27 | UltmtDbtr.Ctry | Paese | CH | Opzionale | |
| 28 | RmtInf.Tp | Tipo di riferimento | QRR o SCOR | Riferimento QR | Obbligatorio |
| 29 | RmtInf.Ref | Numero di riferimento | 000000000000000000000123457 | 27 cifre numeriche (ma dipende dal tipo di riferimento) | Obbligatorio con QRR |
| 30 | AddInf.Ustrd | Comunicazione non strutturata | Fattura 01.01.2026 | Testo libero (ad es. riferimento interno) | Opzionale |
| 31 | AddInf.Trailer | Indicatore di chiusura | EPD | End of Payment Data | Obbligatorio (valore fisso) |
| 32 | AddInf.StrdBkgInf | Informazioni aggiuntive strutturate | Opzionale (utilizzato raramente) | ||
| 33 | AltPmtInf | Metodi di pagamento alternativi | Opzionale | ||
| 34 | AltPmtInf | Metodi di pagamento alternativi | Opzionale |
Informazioni minime richieste: https://www.six-group.com/dam/download/banking-services/standardization/qr-bill/ig-qr-bill-v2.3-en.pdf
Le seguenti informazioni sono opzionali, ma sono consigliate per un’esperienza utente ottimale:
- importo (amount) per l’autorizzazione del pagamento diretta senza inserimento manuale
- informazioni sul pagatore (debitor information) facilitano l’assegnazione del pagamento
- comunicazione non strutturata per riferimenti interni, numeri di fattura o informazioni supplementari
Pulsante online
Il pulsante online è una rappresentazione visiva del link di pagamento (paylink) e consente all’utente di avviare la procedura di pagamento tramite TWINT. Dal punto di vista tecnico, il pulsante rimanda allo stesso link di pagamento che può essere utilizzato anche direttamente.
Il pulsante online è particolarmente adatto all’integrazione in
- portali clienti,
- applicazioni mobili,
- e-mail HTML e
- processi di fatturazione digitali.
Con questo pulsante, gli utenti possono avviare il pagamento direttamente dal rispettivo canale digitale senza dover scansionare un codice QR.
Il pulsante online è disponibile in diverse lingue e varianti di design e può essere adattato all’applicazione o al sito web.
Lingue disponibili:
- tedesco (DE)
- inglese (EN)
- francese (FR)
- italiano (IT)
Design disponibili:
- chiaro (light)
- scuro (dark)
In questo modo è possibile garantire un’esperienza utente coerente indipendentemente dalla lingua o dall’aspetto dell’applicazione.
| Lingua | Design chiaro (light) | Design scuro (dark) |
|---|---|---|
| Tedesco | ||
| Inglese | ||
| Francese | ||
| Italiano |
Esempio di integrazione
L’integrazione avviene tramite un pulsante o un link HTML standard, che rimanda al link di pagamento TWINT generato. Cliccandoci sopra, si apre il link di pagamento e i dati di fatturazione contenuti nel payload vengono trasmessi all’app TWINT.
Questo codice HTML mostra l’integrazione consigliata del pulsante online per l’utilizzo produttivo:
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_dark_de.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_dark_en.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_dark_fr.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_dark_it.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_light_de.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_light_en.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_light_fr.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
< button style=” width: auto; height: 58px; border-radius: 6px; display: flex; justify-content: center; align-items: center; cursor: pointer; background-color: transparent; border: none; ” onclick=”window.open(‘https://go-int.twint.ch/1/e/tw?tw=acq.853EJT8wQvOLLjkmm-ga__TO8gGGF1TsrB9Og9zfyg0cHh0lAOLYeNA_rT8jek58.’, ‘_blank’)” >< img src=”https://go-int.twint.ch/static/img/button_light_it.svg” alt=”Embedded TWINT button” style=”width: auto; height: 58px” / >
< /button >
Validazione
Prima della messa in produzione, è opportuno assicurarsi che l’attuazione funzioni correttamente e che tutti i requisiti siano soddisfatti.
In particolare, la validazione dovrebbe riguardare i seguenti punti:
- il link di pagamento apre l’app TWINT sui dispositivi mobili;
- il payload viene elaborato correttamente;
- il riferimento è valido ed è conforme alle disposizioni;
- la codifica (UTF-8 e URL) è corretta.
La soluzione dovrebbe essere testata sulle piattaforme mobili supportate:
- iOS
- Android
Poiché il link di pagamento può essere utilizzato anche nelle applicazioni desktop, è necessario verificare il comportamento anche sui dispositivi desktop.
- Il comportamento all’apertura è stato verificato
- Il meccanismo di fallback definito funziona come previsto
- Qualora non fosse possibile il reindirizzamento diretto a un’app TWINT, l’utente riceve una guida utente comprensibile
Prima del go-live, tutti i test devono essere conclusi con successo e documentati. Ciò garantisce che l’elaborazione dei pagamenti per gli utenti finali avvenga in modo affidabile, coerente e senza intoppi.
4. Pulsante online
Fattura TWINT consente di pagare in tutta semplicità le fatture digitali tramite l’app TWINT. Poiché la soluzione è stata concepita appositamente per il pagamento delle fatture già emesse, si applicano chiare disposizioni per quanto riguarda i casi di utilizzo ammessi, il momento della fatturazione e la relativa protezione degli acquirenti.
Il pulsante online TWINT è previsto esclusivamente per l’invio digitale di fatture dopo l’erogazione della prestazione. L’integrazione non può essere utilizzata per offrire un pagamento immediato (pagamento immediato con TWINT nell’e-commerce o nel pagamento con carta) nel carrello o nella procedura di check-out.
Importante: il pulsante online TWINT non è un metodo di pagamento per il check-out e NON può essere utilizzato come opzione di pagamento immediato nel carrello o nella procedura di check-out.
Concretamente ciò significa che: nell’e-commerce e in casi di utilizzo simili, il pulsante online può essere pubblicato, comunicato al o alla cliente o trasmesso solo dopo che la merce ordinata è stata spedita o il servizio erogato.
La fattura (con pulsante online TWINT integrato o link di pagamento) viene inviata al o alla cliente dopo il completamento del servizio, di solito tramite e-mail, portale clienti o come documento nell’app. È vietato l’utilizzo del pulsante online come mero pagamento anticipato. All’atto del check-out, il pulsante non deve apparire come opzione da selezionare per un pagamento immediato, ma è espressamente previsto solo per l’invio digitale delle fatture dopo la consegna.
Processo basato su best practice (esempio per e-commerce):
- il o la cliente ordina merce o un servizio;
- il rivenditore consegna la merce o fornisce il servizio;
- il rivenditore invia la fattura con il pulsante online TWINT integrato;
- il o la cliente paga la fattura tramite TWINT.
Questo processo garantisce il rispetto dei requisiti di fattura TWINT per quanto riguarda i casi di utilizzo consentiti e la protezione dell’acquirente. Il pulsante online TWINT può quindi essere utilizzato esclusivamente per l’invio digitale delle fatture dopo la fornitura del servizio.
TWINT è uno strumento di pagamento sicuro e affidabile per i clienti finali. Questa proposta di valore vale anche per fattura TWINT. La protezione degli acquirenti (Buyers Protection) è disciplinata come segue:
- una fattura TWINT può essere emessa solo dopo l’effettiva erogazione della prestazione;
- il classico pagamento anticipato non è ammesso;
- in caso di spedizione della merce, la consegna allo spedizioniere (posta, corriere ecc.) vale come momento dell’erogazione del servizio;
- per gli ordini di servizio è determinante la corretta esecuzione;
- solo a partire da questo momento è possibile inviare al o alla cliente una fattura TWINT (con pulsante online o link di pagamento).
Le eccezioni per le quali è ammessa la fatturazione prima dell’erogazione delle prestazioni sono riportate nelle CG vigenti.
Indipendentemente dalle eccezioni definite nelle CG, non sono ammessi i seguenti casi di utilizzo:
- prenotazioni di viaggi;
- transazioni per ticketing ed eventi (ad es. festival, concerti);
- acquisto di voucher;
- casi di applicazione in cui solitamente un pagamento avviene prima della fornitura di prestazioni.
I rivenditori e i loro acquirenti o PSP sono responsabili del rispetto di queste direttive. In caso di violazioni, l’acquirente si assume la responsabilità nei confronti di TWINT; il rischio economico associato può essere trasferito al rivenditore.
L’approccio alla base di questo modello consiste nel garantire la sicurezza per gli e le utenti di TWINT in primo luogo attraverso casi d’uso chiaramente definiti e controllati, piuttosto che attraverso meccanismi di protezione degli acquirenti a valle come il chargeback. Eventuali controversie derivanti, ad esempio, da un’erogazione carente dei servizi, da consegne errate o da scambi di merce non vengono quindi interamente coperte da TWINT. Tali casi continuano a essere soggetti alle disposizioni vigenti in materia di tutela dei consumatori nonché alle rispettive procedure di reclamo e assistenza del rivenditore.
5. Linee guida per il design
Per richiamare l’attenzione dei clienti sull’opzione di pagamento TWINT, sulla fattura con Swiss QR Code viene inserita una barra informativa. Questa separa la parte della fattura dalla sezione relativa al pagamento e dalla ricevuta ed è un elemento centrale di identificazione visiva.
Il requisiti di design completi sono descritti nella guida di stile e nelle Brand Guidelines.
La barra contiene i seguenti elementi:
- il logo TWINT
- la nota «Questa fattura può essere pagata anche con TWINT».
- un’icona di forbici sul bordo perforato
È disponibile in quattro lingue (tedesco, inglese, francese e italiano) e, in una fattura standard in formato A4, viene posizionata al vivo sopra la sezione del pagamento.
Per le dimensioni, il colore e il carattere valgono le seguenti direttive:
- larghezza 210 mm, altezza 11 mm
- colore di sfondo nero TWINT (#262626)
- carattere Roboto Medium, 10 pt, bianco (#FFFFFF)
Nell’integrazione della barra occorre osservare i seguenti punti:
- la barra non deve essere scalata o distorta in lunghezza o larghezza
- non può essere tagliata né utilizzata in elementi singoli
- non sono ammesse variazioni di colore o rappresentazioni trasparenti
Il pulsante online TWINT è l’elemento visivo di accesso al pagamento digitale delle fatture e funge da rappresentazione visiva del link di pagamento (paylink). È disponibile in diverse varianti linguistiche e di design in modo da poterlo integrare perfettamente in svariate applicazioni e siti web.
Per un utilizzo corretto valgono le disposizioni delle Brand Guideline.
Il pulsante è disponibile in
- tedesco, inglese, francese o italiano e
- nel design chiaro (light) o scuro (dark).
| Lingua | Design chiaro (light) | Design scuro (dark) |
|---|---|---|
| Tedesco | ||
| Inglese | ||
| Francese | ||
| Italiano |
Specifiche tecniche:
- Altezza del pulsante uniforme: 58 px
- Larghezza automatica raggio del bordo: 6 px
- Senza sfondo, senza bordo
- Il pulsante della lingua viene integrato come immagine: < img src=”button_[design]_[sprache].svg” >
- Schema di denominazione:
- button_light_de.svg
- button_dark_fr.svg
Non è consentito modificare ulteriormente il pulsante, ad esempio cambi di colore, distorsioni o la sostituzione di singoli elementi.
Fanno sempre fede le Brand Guideline in vigore.
Per l’integrazione tecnica del pulsante online, inclusi esempio di integrazione e codice HTML, si veda il capitolo 3.2. Implementazione del pulsante online e del link di pagamento.
6. Messa a disposizione dei dati
Questo diagramma mostra l’intera procedura di elaborazione delle fatture TWINT, dall’apertura della posizione debitoria nel sistema ERP/di contabilità generale fino al pagamento effettivo e alla riconciliazione finale dei crediti.

Il processo di elaborazione dei pagamenti comprende tutte le parti interessate: sistema ERP/contabilità generale (emittente della fattura), emittente della fattura, emittente della fattura banca, banca acq. TWINT, TWINT e il o la cliente.
Passaggio 1: emissione e invio delle fatture
- Il sistema ERP o di contabilità generale del rivenditore apre una posizione debitoria
- La fattura viene inviata al o alla cliente dal rivenditore
Passaggio 2: programmazione del pagamento
- Il o la cliente riceve la fattura e programma il pagamento tramite l’app TWINT (pianificazione)
Passaggio 3: esecuzione alla data di scadenza
- TWINT esegue il pagamento alla data di scadenza selezionata
- Successivamente viene creato un file Camt.054 che viene reso disponibile via SFTP
- Contemporaneamente viene trasmesso un ordine di pagamento Pain.001 alla banca acquirente TWINT
Passaggio 4: pagamento cumulativo
- La banca acquirente TWINT effettua un pagamento cumulativo che include tutte le transazioni contenute nel file Camt.054
- Nel pagamento effettivo possono confluire anche ulteriori pagamenti di fatture tramite e-banking
Passaggio 5: riconciliazione dei crediti
- Il rivenditore legge il file Camt.054 di TWINT e il file Camt.053 della banca e li confronta per assicurarsi che tutti i pagamenti chiusi siano stati effettivamente ricevuti.
Il file Camt.054 contiene tutte le transazioni eseguite relative alle fatture di TWINT e funge da base per la riconciliazione dei crediti nel software di contabilità. Il file viene creato automaticamente dopo ogni pagamento e messo a disposizione tramite il server SFTP.
Un esempio di un file Camt.054 può essere scaricato qui.
Il server SFTP è l’infrastruttura tecnica con cui TWINT fornisce automaticamente il file Camt.054 dopo ogni esecuzione di pagamento. Il rivenditore può recuperare i file da lì e importarli direttamente nel suo software di contabilità.
Per utilizzare il server SFTP sono necessari i seguenti passaggi:
- configurazione dell’accesso SFTP nell’ambito dell’onboarding con TWINT
- configurazione del client SFTP con i dati di accesso forniti (host, porta, nome utente, password)
- recupero periodico dei file Camt.054 dalla directory predefinita sul server
Il file Camt.054 viene archiviato automaticamente sul server SFTP dopo ogni pagamento ed è pronto per essere richiamato subito dopo la creazione.
Durante l’onboarding vengono messe a disposizione istruzioni dettagliate per la configurazione nonché i dati di accesso necessari.
Desideri offrire TWINT per le tue fatture?
Registrati subito e consenti ai tuoi clienti di pagare in modo semplice e veloce con TWINT.