Come accettare pagamenti con carta in un'app POS personalizzata

Per accettare pagamenti con carta in un'app POS personalizzata, è necessario utilizzare un Payment Service Provider (PSP) e una delle quattro modalità disponibili: un lettore di carte certificato, Tap to Pay su iPhone, Tap to Pay su Android o un terminale intelligente connesso al cloud. L'app non legge mai direttamente il numero della carta: invia l'importo all'hardware o al software certificato e riceve l'esito della transazione (approvato o rifiutato). Ogni modalità prevede requisiti specifici stabiliti da Apple, Google o dal fornitore di pagamenti, ed è questa gestione burocratica, non la scrittura del codice, a richiedere maggior tempo.

Questa guida illustra ogni opzione passo dopo passo, specificando i requisiti reali in modo chiaro e trasparente. Gestiamo i pagamenti per il nostro POS, Final, quindi abbiamo affrontato ciascuna di queste procedure in prima persona.

Perché non è possibile aggiungere semplicemente un modulo carta al proprio POS?

Perché un modulo di inserimento carta rende la vendita una transazione "carta non presente", mentre il banco di un negozio richiede una transazione "carta presente". Quando un cliente digita il numero di carta in un modulo web, il pagamento viene trattato come un ordine online: commissioni più elevate, maggiore esposizione alle frodi e maggior rischio di contestazione a carico dell'esercente. Quando un dispositivo certificato legge la carta o il telefono, la transazione è "carta presente", risultando più economica e sicura per tutti.

L'accettazione in modalità carta presente richiede hardware o software certificato. Questo è il motivo per cui tutte le modalità descritte di seguito utilizzano il prodotto in presenza del PSP anziché codice proprietario. La differenza di commissioni è illustrata in carta presente vs carta non presente.

Modalità 1: Come utilizzare un lettore di carte con la propria app?

Scegli un PSP dotato di SDK per l'uso in presenza, acquista uno dei suoi lettori certificati e associalo dalla tua app. Stripe Terminal, Adyen e altri operano in questo modo.

1. Apri un account con il PSP e abilita il prodotto per l'uso in presenza.

2. Integra il suo SDK iOS, Android o React Native.

3. Ordina lettori certificati e registrali sul tuo account.

4. Rileva e connetti i lettori dall'app, quindi incassa i pagamenti tramite l'SDK.

5. Pianifica la gestione degli aggiornamenti del firmware del lettore, inviati direttamente dal PSP.

Non è possibile collegare un lettore generico: solo i lettori certificati con il tuo fornitore possono elaborare le carte, in quanto la certificazione copre la combinazione esatta di lettore, software e gestore delle transazioni. Maggiori dettagli in lettori di carte per app POS personalizzate e certificazione EMV per un POS.

Modalità 2: Quali sono i requisiti per Tap to Pay su iPhone?

Tap to Pay su iPhone trasforma lo smartphone in un lettore di carte. I passaggi previsti da Apple sono: collaborare con un PSP supportato, richiedere l'autorizzazione (entitlement) Tap to Pay su iPhone, integrare l'API ProximityReader o l'SDK del PSP, rispettare le Human Interface Guidelines di Apple e inviare l'app per la revisione (panoramica di Apple su Tap to Pay). Apple precisa che il PSP è responsabile delle certificazioni necessarie per consentire agli esercenti di accettare pagamenti.

Nella pratica, questo significa:

1. Un account sviluppatore aziendale. La richiesta di autorizzazione deve essere effettuata dal titolare di un account organizzazione, e l'iscrizione come organizzazione richiede un numero D-U-N-S. Consulta numero D-U-N-S e account Apple developer.

2. Il modulo di richiesta. Indica il nome del tuo PSP e le regioni in cui opererai.

3. Un'autorizzazione per lo sviluppo. Apple ne concede una per la creazione e i test sui propri dispositivi.

4. Requisiti UX di Apple. Apple invia le sue linee guida di progettazione e marketing insieme all'autorizzazione, coprendo testo dei pulsanti, punti d'accesso e onboarding.

5. Un'autorizzazione per la distribuzione. Rispondi all'email di Apple per richiedere l'abilitazione alla distribuzione. TestFlight e l'App Store richiedono questo passaggio.

6. App Review. L'app viene pubblicata una volta superata la revisione.

