Tap to Pay su iPhone o Android e Stripe Terminal

Tap to Pay consente agli utenti di accettare pagamenti contactless di persona con un dispositivo consumer compatibile e l'SDK Stripe Terminal. È necessario avere dimestichezza con l'SDK di Terminal ed esperienza con Android o iOS. Consulta la nostra documentazione di integrazione tecnica per iOS e per Android.

In quali Paesi è disponibile Tap to Pay?

Per scoprire in quali Paesi è disponibile Tap to Pay, fai clic qui oppure consulta la nostra documentazione tecnica tramite il link in alto.

Se vuoi utilizzare Tap to Pay nel tuo Paese e al momento non è supportato, contattaci. Ti faremo sapere non appena saremo in grado di offrire questo servizio nel tuo Paese.

Quali requisiti devono avere i dispositivi per l'integrazione di Tap to Pay?

Fai clic qui per conoscere i requisiti dei dispositivi per Tap to Pay su iPhone.

Nota: gli iPad non hanno funzionalità di lettura NFC, quindi al momento non sono supportati.

Fai clic qui per conoscere i requisiti dei dispositivi per Tap to Pay su Android.

Fai clic qui per un elenco dei dispositivi Android supportati con interfacce utente personalizzate.

Quali sono i metodi di pagamento supportati con Tap to Pay?

Qui puoi trovare la documentazione sui metodi di pagamento disponibili per lettore.

Quanto costa?

Consulta la pagina delle tariffe per conoscere le tariffe attualmente in vigore.

Le transazioni Tap to Pay vengono indirizzate come transazioni con carta presente?

Sì. Le transazioni Tap to Pay possono essere identificate nella Dashboard come pagamenti con "Carta presente", come tutte le altre transazioni Terminal. Come con Stripe Terminal, gli esercenti che utilizzano Tap to Pay per accettare carte di pagamento non sono responsabili di eventuali contestazioni di tipo fraudolento presentate per tali transazioni.

Tap to Pay su Stripe Terminal e conformità alle norme PCI

Stripe Terminal, incluso Tap to Pay, fornisce per impostazione predefinita la crittografia E2EE. Gli utenti che utilizzano Tap to Pay hanno accesso a un documento SAQ C precompilato direttamente nella Dashboard nelle impostazioni di conformità.

Nota: Tap to Pay non è supportato per l'uso con la crittografia P2PE.

Esiste un modo per identificare le transazioni Tap to Pay tramite la Dashboard? Tap to Pay offre le stesse funzionalità degli altri dispositivi Stripe Terminal?

Le transazioni Tap to Pay possono essere identificate nella Dashboard come pagamenti con "Carta presente", come tutte le altre transazioni Terminal. Al momento non offriamo la funzionalità per distinguere le transazioni Tap to Pay dagli altri addebiti con carta presente nella Dashboard. Gli utenti continueranno ad avere accesso alle stesse funzionalità della Dashboard, come reportistica, rimborsi ecc., a esclusione dei dispositivi hardware. I dispositivi Tap to Pay attualmente non possono essere monitorati nella Dashboard per scopi di gestione del parco lettori.

Esiste un modo per riconciliare il numero di dispositivi attivi in un account Stripe con la fatturazione Tap to Pay su iPhone?

Al momento non offriamo questa funzionalità.

Il PIN è supportato tramite Tap to Pay per le transazioni che superano i limiti contactless?

Tap to Pay su iPhone supporta l'accettazione del PIN nelle versioni 2.23 e successive dell'SDK di Terminal per iOS.

Tap to Pay su Android al momento non supporta il PIN. Se un utente tenta di addebitare un importo superiore al limite contactless, il titolare della carta non sarà in grado di inviare il PIN di riserva del suo conto di pagamento per completare la transazione.

In alternativa, gli utenti possono valutare le opzioni di backup, ad esempio un terminale di pagamento tradizionale in loco come opzione predefinita o la visualizzazione di un codice QR e la richiesta al cliente di scansionarlo e di effettuare il pagamento con una transazione CNP.

