L'IA Non Collega Nexi, SPID o la Fatturazione Elettronica al Tuo Sito

È una scena che vedo sempre più spesso. Una persona con Lovable, Bolt o v0 mette in piedi un e-commerce elegante in un weekend. Il design è pulito, le schede prodotto funzionano, il carrello calcola il totale giusto. Poi arriva il momento in cui il cliente deve pagare davvero con Nexi o Stripe, in cui l'utente deve accedere e in cui, venduta la merce, deve partire in automatico la fattura elettronica verso lo SdI. Ed è esattamente qui che tutto si blocca.

L'IA genera un bottone di pagamento che sembra perfetto. Solo che i soldi non arrivano. Genera una schermata di accesso che non autentica nessuno. Promette un export della fattura che l'Agenzia delle Entrate non accetterà mai. Non è una sfortuna né un prompt scritto male: è il limite reale a cui si fermano gli strumenti di IA di oggi. In questo articolo ti spiego perché succede, quali integrazioni italiane richiedono una persona vera invece di un prompt, e cosa significa concretamente per il prezzo e i tempi del tuo progetto.

Perché l'IA disegna bene l'interfaccia ma non le integrazioni

L'interfaccia è il terreno dove l'IA è davvero forte. Bottoni, form, griglie, animazioni: sono pattern ripetitivi, descritti online in milioni di esempi. L'IA è stata addestrata proprio su quel codice, perciò un frontend bello e perfino responsive lo produce a velocità impressionante. Se ti serve un sito che sembri a posto, l'IA ti aiuta sul serio.

L'integrazione con un sistema reale è tutta un'altra storia. Nexi, Stripe, SPID, lo SdI o BRT non sono pezzetti di codice che l'IA può "ricordare" e rigenerare. Sono sistemi vivi, che esistono fuori dal tuo sito e che pretendono tre cose che l'IA semplicemente non possiede: il rapporto contrattuale della tua partita IVA col fornitore, le tue chiavi segrete di produzione e un server sicuro dove far girare quella logica. L'IA non può firmare un contratto con Nexi al posto tuo. Non può verificare la tua partita IVA presso il PSP. Non può custodire in modo sicuro le tue chiavi API, perché di fatto le incolla nel codice che chiunque vede aprendo il browser.

È la differenza di fondo tra "sembra che funzioni" e "funziona in produzione con soldi veri". Se vuoi vedere quanto pesa davvero questa parte, ne parlo anche nel pezzo su il vero costo di un sito "gratis" fatto con l'IA: le integrazioni sono il punto in cui si arena la maggior parte delle persone.

Le integrazioni italiane che richiedono una persona vera

Vediamole nel concreto. Ecco le integrazioni con cui si scontra ogni progetto di business italiano, e perché ciascuna ha bisogno di una persona, non di un prompt.

Integrazione	A cosa serve	Perché l'IA non la collega
Nexi XPay / Stripe	Pagamenti con carta, abbonamenti	Contratto col PSP, chiavi di produzione, conferma del pagamento con verifica della firma sul server
PayPal / Satispay / BANCOMAT Pay / Scalapay	Wallet, A2A, BNPL ("paga a rate")	Account merchant approvato, callback verificati, gestione di rimborsi e stati intermedi
SPID / CIE / IT-Wallet	Identità digitale, accesso a flussi PA	Accreditamento AgID come Service Provider, SAML firmato, dati personali sotto il GDPR e il Garante
Fatturazione elettronica via SdI	Fatture B2B/B2C obbligatorie per partita IVA	Provider accreditato, XML conforme, Codice Destinatario/PEC, imposta di bollo, scarti da gestire
BRT / GLS / Poste Italiane (SDA)	Spedizioni, etichette, tracking, locker	Contratto col corriere, chiavi account, generazione etichette, scelta punto di ritiro

Pagamenti: Nexi XPay, Stripe, Satispay e gli altri

