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:
- Utilisez Chrome 108, 109 ou 110.
- Saisissez
chrome://flags/#clear-identity-in-can-make-payment
dans la barre d'URL. - Activez l'indicateur.
- 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:
- Demandez un jeton pour votre origine.
- 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:
- Utilisez Chrome 111 ou une version ultérieure.
- Saisissez
chrome://flags/#add-identity-in-can-make-payment
dans 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 au moment du lancement.