I limiti per i pagamenti contactless regionali sono riportati nella nostra pagina di domande e risposte di assistenza. Nota: in genere non esistono limiti di transazioni per i wallet come Apple Pay e Google Pay.

È possibile riscuotere i pagamenti utilizzando un lettore di carte Terminal fisico come opzione di backup?

Non tutti i clienti dispongono di un metodo di pagamento contactless. In questo caso o nell'eventualità di un rifiuto, gli utenti possono continuare a riscuotere i pagamenti passando da Tap to Pay a un lettore di carte Terminal. Tuttavia, gli utenti possono avere solo una connessione attiva a un lettore alla volta. Dovrai quindi scollegare il lettore di carte se è già collegato.

Tap to Pay funziona sui tablet?

Tap to Pay richiede la tecnologia NFC non disponibile su molti tablet.

Tap to Pay su iPhone non funziona sugli iPad poiché attualmente non supportano la tecnologia NFC.

Tap to Pay su Android funziona sui tablet Android conformi ai nostri requisiti per i dispositivi.

Esiste un modo per identificare il nome del titolare della carta per le transazioni Tap to Pay?

In genere il nome del titolare della carta non è disponibile per i pagamenti contactless. Consulta la documentazione di riferimento dell'API per capire quali dati relativi alle transazioni sono disponibili per le transazioni Terminal, compreso Tap to Pay.


Domande sull'integrazione

Un utente deve eseguire l'integrazione con l'SDK di Terminal?

Sì, gli utenti devono aver completato l'integrazione con l'SDK di Terminal prima di integrare Tap to Pay. Per le specifiche, consulta la documentazione su iOS o Android.

Quando si crea l'integrazione di Terminal, è necessario installare il relativo SDK prima degli SDK di Tap to Pay?

Sì. Per accedere alla funzionalità Tap to Pay, gli utenti devono installare due set di SDK. Gli utenti devono aver completato l'integrazione con l'SDK di Terminal prima di eseguire l'integrazione con gli SDK di Tap to Pay. Per le specifiche, consulta la nostra documentazione su iOS o Android.

Terminal offre un'applicazione POS mobile predefinita che gli utenti possono sfruttare?

Puoi accettare i pagamenti Tap to Pay di persona utilizzando l'app della Dashboard Stripe.

Se un utente porta un dispositivo Tap to Pay in un altro Paese non supportato (ad esempio dagli Stati Uniti al Brasile), la funzionalità verrà bloccata automaticamente? È necessario impostare ulteriori restrizioni sull'applicazione in base alla località?

Durante le transazioni Terminal raccogliamo dati GPS per la verifica della località. Tap to Pay non funziona all'estero. Il nostro sistema rifiuta automaticamente la transazione se rileva un nuovo Paese. Non sono necessarie ulteriori operazioni di integrazione per questa funzionalità.

Un utente può simulare transazioni Tap to Pay nel simulatore di Terminal?

Sì, attualmente gli utenti possono simulare il flusso di riscossione dei pagamenti nei simulatori iOS e Android.

Tap to Pay è compatibile con le app create in React Native?

Sì, Tap to Pay è supportato nelle applicazioni basate su React Native.

La possibilità di salvare i dati della carta per il riutilizzo online è compatibile con le transazioni Tap to Pay?

Sì. Tap to Pay supporta la funzionalità di Terminal esistente che consente di salvare i dati della carta per poterli riutilizzare online in futuro. La funzionalità Salva carta si applica solo alle carte fisiche e non ai wallet mobili.

Il pagamento di mance è compatibile con Tap to Pay?

Il pagamento di mance sul lettore (consulta la nostra documentazione qui) non è compatibile con Tap to Pay. Gli utenti sono liberi di implementare la propria schermata di pagamento delle mance prima di riscuotere il pagamento oppure possono utilizzare il flusso post-autorizzazione (vedi la descrizione qui) per aggiungere la mancia dopo la riscossione del pagamento. Tieni presente che il pagamento della mancia post-autorizzazione deve essere completato entro 3 minuti dalla riscossione del pagamento. A causa di questa funzione, suggeriamo di presentare il pagamento della mancia prima della riscossione del pagamento per garantire un'esperienza utente più fluida.