In Italia la carta resta la quota più grande del checkout online, e Nexi è il gateway che un developer integra di default per un esercente italiano: gestisce oltre il 60% del volume carte del Paese. Accanto ci sono PayPal, il wallet di cui si fida chi compra per la prima volta, Satispay con i suoi milioni di utenti agganciati direttamente al conto, BANCOMAT Pay e, per chi vende a rate, Scalapay. Stripe entra in gioco quando servono abbonamenti, SaaS o un'esperienza internazionale, spesso affiancato a Nexi. Per far funzionare tutto questo serve un contratto col fornitore, un account merchant verificato e le chiavi di produzione. Ma la parte decisiva è invisibile: quando il cliente paga, il provider invia una conferma al tuo server, e il tuo server deve verificare la firma di quel messaggio prima di segnare l'ordine come pagato. Senza questo controllo chiunque può inviare un finto "pagato" e portarsi via la merce gratis. L'IA questa logica lato server non la genera, perché non ha le tue chiavi e non capisce le conseguenze sul tuo business.

Identità: SPID, CIE e IT-Wallet

Per la stragrande maggioranza degli e-commerce e delle app B2C basta un login email-password o social: SPID non serve per vendere scarpe. Diventa indispensabile quando ti integri con la Pubblica Amministrazione o con flussi regolamentati, ed è lì che si entra in un altro mondo. SPID richiede l'accreditamento come Service Provider secondo le regole AgID, la gestione dei metadati e delle asserzioni SAML firmate; CIE, indicata come erede di SPID, aggiunge il chip NFC e il PIN; l'IT-Wallet dentro l'App IO sta convergendo verso il portafoglio europeo EUDI entro il 2026. Un errore qui ha due facce: o non entra nessuno, oppure, ben peggio, fai entrare la persona sbagliata. Non è un form: è un sistema di sicurezza con dati personali sotto l'occhio del Garante, che va costruito e testato da chi ne capisce le conseguenze.

Fatturazione elettronica via SdI: il "quasi giusto" non esiste

Dal 1° gennaio 2024 la fattura elettronica via Sistema di Interscambio è obbligatoria per tutte le partite IVA, regime forfettario incluso. Non si tratta di un PDF inviato via email: è un file XML trasmesso attraverso lo SdI dell'Agenzia delle Entrate, con campi obbligatori come il Codice Destinatario a 7 caratteri o la PEC, e con l'imposta di bollo da 2€ da applicare in digitale sopra una certa soglia. Qui l'IA promette di "esportare la fattura", ma lo SdI accetta solo dati formattati esattamente secondo le specifiche: o l'XML viene accolto, o viene scartato con una notifica che bisogna saper leggere e correggere. Il "quasi giusto" non esiste. Nella pratica si integra un provider come Fatture in Cloud, Aruba, InfoCert o Namirial, e questa conformità la garantisce una persona che sa come si comporta davvero lo SdI, non un testo che suona convincente.

Spedizioni: BRT, GLS, Poste Italiane

Un e-commerce ha bisogno che il cliente scelga la consegna a casa o il ritiro in un punto o locker, che l'etichetta di spedizione si generi in automatico e che il pacco sia tracciabile. Per questo serve un contratto col corriere — BRT, GLS, Poste Italiane/SDA — le chiavi dell'account, il caricamento dei punti di ritiro e la generazione delle etichette tramite il loro sistema. Spesso si passa da un livello multi-corriere come Sendcloud, Spedire.com o Qapla' per gestirli tutti insieme. L'IA può disegnare il menu di scelta del corriere, ma resterà vuoto: senza un collegamento reale ai sistemi dei vettori lì non ci sono né punti di ritiro né etichette.

Perché non è un "collega l'API in 5 minuti"

Me lo sento dire spesso: "ma c'è la documentazione, basta collegare l'API". Vero: una demo in cui il bottone sembra un pagamento si fa davvero in 5 minuti. Un collegamento reale, che non deve perdere soldi, non accettare pagamenti doppi e reggere un controllo del PSP, è fatto di passaggi di cui non puoi saltarne nemmeno uno.

