Documentazione

1Apple Pay

Apple Pay consente ai vostri clienti di effettuare acquisti sicuri e senza contatto con le carte di credito e di debito Visa e Mastercard che aggiungono a Wallet.

Apple Pay utilizza funzioni di sicurezza integrate nell’hardware e nel software dei dispositivi Apple per contribuire a proteggere le transazioni. Inoltre, per utilizzare Apple Pay, i clienti devono avere impostato un codice di accesso sui propri dispositivi e, facoltativamente, Face ID o Touch ID.

Apple Pay è inoltre progettato per proteggere le informazioni personali dei clienti. Apple non memorizza i numeri originali delle carte di credito, di debito o prepagate utilizzate con Apple Pay e non vi ha accesso. E quando i vostri clienti utilizzano Apple Pay con carte di credito, di debito o prepagate, Apple non conserva alcuna informazione sulle transazioni che possa essere ricondotta a loro. Le transazioni restano tra il cliente, voi in qualità di esercente e la banca o l’emittente della carta del cliente.

1.1Come attivare Apple Pay?

Per consentire ai vostri clienti di pagare tramite Apple Pay, dovete soddisfare alcuni requisiti:

  • Dovete configurare un gestore che supporti Apple Pay e attivare i connettori dei circuiti di carte di credito che devono essere disponibili.

1.1.1Configurare un gestore

Navigate su Space > Pagamento > Configurazione > Gestori per configurare il gestore da utilizzare per elaborare i pagamenti Apple Pay. I gestori supportati sono Worldline e Concardis. Assicuratevi di attivare i connettori dei circuiti di carte di credito che devono essere disponibili per il gestore. I circuiti supportati sono Visa e Mastercard.

1.1.2Attivare Apple Pay

Apple Pay è attivato per impostazione predefinita, ma potete disattivarlo nel vostro spazio: andate su Space > Impostazioni > Portafogli e aprite Apple Pay.

2Apple Pay nell’Express Checkout

L’Express Checkout mostra un pulsante Apple Pay direttamente sulle vostre pagine prodotto e carrello, in modo che i clienti possano pagare senza compilare un modulo di checkout. Apple convalida ogni pagamento di questo tipo rispetto al dominio della pagina che mostra il pulsante. Ciascuno di questi domini deve quindi essere registrato presso Apple e servire un file di verifica. Apple Pay nel checkout standard viene eseguito su una pagina di pagamento e non richiede nulla di tutto ciò.

La creazione della sessione, la visualizzazione del widget e l’elaborazione del pagamento funzionano allo stesso modo per tutti i wallet e sono descritte nella guida all’integrazione dell’Express Checkout. I passaggi seguenti riguardano ciò che Apple Pay richiede in aggiunta.

2.1Requisiti

  • Un connettore attivato che supporti sia Apple Pay sia l’Express Checkout.

  • Apple Pay attivato nel vostro spazio.

  • Ogni dominio del negozio che mostra il pulsante Apple Pay registrato presso Apple e che serve il file di verifica del dominio.

2.2Attivare l’Express Checkout

Navigate su Spazio > Impostazioni > Portafogli, aprite Apple Pay e impostate Checkout espresso su Attivo.

2.3Servire il file di verifica del dominio

Apple verifica un dominio recuperando un file da esso: ogni dominio del negozio deve quindi servire quel file prima che possiate registrarlo. Per tutti i vostri domini viene utilizzato lo stesso contenuto.

  1. Nella pagina di configurazione di Apple Pay (Spazio > Impostazioni > Portafogli, poi aprite Apple Pay), fate clic su Scarica il file di verifica nella sezione Verifica del dominio.

  2. Servite esattamente quel contenuto da ogni dominio del negozio, a questo preciso indirizzo:

    https://shop.example.com/.well-known/apple-developer-merchantid-domain-association
  3. Aprite l’indirizzo in un browser e verificate di vedere il contenuto di verifica, tramite HTTPS, senza reindirizzamento e senza autenticazione.

    Important
    Il fatto che il vostro browser raggiunga questo endpoint non dimostra che Apple possa farlo. Apple recupera il file dai propri server: un firewall, un filtro anti-bot, un blocco geografico o un proxy che risponde a voi ma non ad Apple lascia il dominio non verificato, senza che nel browser si veda nulla. Apple non segue reindirizzamenti e non raggiunge un indirizzo dietro un proxy. Apple pubblica gli intervalli di indirizzi da cui effettua la verifica in Consenti indirizzi IP di Apple per la verifica del dominio; autorizzateli se il vostro negozio limita l’accesso.

Pubblicare il file scaricato in quel percorso è il modo più semplice, ma non il solo: una route del vostro negozio che restituisce lo stesso contenuto funziona altrettanto bene. Apple guarda solo la risposta a quell’indirizzo, non come viene prodotta.

Note
Se pubblicate il contenuto come file, mantenete il nome esattamente come è stato scaricato, in minuscolo e senza estensione. Un file pubblicato come apple-developer-merchantid-domain-association.txt non viene trovato all’indirizzo richiesto da Apple e il dominio non può essere verificato. Se il browser o l’editor ha aggiunto un’estensione durante il salvataggio, rimuovetela.

Apple documenta lo stesso file e la stessa posizione in Configurare Apple Pay sul web. Non è necessario un account Apple Developer proprio: i vostri domini vengono registrati per voi tramite l’API Apple Pay per la registrazione di esercenti web, quindi sul vostro server resta solo servire quel contenuto a quell’indirizzo.

2.4Registrare i domini del negozio

Nella stessa pagina di configurazione di Apple Pay (Spazio > Impostazioni > Portafogli, poi aprite Apple Pay), sotto Domini registrati del negozio, fate clic su Gestisci i domini, aggiungete ogni dominio che mostrerà il pulsante Apple Pay e salvate.

  • Inserite il nome host esatto, ad esempio shop.example.com. I sottodomini sono domini distinti: se il vostro negozio è raggiungibile sia come example.com sia come www.example.com, inseriteli entrambi.

  • Ciò che salvate è l’elenco completo. Un dominio rimosso viene ritirato anche presso Apple e il pulsante Apple Pay smette di funzionare su di esso.

  • Il salvataggio registra immediatamente i domini presso Apple. Apple rifiuta un dominio che non serve ancora il contenuto a quell’indirizzo; l’errore viene mostrato nella pagina.

  • Dopo il salvataggio, fate clic sul pulsante Verifica lo stato per richiedere ad Apple l’elenco attuale dei domini del negozio registrati e verificare che la vostra modifica sia stata applicata.

2.5Verificare la registrazione

Sotto Domini registrati del negozio, nella pagina di configurazione di Apple Pay (Spazio > Impostazioni > Portafogli, poi aprite Apple Pay), accanto a Gestisci i domini si trova il pulsante Verifica lo stato. Chiede ad Apple quali domini sono registrati per il vostro spazio e aggiorna l’elenco mostrato nella pagina.

Utilizzatelo quando il pulsante Apple Pay non compare più su una pagina del negozio. Se un dominio manca dall’elenco, Apple lo ha ritirato, di solito perché l’indirizzo di verifica non funziona più. Per ripristinarlo:

  1. In un browser, aprite /.well-known/apple-developer-merchantid-domain-association sul dominio mancante.

  2. Se non vedete il contenuto di verifica, pubblicatelo di nuovo, oppure correggete ciò che ha smesso di servirlo nel vostro negozio.

  3. Aggiungete di nuovo il dominio sotto Gestisci i domini e salvate.