La modalità offline è compatibile con Tap to Pay?

No. La modalità offline non è compatibile con Tap to Pay.

Esiste un modo per limitare i tipi di carte al livello Tap to Pay?

No. Non offriamo la funzionalità per limitare le carte al livello Tap to Pay.

Le carte di test di Stripe funzionano con Tap to Pay?

Sì. Consulta qui la nostra documentazione.

Che cosa significa l'errore on_behalf_of?

Se usi il parametro on_behalf_of nel tuo PaymentIntent, assicurati di fornire l'ID dell'account connesso in SCPLocalMobileConnectionConfiguration. Per tutti i dettagli, consulta la nostra documentazione su iOS o Android.

Posso personalizzare l'interfaccia utente della schermata di tocco?

No. Al momento non puoi personalizzare l'interfaccia utente di Tap to Pay né su iOS, né su Android.

L'utente dovrà personalizzare le aree di tocco nell'integrazione per ogni tipo di dispositivo?

Per Tap to Pay su Android, l'interfaccia utente della transazione viene gestita da Stripe. La prima volta che il telefono si connette come lettore, l'utente vedrà la schermata "predefinita" di Stripe. Per le transazioni successive, la richiesta dell'area di tocco sarà personalizzata in base alla posizione del chip NFC su ogni dispositivo (ad es. in alto a destra, in alto a sinistra, al centro). Se l'area di tocco non è nota, verrà utilizzata la schermata predefinita. Non è necessaria nessuna operazione di integrazione per personalizzare le aree di tocco.

Qual è il livello di impegno richiesto per l'integrazione con questa libreria?

Una volta che l'utente ha completato l'integrazione standard con gli SDK Terminal per iOS o Android, le rispettive integrazioni per Tap to Pay su iOS o Android saranno piuttosto semplici e immediate. In media un ingegnere impiega meno di due settimane per completarle.


Domande relative a Tap to Pay su iPhone

Per le domande frequenti relative a Tap to Pay su iPhone, consulta le Domande frequenti per esercenti di Apple.

Come viene gestita l'attivazione iniziale per i dispositivi iPhone?

Agli utenti vengono mostrati i Termini e condizioni di Tap to Pay su iPhone di Apple la prima volta che si connettono al lettore locale. Per registrarsi su Apple, gli esercenti devono specificare un ID Apple valido che rappresenti l'attività prima di accettare i termini presentati da Apple. Tieni presente che questa procedura deve essere eseguita solo una volta per ogni account Stripe. Verrà ignorata per tutte le connessioni successive con lo stesso account Stripe su tutti i dispositivi.

Per ulteriori informazioni sul collegamento degli esercenti, vai alla sezione Tap to Pay su iPhone - Informazioni sull'attività nelle Domande frequenti su Tap to Pay su iPhone di Apple.

Prima di utilizzare un dispositivo per leggere le carte di pagamento, devi configurarlo adeguatamente. La configurazione deve essere effettuata su ogni dispositivo che usa Tap to Pay su iPhone per la prima volta. La configurazione iniziale di un dispositivo può richiedere fino a due minuti. Gli eventuali aggiornamenti di configurazione successivi richiedono generalmente pochi secondi. Per ulteriori informazioni, consulta la sezione "Gestire la configurazione del dispositivo".

Le fasi di accettazione dei Termini e condizioni di Tap to Pay su iPhone sono gestite in maniera trasparente dall'SDK di Terminal?

I Termini di servizio di Tap to Pay su iPhone verranno visualizzati automaticamente al momento della prima connessione del lettore locale per un determinato account. L'operazione viene gestita implicitamente dall'SDK di Terminal e non è necessario ulteriore codice per avviare il flusso dei Termini di servizio.

In che momento avvengono le fasi di accettazione dei Termini e condizioni di Tap to Pay su iPhone?

I Termini di servizio di Tap to Pay su iPhone vengono visualizzati al momento della prima connessione del lettore locale mobile (connectLocalMobileReader) per un determinato account secondario connesso. Una volta accettati, i Termini di servizio non vengono più mostrati per tale account.

