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 supprimera les champs d'identification de l'événement canmakepayment et lancera la phase d'évaluation à 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:
topOriginpaymentRequestOriginmethodDatamodifiers
Ils seront supprimés, et le service worker recevra simplement l'événement canmakepayment sans aucune information supplémentaire.
Détection de caractéristiques
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:
- Utilisez Chrome 108, 109 ou 110.
- Saisissez
chrome://flags/#clear-identity-in-can-make-paymentdans la barre d'URL. - Activez l'indicateur.
- Relancer Chrome.
Si vous activez l'indicateur, les champs d'identité de l'événement canmakepayment seront vidés (ainsi que l'intent IS_READY_TO_PAY Android).
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 une phase d'évaluation:
- Demandez un jeton pour votre origine.
- Ajoutez le jeton au fichier JavaScript de votre 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 ressembler à ceci:
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:
- Utilisez Chrome 111 ou une version ultérieure.
- Saisissez
chrome://flags/#add-identity-in-can-make-paymentdans la barre d'URL. - Activez l'indicateur.
- 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 à temps pour le lancement.