Registrazione di un'app per pagamenti basata sul web

Scopri come configurare un'app di pagamento basata sul web durante la registrazione.

Le app di pagamento basate sul web sono app web progressive (PWA) ed eseguita sopra il servizio worker. La il service worker in un'app di pagamento gioca un ruolo importante in quanto acquisisce i pagamenti richieste da un commerciante, avvia l'app di pagamento e agisce da mediatore la comunicazione con il commerciante.

Per configurare un'app per pagamenti basata sul web, devi registrare il metodo di pagamento disponibile e un service worker. Puoi configurare la tua app per pagamenti basata sul web in modo dichiarativo con un file manifest dell'app web.

Supporto browser

I pagamenti web sono costituiti da diverse tecnologie e dal supporto dipende dal browser.

Cromo Safari Firefox
Desktop Android Desktop Dispositivi mobili Computer/dispositivi mobili
API Payment Request
API Payment Gestori
App per pagamenti iOS/Android ✔* ✔*

Configurare un'app di pagamento con un file manifest dell'app web

Per configurare in modo dichiarativo la tua app di pagamento basata sul web, pubblica un'app web del file manifest.

Le seguenti proprietà nel file manifest dell'app web sono pertinenti per le app di pagamento basate sul web:

  • name
  • icons
  • serviceworker
    • src
    • scope
    • use_cache

Consulta l'articolo Configurare un pagamento. [metodo_di_ritiro] per assicurarti che il file manifest del metodo di pagamento rimandi al file manifest dell'app web correttamente.

Registrazione di un service worker just-in-time (JIT)

La registrazione JIT richiede solo la pubblicazione dell'app web file manifest e senza programmazione aggiuntiva. Se hai già configurato il file manifest dell'app web correttamente, dovrebbe essere tutto pronto. Il browser gestirà e riposare.

Debug di un'app per pagamenti basata sul web

Durante lo sviluppo del frontend di un'app di pagamento basata sul web, probabilmente passerai da una contesto del commerciante e contesto dell'app di pagamento. I seguenti suggerimenti per il debug ti aiuteranno la tua esperienza di sviluppo su Chrome.

Sviluppo su un server locale

Quale server utilizzi per lo sviluppo? Molti sviluppatori tendono a usare localhost o un ambiente server interno all'azienda, il che può essere complesso le funzionalità potenti del browser tendono a richiedere un ambiente sicuro (HTTPS) e un certificato valido. L'API Payment Request e l'API Payment Gestori nessuna eccezione e i localhost o i server interni dell'azienda di solito non dispongono un certificato valido.

La buona notizia è che alcuni browser, incluso Chrome, esentano certificati per http://localhost per impostazione predefinita. Sempre in Chrome, puoi escludere il certificato avviando un'istanza di Chrome. Ad esempio, per escludere requisito di http://*.corp.company.com, utilizza i seguenti flag:

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Windows

chrome.exe --ignore-certificate-errors --unsafely-treat-insecure-origin-as-secure=http://*.corp.company.com

Scopri di più sull'esecuzione di Chrome con un flag di runtime nella pagina Esegui Chromium con e i flag facoltativi.

Port forwarding di un server locale

Puoi effettuare il port forwarding del server web locale a un dispositivo Android utilizzando DevTools e testane il funzionamento da un browser mobile. Per scoprire come fare, dai un'occhiata ad Access Local Server.

Debug remoto di un sito web su Chrome per Android da DevTools per il desktop

Puoi anche eseguire il debug di Chrome per Android in DevTools. Per scoprire come fare, consulta la Guida introduttiva al debug remoto di Android Dispositivi.

Logging degli eventi del gestore dei pagamenti

DevTools può visualizzare l'API Payment Gestori eventi per lo sviluppo locale. Apri DevTools nel contesto del commerciante e vai alla "Gestore dei pagamenti" nel riquadro Applicazione. Seleziona "Mostra eventi". da altri domini" e fai clic sul pulsante "Registra" pulsante per iniziare ad acquisire eventi inviati al service worker che gestisce i pagamenti.

Uno screenshot del logging degli eventi del gestore dei pagamenti.
. Registrazione degli eventi del gestore dei pagamenti.

Passaggi successivi

Il passaggio successivo consiste nell'imparare in che modo il service worker può orchestrare un pagamento durante l'esecuzione della transazione.