Com a API Payment Handler, os provedores de pagamento disponibilizam uma experiência de pagamento personalizada para os comerciantes, além da API Payment Request. Quando a API Payment Request é inicializada usando o construtor new PaymentRequest()
, ela dispara silenciosamente um evento canmakepayment
com a origem do comerciante e os dados arbitrários para um service worker registrado para a API Payment Handler.
Essa comunicação de origem cruzada não requer um gesto do usuário e não
mostra nenhuma interface do usuário.
O Chrome removerá os campos de identificação do evento canmakepayment
e iniciará o teste de origem no Chrome 108.
As informações nesta página se aplicam apenas aos provedores de apps de pagamento que usam a API Payment Handler. Se você não usa esse recurso, pule estas instruções.
O que está mudando?
Quando um comerciante chama new PaymentRequest()
, um service worker registrado
recebe um evento canmakepayment
(CanMakePaymentEvent
)
com as seguintes informações:
topOrigin
paymentRequestOrigin
methodData
modifiers
Eles serão removidos e o service worker simplesmente vai receber o
evento canmakepayment
sem qualquer informação adicional.
Detecção de recursos
Para detectar se o evento canmakepayment
mudou no código do service worker, examine as respectivas propriedades da seguinte maneira:
self.addEventListener(e => {
if (e.paymentRequestOrigin) {...}
if (e.topOrigin) {...}
if (e.methodData && e.methodData.length > 0) {...}
if (e.modifiers && e.modifiers.length > 0) {...}
...
});
Testar a mudança localmente
Para ativar a mudança localmente para fins de desenvolvimento:
- Use o Chrome 108, 109 ou 110.
- Digite
chrome://flags/#clear-identity-in-can-make-payment
na barra de URL. - Ative a sinalização.
- Reinicie o Chrome.
Ao ativar a flag, os campos de identidade no evento canmakepayment
serão
esvaziados (e
a intent IS_READY_TO_PAY
do Android).
Ativar a alteração na produção
Você também pode ativar a mudança na produção para fins de teste antes que ela realmente chegue ao Chrome. Esse mecanismo é chamado de teste de origem.
Os testes de origem permitem que você teste novos recursos e dê feedback sobre usabilidade, praticidade e eficácia para a comunidade de padrões da Web. Para mais informações, consulte o Guia de testes de origem para desenvolvedores da Web. Para se inscrever nesse ou em outro teste, acesse a página de registro.
Para registrar um teste de origem, siga estas etapas:
- Solicite um token para sua origem.
- Adicione o token ao arquivo JavaScript do service worker usando um cabeçalho HTTP
Origin-Trial
. A definição de cabeçalhos HTTP requer acesso à configuração do seu servidor. O cabeçalho de resposta resultante será semelhante a este:
Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
Para conferir o token de teste de origem no arquivo do service worker,
use o DevTools
ou o comando curl
da seguinte maneira:
$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
Reativar os campos de identidade localmente após o Chrome 111
Se você estiver usando o Chrome 111 ou posterior, os campos de identidade no evento canmakepayment
serão deixados em branco. Para reativar os campos localmente, faça o seguinte:
- Use o Chrome 111 ou versão mais recente.
- Digite
chrome://flags/#add-identity-in-can-make-payment
na barra de URL. - Ative a sinalização.
- Reinicie o Chrome.
Próximas etapas
Essa mudança será ativada por padrão a partir do Chrome 111. Comece os testes hoje para se preparar para a mudança a tempo do lançamento.