• Contratto e verifica dell'account. Il fornitore deve approvare la tua partita IVA e darti l'accesso di produzione. Spesso dura più del codice stesso.
• Test in sandbox. Ogni provider ha un ambiente di prova dove il flusso si collauda prima di toccare soldi veri. Salti questo passo e il primo cliente reale diventa il tuo test.
• Verifica di firme e conferme. Il server deve accertare che la conferma del pagamento arrivi davvero dal provider, e non da un impostore.
• Conformità e GDPR. I dati di identità e pagamento sono sensibili: il loro trattamento deve rispettare la legge, non solo funzionare. In Italia il Garante è particolarmente attento sul consenso cookie e sui trasferimenti di dati.
• Casi limite. Cosa fare quando il pagamento si interrompe a metà, quando il cliente clicca due volte, quando il provider non risponde, quando serve un rimborso. Sono proprio questi casi a separare la demo dal prodotto.

È quel "30% difficile" di cui parlo a quasi ogni cliente. L'IA porta il progetto al 70%: bello, visibile, d'effetto. Il 30% restante — integrazioni, sicurezza, casi limite, conformità — è la parte più dura e più costosa. Non perché sia "difficile da finire", ma perché è proprio quella il prodotto vero. Se vuoi capire meglio dove l'IA ti basta davvero e dove non se ne può fare a meno, leggi quando basta l'IA e quando serve uno sviluppatore: lì metto onestamente sul tavolo entrambe le facce.

Cosa significa per prezzo e tempi

Per essere trasparente, ecco gli intervalli orientativi reali per collegare in modo pulito le integrazioni italiane a un sito o a un e-commerce. Non è "rattoppare codice", è un impianto che regge il traffico reale e un controllo del fornitore. Le cifre sono nette di IVA: molti di noi freelance lavorano in regime forfettario e non addebitano l'IVA, riportando in fattura la nota di legge.

Integrazione	Prezzo orientativo	Tempi (con account attivo)
Un gateway di pagamento (Nexi XPay o Stripe)	800 – 2.000€	1 – 2 sett.
Wallet aggiuntivi (PayPal / Satispay / Scalapay)	400 – 1.200€ ciascuno	1 sett.
Fatturazione elettronica via SdI (provider + gestionale)	1.200 – 3.500€	2 – 4 sett.
Spedizioni multi-corriere (BRT / GLS / Poste via Sendcloud)	700 – 1.800€	1 – 2 sett.
Autenticazione SPID / CIE	da 2.500€	3 – 6 sett.

Due cose da tenere a mente sui tempi. Primo: la parte più lunga spesso non è il codice, ma la verifica dell'account merchant e l'ottenimento delle chiavi di produzione — conviene avviare quel processo il prima possibile, chiunque costruisca il sito. Secondo: le integrazioni raramente sono isolate. Pagamento, fattura e spedizione formano quasi sempre un'unica catena, perciò conviene pianificarle insieme invece di rattopparle una alla volta. Per inquadrare l'investimento complessivo di un e-commerce a norma, ho raccolto le cifre tipiche nella pagina su la realizzazione di un negozio online.

Come ci arrivo io

Quando prendo in mano un progetto in cui le integrazioni non funzionano, non rattoppo il codice generato pezzo per pezzo. Guardo cosa serve collegare davvero, disegno l'intera catena — pagamento, fattura, spedizione, eventuale identità — e costruisco la parte lato server con tutti i controlli, i test in sandbox e i casi limite. L'obiettivo non è "che il bottone si veda", ma che i soldi arrivino sul serio, che la fattura parta verso lo SdI e venga accettata, e che il consenso cookie sia a norma del Garante. Tu resti con un prodotto che funziona e con un codice che è tuo — niente lock-in su una piattaforma che non controlli — non con una bella facciata dietro cui non c'è nulla. Sono uno sviluppatore freelance con presenza locale: ci si parla via WhatsApp o per email, non solo con un form.

Domande frequenti