Il servizio funziona su iPhone XS o modelli successivi e non è supportato su iPad. La guida completa si trova in come ottenere l'autorizzazione Tap to Pay su iPhone, con suggerimenti per l'approvazione in superare l'App Review con un'app Tap to Pay e le alternative descritte in perché Tap to Pay non funziona su iPad.

Modalità 3: In cosa differisce Tap to Pay su Android?

Su Android non esiste un'autorizzazione in stile Apple, ma l'SDK del PSP esegue i propri controlli. Requisiti tipici:

• Un dispositivo Android dotato di NFC integrato con Android 11 o successivo

• Un dispositivo certificato Google che superi l'attestazione di integrità

• Una build non di debug: gli SDK del PSP rifiutano le transazioni reali in modalità debug, richiedendo l'uso di un lettore simulato per i test

• Autorizzazioni di localizzazione e altri permessi richiesti dall'SDK

I tablet Android possono funzionare se soddisfano i requisiti del fornitore. Dettagli in Tap to Pay su Android in un'app personalizzata.

Modalità 4: Un POS basato su web può accettare carte?

Sì, tramite un terminale intelligente connesso al cloud. Il tuo server indica all'API del PSP di inviare una richiesta di pagamento a uno specifico terminale sul banco; il terminale gestisce la carta e restituisce l'esito al server. Questa è l'unica opzione in presenza utilizzabile da un POS web, in quanto una pagina web non può leggere carte contactless e Safari non può collegarsi a lettori Bluetooth.

Si adatta ai punti vendita con banco fisso e terminale dedicato. Richiede una connessione di rete stabile, pertanto è necessario pianificare il comportamento del sistema in caso di disconnessione.

Come scegliere un fornitore di pagamenti per un POS personalizzato?

Inizia dai Paesi in cui vendi, per poi valutare onboarding e hardware:

Il nostro confronto dettagliato è Stripe Terminal vs Adyen per un'app POS personalizzata. Se hai intenzione di incassare pagamenti per conto di altre attività, leggi prima diventare un payment facilitator o utilizzare una piattaforma; per un singolo negozio operi semplicemente come esercente.

Quale conformità si eredita e quale resta a proprio carico?

Utilizzando l'SDK o il lettore certificato di un PSP, i dati delle carte non toccano mai il tuo codice, mantenendo ridotto l'ambito PCI. Il PSP garantisce le certificazioni di pagamento. Restano comunque a tuo carico:

• Il questionario di autovalutazione PCI con il tuo gestore

• Controllo degli accessi, registrazione dei log e aggiornamenti sui dispositivi che eseguono il POS

• Gestione corretta di ricevute, rimborsi e storno delle imposte

• Regole di presentazione e marketing di Apple e del PSP per Tap to Pay

Se stai sviluppando anche il resto del POS, la nostra guida su come creare il proprio sistema POS con l'IA tratta PCI, imposte e distribuzione, mentre hardware POS per app personalizzate copre stampanti e cassetti.

Quanto tempo ci vuole per accettare il primo pagamento con carta?

È possibile accettare carte fin da subito?

Sì, sviluppando il checkout su una piattaforma che possiede già tutte le approvazioni necessarie. È il caso di Final. La tua IA sviluppa il checkout in Flow Studio e, quando viene richiesto un pagamento con carta, Final Pay gestisce il lettore o il Tap to Pay:

• Lettori e Tap to Pay già approvati. Final Pay accetta carte, pagamenti contactless e Tap to Pay sui dispositivi supportati. Consulta come accettare un pagamento Tap to Pay e come incassare un pagamento al checkout.

• La tua IA lo sviluppa direttamente. Connetti Claude, Cursor o qualsiasi client MCP tramite il server MCP di Final.

• Prezzi chiari in una sola riga. Nessun abbonamento. Contanti: $0. Carta: 2,49% + $0,10 negli USA e nel mondo, 1,99% in Canada e 0,99% in Europa.

Il compromesso trasparente: elabori le transazioni tramite Final Pay anziché scegliere un tuo fornitore, e la disponibilità varia in base al Paese e al dispositivo, come indicato in dove è disponibile Final Pay. Se i pagamenti costituiscono il tuo prodotto principale, sviluppa l'integrazione in autonomia seguendo le modalità descritte sopra. Se i pagamenti sono solo il mezzo con cui ti fai pagare, le approvazioni sono già pronte.