14 ott 2025·8 min
Apple Pay nelle app mobili: cos'è e come funziona
Scopri cos'è Apple Pay nelle app mobili, come funziona dietro le quinte e come integrarlo in modo sicuro per velocizzare il checkout e migliorare le conversioni.
Scopri cos'è Apple Pay nelle app mobili, come funziona dietro le quinte e come integrarlo in modo sicuro per velocizzare il checkout e migliorare le conversioni.
Apple Pay è il portafoglio digitale e il servizio di pagamento di Apple. Permette agli utenti di memorizzare carte di credito, debito e alcune carte prepagate o di negozio in modo sicuro su iPhone, Apple Watch, iPad o Mac e pagare con un solo tocco o sguardo.
Invece di inserire numeri di carta e dati di fatturazione, l'utente si autentica con Face ID, Touch ID o il codice del dispositivo. Apple genera un token specifico per il dispositivo in modo che il numero reale della carta non venga condiviso con il merchant.
Apple Pay funziona in tre contesti principali:
Questa guida si concentra su Apple Pay in‑app, dove l'intera esperienza di pagamento resta all'interno dell'app.
Digitare i dati della carta su uno schermo piccolo è lento e soggetto a errori. Apple Pay sostituisce più campi del modulo con un'unica interazione, che tipicamente:
Poiché carte e indirizzi sono già memorizzati sul dispositivo, Apple Pay riduce anche l'attrito per i clienti al primo acquisto.
Apple Pay funziona sui modelli recenti di iPhone, iPad, Apple Watch e Mac nelle regioni supportate, con circuiti principali come Visa, Mastercard, American Express e numerosi circuiti locali, a seconda della banca emittente.
Apple Pay è più adatto quando:
Dovrebbe coesistere insieme ai form tradizionali per le carte e ad altri wallet, non sostituirli completamente, così gli utenti senza Apple Pay possono comunque pagare.
Apple Pay nasconde molta complessità dietro un'esperienza semplice di “doppio clic per pagare”. Sotto il cofano, più attori e livelli di sicurezza coordinano il movimento del denaro in modo sicuro.
Una tipica transazione Apple Pay coinvolge:
Quando un utente aggiunge una carta a Apple Wallet, il numero reale della carta (il FPAN, o Funding Primary Account Number) viene inviato in modo sicuro al circuito e all'emittente. Loro rispondono con un DPAN (Device Primary Account Number) più chiavi crittografiche uniche per quel dispositivo.
Il DPAN è ciò che Apple Pay usa durante le transazioni. La tua app e il backend non vedono mai l'FPAN. Questo è il nucleo del modello di tokenizzazione di Apple Pay: il dispositivo usa un numero di carta surrogato e cryptogrammi monouso invece di esporre la carta reale.
Nei dispositivi supportati, le credenziali di pagamento e le chiavi risiedono nel Secure Element (o sono protette tramite il Secure Enclave). Quando l'utente si autentica (Face ID, Touch ID o codice), il Secure Element:
La tua app riceve questo token opaco e cifrato tramite le API Apple Pay e lo invia al backend, che lo inoltra al PSP o gateway.
Il PSP decifra il token, estrae DPAN e cryptogramma, e invia una richiesta di autorizzazione attraverso il circuito alla banca emittente. L'emittente valida il cryptogramma e lo stato della carta, poi approva o rifiuta.
Successivamente, durante il settlement, l'importo autorizzato viene catturato, raggruppato e trasferito dalla banca emittente alla banca acquisitrice del merchant. Per la tua app, questo è solo il completamento della vendita o della cattura, ma dietro le quinte coinvolge acquirer, circuito e emittente usando il DPAN—non il numero reale della carta del cliente.
Prima di aggiungere Apple Pay alla tua app, devi soddisfare una serie di requisiti tecnici, commerciali e regionali.
Sul lato merchant è necessario avere:
Molti merchant creano anche un Merchant Identity certificate per la validazione merchant durante flussi web o ibridi.
Apple Pay in app è supportato su:
Controlla la documentazione Apple corrente per il supporto minimo dell'OS, specialmente se dipendi da API più recenti.
Apple Pay non è disponibile in tutti i Paesi o per tutte le banche. Devi confermare:
Apple può limitare alcune categorie merchant e casi d'uso (es. beni illegali, alcuni contenuti digitali o servizi, industrie ad alto rischio). Verifica che:
Infine, ti serve un PSP o gateway che supporti la tokenizzazione Apple Pay e la decrittazione. Conferma che il tuo provider:
Un flusso Apple Pay fluido risulta quasi invisibile per l'utente. Ecco come si presenta tipicamente, passo dopo passo.
Il percorso inizia solitamente sulla pagina prodotto o nel carrello. Dopo che l'utente ha scelto articoli e opzioni (taglia, colore, quantità), procede al checkout.
Nella schermata di checkout o carrello, mostra il pulsante Apple Pay standard fornito da Apple. Dovrebbe:
Quando l'utente tocca il pulsante, il foglio Apple Pay scorre dal basso dello schermo.
Questo foglio include tipicamente:
L'utente può modificare direttamente nel foglio carta, spedizione e contatti prima della conferma.
Per autorizzare il pagamento, l'utente si autentica con:
Il foglio indica chiaramente la richiesta, per esempio: “Double-click to pay” sui dispositivi Face ID.
Dopo l'autenticazione, il foglio mostra lo stato di avanzamento e poi scompare, tornando alla tua app.
La tua app dovrebbe mostrare immediatamente uno stato chiaro:
Mantenere questi stati chiari rassicura l'utente sullo stato del pagamento e che mantiene il controllo durante tutto il flusso.
Implementare Apple Pay su iOS ruota attorno al framework PassKit e a poche classi principali. Ecco il flusso end‑to‑end a livello di app.
Questo collega il bundle della tua app alla tua identità merchant così che possano essere generati token Apple Pay per il server.
PKPaymentRequestimport PassKit
func createPaymentRequest() -> PKPaymentRequest? {
guard PKPaymentAuthorizationController.canMakePayments() else { return nil }
let request = PKPaymentRequest()
request.merchantIdentifier = "merchant.com.yourcompany.app"
request.countryCode = "US"
request.currencyCode = "USD"
request.supportedNetworks = [.visa, .masterCard, .amex]
request.merchantCapabilities = [.capability3DS]
request.paymentSummaryItems = [
PKPaymentSummaryItem(label: "Pro Subscription", amount: 9.99),
PKPaymentSummaryItem(label: "Your Company", amount: 9.99)
]
return request
}
merchantIdentifier, countryCode e currencyCode devono corrispondere alla tua configurazione merchant. supportedNetworks riflette i circuiti di carta supportati da te e dal tuo PSP. Includi almeno .capability3DS in merchantCapabilities.
PKPaymentButtonUsa PKPaymentButton invece di pulsanti personalizzati per rispettare le linee guida Apple:
let payButton = PKPaymentButton(paymentButtonType: .buy, paymentButtonStyle: .black)
Posizionalo dove l'intento di acquisto è più forte: pagina prodotto, carrello e checkout finale. Disabilitalo o nascondilo se PKPaymentAuthorizationController.canMakePayments() restituisce false.
PKPaymentAuthorizationController e gestire i callbackCrea un controller dalla request e conformati a PKPaymentAuthorizationControllerDelegate:
func startApplePay() {
guard let request = createPaymentRequest() else { return }
let controller = PKPaymentAuthorizationController(paymentRequest: request)
controller.delegate = self
controller.present(completion: nil)
}
extension CheckoutViewController: PKPaymentAuthorizationControllerDelegate {
func paymentAuthorizationController(_ controller: PKPaymentAuthorizationController,
didAuthorizePayment payment: PKPayment,
handler completion: @escaping (PKPaymentAuthorizationResult) -> Void) {
// Send payment.token to your server for processing
// Then call completion(.init(status: .success, errors: nil)) or .failure
}
func paymentAuthorizationControllerDidFinish(_ controller: PKPaymentAuthorizationController) {
controller.dismiss(completion: nil)
}
}
Il metodo didAuthorizePayment è dove passi il payment.token al tuo server per l'effettivo addebito. Dopo la risposta del server, completa con .success o .failure, poi chiudi il foglio in paymentAuthorizationControllerDidFinish.
La logica server-side è ciò che trasforma un foglio Apple Pay in denaro reale. L'app raccoglie l'autorizzazione dell'utente; il backend valida il merchant, elabora il token e parla con il gateway di pagamento.
Prima di mostrare il foglio Apple Pay, la tua app deve ottenere una merchant session da Apple.
PKPaymentAuthorizationController.Questo flusso dimostra ad Apple che l'app è associata alla tua identità merchant e al dominio.
Dopo che l'utente autorizza il pagamento, l'app riceve un token di pagamento cifrato (PKPaymentToken) e lo invia al backend tramite HTTPS.
Sul server:
Il gateway decifra il token (usando network token o DPAN) ed esegue l'autorizzazione nelle reti di pagamento.
I gateway solitamente offrono due flussi:
Il backend dovrebbe salvare l'ID transazione del gateway, importo, valuta e stato—ma non dati di carta grezzi o contenuti del token decifrato.
Conserva solo ciò che è davvero necessario per riconciliazione, rimborsi e supporto clienti:
Non memorizzare mai numeri completi di carta, CVV o token di pagamento non cifrati sui tuoi server. Affida la gestione sensibile a gateway PCI‑compliant e assicurati che tutte le comunicazioni siano via TLS con logging e controlli d'accesso rigorosi.
Apple Pay è progettato in modo che la tua app non tocchi mai i numeri di carta in chiaro, ma devi comunque capire il modello di sicurezza e le tue responsabilità.
Quando un utente aggiunge una carta a Apple Pay, l'emittente e la rete sostituiscono il PAN reale con un Device Account Number (DAN).
Durante il pagamento:
La tua app e il backend vedono solo token e metadati di transazione, non i dettagli della carta sottostante.
Le chiavi sensibili e le credenziali di pagamento sono archiviate e processate dentro il Secure Enclave, un coprocessore isolato hardware.
L'autorizzazione è legata alla verifica dell'utente:
La tua app riceve solo un segnale di successo o fallimento dal foglio di sistema; non accede mai ai dati biometrici o al contenuto del Secure Enclave.
Ogni transazione Apple Pay utilizza:
Reti ed emittenti validano questi valori per aiutare a rilevare clonazioni, replay e manomissioni.
Apple Pay può ridurre significativamente l'ambito PCI DSS della tua app perché:
Tuttavia:
Per linee guida formali, consulta la tua banca acquisitrice, il PSP e un qualificato security assessor.
Apple Pay riduce il rischio, ma integrazioni distratte possono ri‑introdurre esposizioni.
Consigli pratici:
Rispettando questi confini, sfrutti le protezioni di Apple Pay mantenendo il carico di conformità gestibile.
Testare a fondo è l'unico modo per essere certi che l'integrazione Apple Pay si comporti correttamente per i clienti reali. Questo inizia con un setup sandbox adeguato e un piano chiaro su cosa testare.
In Apple Developer / App Store Connect, crea account sandbox tester sotto Users and Access → Sandbox. Questi Apple ID speciali vengono usati sui dispositivi di test per simulare utenti reali senza addebitare carte vere.
Sui dispositivi di test:
Usa tester sandbox distinti per profili utente diversi (regioni, valute, circuiti) così puoi riprodurre edge case in modo coerente.
Il Simulator iOS supporta test Apple Pay di base, utile per validazioni UI e sviluppo iniziale. Puoi simulare autorizzazioni e verificare che il flusso di PKPaymentAuthorizationController funzioni.
Tuttavia, testa sempre su dispositivi fisici perché solo loro forniscono:
Tratta il Simulator come comodità, non come sostituto.
Copri almeno i seguenti flussi end‑to‑end (client e server):
Usa numeri di carta di test e trigger specifici del gateway per forzare rifiuti e codici d'errore.
Registra informazioni sufficienti per tracciare i problemi, ma mai dati di pagamento sensibili. Evita:
Invece, logga:
created → authorized → captured → failed)Correlare i log client con quelli server tramite un correlation ID condiviso passato dall'app al backend.
Durante i cicli di test, tieni d'occhio:
Se vedi errori intermittenti o autorizzazioni lente, verifica sia lo stato del gateway sia quello di Apple prima di considerare un bug di integrazione.
Un design attento può trasformare Apple Pay in un driver di conversione. Piccole decisioni su posizionamento e copy influenzano molto l'uso.
Usa Apple Pay dove l'intento di acquisto è più forte:
Evita di nascondere Apple Pay dietro ulteriori tap come “Altre opzioni di pagamento”. Ogni passo in più riduce l'uso.
Offri Apple Pay come express checkout da:
Quando usi Apple Pay come checkout espresso, rendi chiaro che spedizione e contatti saranno gestiti durante l'autorizzazione Apple Pay.
Segui le Human Interface Guidelines di Apple:
Evita colori o icone personalizzati che riducano il riconoscimento o violino le regole di brand.
Lascia che Apple Pay faccia il lavoro pesante:
L'obiettivo è un singolo tocco decisivo, non un funnel multi‑schermo.
Il modo più rapido per perdere una vendita è uno stato di errore confuso. Pianifica gli errori con:
Registra i dettagli degli errori in modo silenzioso per il team, ma mostra all'utente solo le informazioni necessarie per capire cosa fare dopo.
La maggior parte dei problemi Apple Pay deriva da una cattiva configurazione.
Controlla che il merchant ID usato nel codice corrisponda esattamente a quello nel portale Apple Developer e nelle impostazioni del gateway. Anche un singolo carattere sbagliato (o un merchant ID sandbox in produzione) interrompe il flusso.
Verifica poi entitlements e capability:
Se i pulsanti Apple Pay non appaiono o il foglio non si presenta, la configurazione è il sospettato principale.
Apple Pay può essere disponibile in alcuni Paesi, emittenti o dispositivi ma non in altri.
Usa PKPaymentAuthorizationController.canMakePayments() e canMakePayments(usingNetworks:) prima di mostrare il pulsante Apple Pay. Se ritornano false, nascondi il pulsante e fornisci una spiegazione chiara più un metodo di pagamento alternativo.
Quando gli utenti segnalano che le carte “non sono supportate”, verifica:
I fallimenti di merchant validation spesso si manifestano con il foglio Apple Pay che si chiude rapidamente o non appare.
Per le app native, sono spesso causati da:
Sul server o endpoint di validazione, logga:
Questi log di solito indicano immediatamente l'elemento mal configurato.
Non tutti i fallimenti sono tecnici; molti sono rifiuti dall'emittente.
Ispeziona sempre la risposta del gateway. Distingui tra:
Mappa queste categorie in messaggi utente amichevoli come:
Evita di esporre codici di errore raw del gateway o dettagli tecnici non necessari.
Per mantenere Apple Pay stabile in produzione, investi in logging strutturato attorno a ogni tentativo di pagamento:
Configura dashboard e alert per picchi di rifiuti, errori di merchant validation o timeout. Correlare eventi client con log server aiuta a tracciare rapidamente dove avviene il problema.
Questo livello di osservabilità riduce drasticamente i tempi di debug in caso di problemi in produzione.
Una volta che Apple Pay è live nella tua app mobile, devi dimostrare che migliora il checkout, non solo che è moderno. Significa tracciare gli eventi giusti, osservare metriche chiave e condurre esperimenti strutturati.
Inizia con un funnel chiaro e registra eventi a ogni passo:
Correla questi eventi con contesto:
Questo ti fa capire dove gli utenti abbandonano e se i problemi sono UX (cancellazioni), tecnici (autenticazioni) o backend (catture).
Un set di metriche focalizzate facilita valutare l'impatto:
Monitora queste metriche nel tempo e per versione dell'app per vedere se integrazione e cambi UX stanno avendo effetto.
Esegui esperimenti per ottimizzare l'impatto di Apple Pay:
Misura adozione, tasso di successo, tempo per pagare e conversione. Anche piccoli cambi di layout possono portare guadagni significativi.
Integra analytics con attenzione per rispettare le garanzie di privacy di Apple Pay e le normative:
Piattaforme analytics principali (Mixpanel, Amplitude, Firebase) possono gestire questi eventi purché i payload non contengano dettagli sensibili.
Le informazioni di Apple Pay vanno oltre quel singolo pulsante:
Col tempo, queste misure aiutano a perfezionare non solo Apple Pay ma l'intero checkout, rendendo ogni passo più veloce, chiaro e affidabile per gli utenti.
Supportare Apple Pay raramente si limita a una singola app iOS. Gli utenti si aspettano coerenza attraverso dispositivi e canali, e le tue scelte d'implementazione dovrebbero tenerne conto.
Le app native usano PKPaymentAuthorizationController e passano i token direttamente al backend. Questo offre:
Apple Pay sul web (Safari) usa JavaScript e Payment Request API. È ideale quando:
Per molti team, il punto di equilibrio è: Apple Pay nativo nell'app, Apple Pay sul web in Safari, con pipeline di pagamento backend condivisa.
Se supporti anche Google Pay, PayPal o wallet simili, allinea il flusso ad alto livello:
Così cambiare dispositivo o metodo non sembra imparare un sistema nuovo.
Per React Native, Flutter e simili, normalmente ti appoggi a:
Testa su iPhone, iPad e Apple Watch quando rilevante:
Punta a un design system e a una logica di checkout unici che spazino iOS, web e altre piattaforme, con sottili layer d'integrazione per canale.
Mantenere Apple Pay sano è più questione di manutenzione disciplinata che di grandi riscritture.
Apple Pay si basa su merchant ID e certificati Payment Processing che scadono.
Crea una mappa di responsabilità: chi possiede l'account Apple Developer, dove sono i certificati e come vengono usati in CI/CD e sui server.
Poi:
Ogni major release iOS dovrebbe innescare un ciclo di test per i flussi Apple Pay su build beta e finali. Focalizzati su:
Monitora:
Pianifica una revisione del design almeno annuale per allineare wording, posizionamento e accessibilità alle ultime indicazioni.
Circuiti, valute e regioni supportate cambiano nel tempo. Rendili configurabili:
Coordina con il gateway quando aggiungono circuiti o metodi locali e aggiorna il tuo PKPaymentRequest di conseguenza.
Per cambi gateway, ristrutturazioni app o aggiornamenti formato token:
Documenta questi flussi così i nuovi membri del team possono mantenerli senza dover reverse‑engineerare.
Aspettati tokenizzazione più profonda con i circuiti, ricevute e aggiornamenti ordine più ricchi in Wallet e legami più stretti tra in‑app, web e in‑store Apple Pay. Funzionalità come Tap to Pay on iPhone e opzioni di finanziamento regionali continueranno ad espandersi, quindi progetta l'integrazione in modo configurabile per adottare nuove capacità senza rifare il flusso di base.
Apple Pay è il portafoglio digitale di Apple che permette agli utenti di pagare con le carte memorizzate su iPhone, iPad, Apple Watch o Mac.
Nelle app mobili, sostituisce l'inserimento manuale della carta con un foglio di sistema sicuro dove l'utente conferma il pagamento tramite Face ID, Touch ID o codice. L'app riceve un token di pagamento crittografato invece dei dati grezzi della carta, che invia al tuo backend e al gateway di pagamento per completare l'addebito.
Questo rende il checkout più veloce, riduce gli errori e mantiene i numeri di carta fuori dall'infrastruttura della tua app.
Dovresti aggiungere Apple Pay quando:
Apple Pay funziona meglio come opzione aggiuntiva accanto a carte, PayPal e altri metodi. Non rimuovere gli altri metodi di pagamento: offri Apple Pay come via più veloce per gli utenti idonei.
Al minimo hai bisogno di:
Su iOS devi:
Il dispositivo crea un token di pagamento crittografato che contiene:
Questo token è cifrato per il tuo payment processor, quindi la tua app e il backend lo trattano come un blob opaco. Il backend lo inoltra al gateway, che lo decifra, invia una richiesta di autorizzazione alla rete e all'emittente e restituisce successo o errore.
Tu non vedi mai il PAN reale o le chiavi crittografiche; vedi solo metadati e stato della transazione.
Il tuo backend dovrebbe:
Non cercare di decifrare i token da solo né conservarli a lungo. Lascia che il tuo gateway PCI‑compliant gestisca la parte sensibile del processamento.
I motivi più comuni sono:
Controlla prima la configurazione nel portale Apple Developer, gli entitlements in Xcode e le impostazioni del gateway, poi ispeziona i log server per gli errori di merchant validation e i codici gateway.
Per testare Apple Pay in sicurezza:
Usa il Simulator per controlli UI rapidi, ma valida sempre su dispositivi fisici per testare Wallet, biometria e condizioni di rete reali.
Per migliorare la conversione:
Traccia Apple Pay come un funnel a sé. Segnali utili includono:
Esegui A/B test su posizionamento del pulsante e messaggi, e confronta tassi di completamento e cancellazione degli utenti Apple Pay con altri metodi per verificare l'impatto reale.
Devi anche operare in regioni e con banche che supportano Apple Pay e assicurarti che la tua categoria merceologica e i prodotti rispettino le regole di Apple.
PKPaymentRequest con merchant identifier, country, currency, supported networks e summary items.PKPaymentButton dove l'utente decide di pagare.PKPaymentAuthorizationController con la richiesta.didAuthorizePayment inviare payment.token al tuo backend per l'elaborazione..success o .failure e chiudere il foglio.La maggior parte del lavoro pesante (biometria, creazione del token) è gestita dall'interfaccia di sistema.
PKPaymentButtonQuesti pattern riducono l'attrito e fanno percepire Apple Pay come una scorciatoia rapida e affidabile.