Découvrez comment configurer une application de paiement Web lors de l'inscription.
Les applications de paiement Web sont des progressive web apps (PWA) qui s'exécutent sur des service workers. Le service worker d'une application de paiement joue un rôle important, car il capture les demandes de paiement d'un marchand, lance l'application de paiement et sert d'intermédiaire pour la communication avec le marchand.
Pour configurer une application de paiement Web, vous devez enregistrer les modes de paiement disponibles et un service worker. Vous pouvez configurer votre application de paiement Web de manière déclarative avec un fichier manifeste d'application Web.
Prise en charge des navigateurs
Les paiements Web sont composés de plusieurs technologies différentes. Leur compatibilité dépend du navigateur.
Configurer une application de paiement avec un fichier manifeste d'application Web
Pour configurer votre application de paiement Web de manière déclarative, diffusez un fichier manifeste d'application Web.
Les propriétés suivantes du fichier manifeste de l'application Web sont pertinentes pour les applications de paiement Web :
nameiconsserviceworkersrcscopeuse_cache
Consultez Configurer un mode de paiement pour vous assurer que le fichier manifeste de votre mode de paiement pointe correctement vers le fichier manifeste de votre application Web.
Enregistrer un service worker juste-à-temps (JIT)
L'enregistrement JIT ne nécessite que la diffusion du manifeste de l'application Web et aucun codage supplémentaire. Si vous avez déjà configuré le fichier manifeste de votre application Web et que vous le diffusez correctement, vous n'avez en principe rien d'autre à faire. Le navigateur s'occupe du reste.
Déboguer une application de paiement Web
Lorsque vous développez le frontend d'une application de paiement Web, vous passez probablement du contexte du marchand à celui de l'application de paiement. Les conseils de débogage suivants vous aideront à développer sur Chrome.
Développer sur un serveur local
Quel serveur utilisez-vous pour le développement ? De nombreux développeurs ont tendance à utiliser localhost ou un environnement de serveur interne à l'entreprise, ce qui peut être problématique, car les fonctionnalités puissantes du navigateur ont tendance à nécessiter un environnement sécurisé (HTTPS) et un certificat valide. Les API Payment Request et Web-based Payment Handler ne font pas exception, et les serveurs localhost ou internes à l'entreprise ne sont généralement pas fournis avec un certificat valide.
La bonne nouvelle, c'est que certains navigateurs, y compris Chrome, exemptent par défaut les certificats pour http://localhost. Dans Chrome, vous pouvez également être exempté de l'exigence de certificat en lançant une instance Chrome. Par exemple, pour exempter l'exigence de http://*.corp.company.com, utilisez les indicateurs suivants :
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
Pour en savoir plus sur l'exécution de Chrome avec un flag d'exécution, consultez Exécuter Chromium avec des flags.
Rediriger le port d'un serveur local
Vous pouvez transférer le serveur Web local vers un appareil Android à l'aide des outils pour les développeurs Chrome et tester son fonctionnement à partir d'un navigateur mobile. Pour savoir comment procéder, consultez Accéder aux serveurs locaux.
Déboguer à distance un site Web sur Android Chrome à partir des outils de développement pour ordinateur
Vous pouvez également déboguer Android Chrome dans les outils pour les développeurs sur ordinateur. Pour savoir comment procéder, consultez Premiers pas avec le débogage à distance des appareils Android.
Journalisation des événements du gestionnaire de paiement
Les outils de développement peuvent afficher les événements de l'API Payment Handler basée sur le Web pour faciliter le développement local. Ouvrez les outils de développement dans le contexte du marchand et accédez à la section "Payment Handler" (Gestionnaire de paiement) du volet Application. Cochez "Afficher les événements d'autres domaines", puis cliquez sur le bouton "Enregistrer" pour commencer à capturer les événements envoyés au service worker qui gère les paiements.
Étapes suivantes
L'étape suivante consiste à découvrir comment le service worker peut orchestrer une transaction de paiement au moment de l'exécution.