Mise à jour du comportement de l'événement CanMakePayment de l'API Payment Handler

L'API Payment Handler permet aux fournisseurs de paiement de mettre leur expérience de paiement personnalisée à la disposition des marchands, avec l'API Payment Request. Lorsque l'API Payment Request est initialisée via le constructeur new PaymentRequest(), elle déclenche silencieusement un événement canmakepayment avec l'origine du marchand et des données arbitraires à un nœud de calcul de service enregistré pour l'API Payment Handler. Cette communication inter-origine ne nécessite aucun geste de l'utilisateur et n'affiche aucune interface utilisateur.

Chrome va supprimer les champs d'identification de l'événement canmakepayment et lancer la phase d'évaluation de l'origine à partir de Chrome 108.

Les informations de cette page ne s'appliquent qu'aux fournisseurs d'applications de paiement qui utilisent l'API Payment Handler. Si ce n'est pas le cas, vous pouvez ignorer ces instructions.

Ce qui change

Lorsqu'un marchand appelle new PaymentRequest(), un service worker enregistré reçoit un événement canmakepayment (CanMakePaymentEvent) contenant les informations suivantes:

  • topOrigin
  • paymentRequestOrigin
  • methodData
  • modifiers

Ils seront supprimés, et le service worker recevra simplement l'événement canmakepayment sans aucune information supplémentaire.

Détection de fonctionnalités

Pour détecter si l'événement canmakepayment est modifié dans le code du service worker, examinez les propriétés respectives comme suit:

self.addEventListener(e => {
  if (e.paymentRequestOrigin) {...}
  if (e.topOrigin) {...}
  if (e.methodData && e.methodData.length > 0) {...}
  if (e.modifiers && e.modifiers.length > 0) {...}
  ...
});

Tester le changement en local

Pour activer le changement localement à des fins de développement:

  1. Utilisez Chrome 108, 109 ou 110.
  2. Saisissez chrome://flags/#clear-identity-in-can-make-payment dans la barre d'URL.
  3. Activez l'indicateur.
  4. Relancer Chrome.

En activant l'indicateur, les champs d'identité de l'événement canmakepayment seront vidés (et l'intent Android IS_READY_TO_PAY).

Activer le changement en production

Vous pouvez également activer le changement en production à des fins de test avant qu'il ne soit réellement déployé dans Chrome. Ce mécanisme s'appelle "test d'origine".

Les essais Origin Trial vous permettent de tester de nouvelles fonctionnalités et de donner votre avis sur leur facilité d'utilisation, leur praticité et leur efficacité à la communauté des normes Web. Pour en savoir plus, consultez le guide des essais Origin pour les développeurs Web. Pour vous inscrire à cet essai ou à un autre, accédez à la page d'inscription.

Pour enregistrer un essai de création d'origine:

  1. Demandez un jeton pour votre origine.
  2. Ajoutez le jeton à votre fichier JavaScript de service worker à l'aide d'un en-tête HTTP Origin-Trial. Pour définir des en-têtes HTTP, vous devez avoir accès à la configuration de votre serveur. L'en-tête de réponse obtenu doit se présenter comme suit:
Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

Pour afficher le jeton de test d'origine dans le fichier du service worker, utilisez les outils de développement ou la commande curl comme suit:

$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...

Réactiver les champs d'identité localement après Chrome 111

Si vous utilisez Chrome 111 ou une version ultérieure, les champs d'identité de l'événement canmakepayment sont laissés vides. Pour réactiver les champs localement, procédez comme suit:

  1. Utilisez Chrome 111 ou une version ultérieure.
  2. Saisissez chrome://flags/#add-identity-in-can-make-payment dans la barre d'URL.
  3. Activez l'indicateur.
  4. Relancer Chrome.

Étapes suivantes

Cette modification devrait être activée par défaut à partir de Chrome 111. Vous pouvez commencer les tests dès aujourd'hui pour vous préparer au changement au moment du lancement.