Enregistrer une application de paiement sur le Web

Découvrez comment configurer une application de paiement en ligne lors de l'inscription.

Les applications de paiement Web sont des progressive web apps (PWA) et s'exécutent au-dessus des service workers. Dans une application de paiement, le service worker joue un rôle important, car il capture les demandes de paiement d'un marchand, lance l'application de paiement et joue le rôle de médiateur dans 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 incluent différentes technologies, dont l'état dépend du navigateur.

Chromium 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 un fichier manifeste d'application Web.

Les propriétés suivantes du fichier manifeste de l'application Web s'appliquent aux applications de paiement en ligne:

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

Consultez la section 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 fichier manifeste de l'application Web, sans codage supplémentaire. Si vous avez déjà configuré le fichier manifeste de votre application Web et que vous le diffusez correctement, vous devriez être prêt. Le navigateur se charge du reste.

Déboguer une application de paiement en ligne

Lorsque vous développez l'interface d'une application de paiement Web, vous êtes probablement amené à passer du contexte du marchand à celui de l'application de paiement. Les conseils de débogage suivants vous aideront à développer des applications dans Chrome.

Développer sur un serveur local

Quel serveur utilisez-vous pour le développement ? De nombreux développeurs ont tendance à utiliser un hôte local ou un environnement de serveur interne à l'entreprise, ce qui peut s'avérer 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 ne font pas exception, et les localhosts ou les serveurs internes à l'entreprise ne sont généralement pas fournis avec un certificat valide.

La bonne nouvelle, c'est que certains navigateurs, dont Chrome, exemptent les certificats pour http://localhost par défaut. Toujours dans Chrome, vous pouvez exempter l'exigence de certificat en lançant une instance Chrome. Par exemple, pour exempter l'exigence 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 la page Exécuter Chromium avec des indicateurs.

Transfert de port sur un serveur local

Vous pouvez effectuer un transfert de port du serveur Web local vers un appareil Android à l'aide des outils de développement Chrome et tester son fonctionnement à partir d'un navigateur mobile. Pour savoir comment procéder, consultez la section Accéder aux serveurs locaux.

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

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

Journalisation des événements du gestionnaire de paiements

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

Capture d'écran de la journalisation des événements du gestionnaire de paiement
Journalisation des événements du gestionnaire de paiement.

Étapes suivantes

L'étape suivante consiste à apprendre comment le service worker peut orchestrer une transaction de paiement au moment de l'exécution.