La documentazione di Apple cita un requisito per cui "Solo un utente amministratore può accettare i Termini e condizioni per conto di un esercente". L'esercente deve fare qualcosa per indicare che un utente è autorizzato ad accettare i Termini e condizioni?

Consigliamo agli esercenti di fornire indicazioni durante l'attivazione degli utenti per assicurarsi che sia l'esercente autorizzato ad accettare i termini.

Le best practice consigliano di collegare il lettore in background all'avvio dell'app. Come faccio a evitare che i Termini e condizioni di Tap to Pay su iPhone vengano visualizzati quando gli utenti lanciano l'app per la prima volta?

Gli esercenti possono impostare il parametro tosAcceptancePermitted su NO in connectionConfig quando richiamano connectLocalMobileReader in background. Se un utente non ha ancora accettato i Termini e condizioni, questo collegamento non riuscirà con un'eccezione. Consigliamo agli esercenti di gestire questa eccezione e di guidare l'utente verso un flusso di attivazione esplicito separato in cui viene richiamato connectLocalMobileReader con il parametro abilitato e in cui l'esercente autorizzato può accettare i Termini e condizioni.

Quando viene mostrata la schermata TTP di Apple con la ragione sociale, in che modo può essere configurata per le piattaforme? È specifica per il nome commerciale esatto dell'account connesso?

Le piattaforme possono configurare qui la ragione sociale. Utilizziamo come predefinito il nome dell'account connesso, ma se vuoi puoi sostituirlo. Assicurati di specificare la ragione sociale corretta.

Stripe supporta implementazioni in cui un esercente utilizza direttamente l'API proximityReader di Apple?

Al momento non supportiamo direttamente l'API proximityReader di Apple. L'uso corretto di proximityReader si basa su una relazione diretta con Apple al fine di emettere token di connessione con il lettore.

Sono disponibili opzioni per personalizzare l'interfaccia utente di Tap to Pay su iPhone?

No. L'interfaccia utente di Tap to Pay su iPhone viene avviata quando la tua applicazione POS è pronta per riscuotere un pagamento. Non può essere personalizzata.

Occorre impostare una posizione per il dispositivo mobile quando si utilizza Tap to Pay su iPhone? È un requisito di Apple?

Per tutti i lettori hardware Terminal deve essere impostata una Posizione. Si tratta di un requisito esistente che si applica anche a Tap to Pay su iPhone.

Come faccio a ottenere l'approvazione di Apple per la mia app iOS?

La tua applicazione Tap to Pay su iPhone sarà soggetta alla procedura di revisione standard dell'App Store di Apple. Quando crei la tua app, tieni presente le linee guida di Apple per l'interfaccia utente di Tap to Pay.

Come faccio a richiedere e configurare l'autorizzazione necessaria per supportare Tap to Pay su iPhone?

Puoi richiedere l'autorizzazione direttamente sul sito per sviluppatori di Apple qui.


Domande relative a Tap to Pay su Android

Come faccio a sapere se il mio telefono supporta la tecnologia NFC?

Per sapere se il tuo dispositivo Android supporta la tecnologia NFC, controlla le impostazioni del telefono. Se l'opzione NFC è presente, significa che è supportata. Assicurati solo che sia attiva per poter utilizzare Tap to Pay.

Quando sarà supportato Discover?

Al momento non abbiamo tempistiche per il supporto di Discover.

Come faccio a essere sempre al corrente delle eventuali modifiche all'SKD?

Iscriviti a terminal-announce@lists.stripe.com. Il nostro obiettivo è dare almeno 3 mesi di preavviso per eventuali modifiche future ma, se vengono rilevate vulnerabilità di sicurezza critiche, potrebbero essere necessari aggiornamenti più urgenti dell'SDK.

Inoltre, per Tap to Pay su Android sono disponibili registri delle modifiche pubblici.


Assistenza

Ho domande sul mio account ID Apple, sull'account Apple Business Register (ABR) e/o sull'hardware iPhone.

Gli utenti possono trovare assistenza per problemi relativi ad Apple nelle seguenti risorse: