Enregistrer une application de paiement sur le Web

Découvrez comment configurer une application de paiement Web lors de l'enregistrement.

Les applications de paiement Web sont des progressive web apps (PWA) et s'exécutent sur le service nœuds de calcul. La Le service worker d'une application de paiement joue un rôle important dans la capture des données de paiement des requêtes d'un marchand, lance l'application de paiement et effectue la médiation la communication avec le marchand.

Pour configurer une application de paiement sur le Web, vous devez enregistrer le mode de paiement disponible de méthodes et d'un service worker. Vous pouvez configurer votre application de paiement Web de manière déclarative avec le fichier manifeste d'une application Web.

Prise en charge des navigateurs

Les paiements Web sont constitués de différentes technologies et la prise en charge dépend du navigateur.

Chrome Safari Firefox
Ordinateur Android Ordinateur Mobile Ordinateur/Mobile
API Payment Request
API Payment Handler
Application de paiement iOS/Android ✔* ✔*

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 une application Web. fichier manifeste.

Les propriétés suivantes dans le fichier manifeste de l'application Web sont pertinentes pour les applications de paiement Web:

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

Consultez la rubrique Configuration d'un mode de paiement méthode pour s'assurer que le fichier manifeste de votre mode de paiement pointe vers le fichier manifeste de votre application Web correctement.

Enregistrer un service worker juste-à-temps (JIT)

L'enregistrement JIT ne nécessite que de diffuser l'application Web fichier manifeste sans avoir à écrire la moindre ligne de code. Si vous avez déjà configuré le fichier manifeste de votre application Web et et qu'elles sont diffusées correctement, vous devriez être prêt. Le navigateur gère reste.

Déboguer une application de paiement Web

Lorsque vous développez l'interface d'une application de paiement Web, vous alternerez probablement le contexte du marchand et celui de l'application de paiement. Les conseils de débogage suivants vous aideront votre expérience de développement 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 difficile, car les fonctionnalités puissantes du navigateur ont tendance à nécessiter un environnement sécurisé (HTTPS). et un certificat valide. L'API Payment Request et l'API Payment Handler sont aucune exception et les localhosts ou les serveurs internes de l'entreprise ne sont généralement pas livrés avec un certificat valide.

La bonne nouvelle, c'est que certains navigateurs, dont Chrome, exemptent les certificats pour http://localhost par défaut. Dans Chrome, vous pouvez également l'exempter en lançant une instance Chrome. Par exemple, pour exempter de http://*.corp.company.com, utilisez les options suivantes:

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 indicateur d'exécution, consultez Exécuter Chromium avec indicateurs.

Transfert de port d'un serveur local

Vous pouvez effectuer un transfert de port du serveur Web local vers un appareil Android à l'aide du Les outils de développement et tester leur fonctionnement dans un navigateur mobile. Pour savoir comment procéder, consultez Accéder aux ressources Serveurs.

Débogage à distance d'un site Web sur Chrome pour Android à partir des outils de développement sur ordinateur

Vous pouvez également déboguer Chrome pour Android sur les outils de développement pour ordinateur. Pour savoir comment procéder, consultez Premiers pas avec le débogage à distance Android Appareils.

Journalisation des événements du gestionnaire de paiements

Les outils de développement peuvent afficher l'API Payment Handler des événements pour un développement local plus facile. Ouvrez les outils de développement dans le contexte du marchand et accédez à "Gestionnaire de paiement" : dans le volet Application. Cochez la case "Afficher les événements". provenant d'autres domaines" puis cliquez sur le bouton "Enregistrer" pour commencer à enregistrer les événements envoyés au service worker qui gère les paiements.

<ph type="x-smartling-placeholder">
</ph> Capture d&#39;écran de la journalisation des événements du gestionnaire de paiement. <ph type="x-smartling-placeholder">
</ph> Journalisation des événements du gestionnaire de paiements.

Étapes suivantes

L'étape suivante consiste à découvrir comment le service worker orchestre un paiement lors de l'exécution.