La API de Payment Handler permite a los proveedores de pagos poner a disposición de los comercios su experiencia de pago personalizada, junto con la API de Payment Request. Cuando se inicializa la API de Payment Request a través del constructor new PaymentRequest(), se activa de forma silenciosa un evento canmakepayment con el origen del comercio y datos arbitrarios a un trabajador de servicio registrado para la API de Payment Handler.
Esta comunicación entre orígenes no requiere un gesto del usuario ni muestra ninguna interfaz de usuario.
Chrome quitará los campos de identificación del evento canmakepayment y comenzará la prueba de origen a partir de Chrome 108.
La información de esta página solo se aplica a los proveedores de apps de pago que usan la API de Payment Handler. Si no la usas, puedes omitir estas instrucciones.
¿Cuáles son los cambios?
Cuando un comercio llama a new PaymentRequest(), un trabajador de servicio registrado recibe un evento canmakepayment (CanMakePaymentEvent) que contiene la siguiente información:
topOriginpaymentRequestOriginmethodDatamodifiers
Se quitarán y el trabajador de servicio simplemente recibirá el
evento canmakepayment sin información adicional.
Detección de atributos
Para detectar si se cambia el evento canmakepayment en el código del trabajador de servicio, examina las propiedades correspondientes de la siguiente manera:
self.addEventListener(e => {
if (e.paymentRequestOrigin) {...}
if (e.topOrigin) {...}
if (e.methodData && e.methodData.length > 0) {...}
if (e.modifiers && e.modifiers.length > 0) {...}
...
});
Prueba el cambio de forma local
Para habilitar el cambio de forma local con fines de desarrollo, sigue estos pasos:
- Usa Chrome 108, 109 o 110.
- Ingresa
chrome://flags/#clear-identity-in-can-make-paymenten la barra de URL. - Habilita la marca.
- Reinicia Chrome.
Si habilitas la marca, se vaciarán los campos de identidad del evento canmakepayment (y el intent IS_READY_TO_PAY de Android).
Habilita el cambio en producción
También puedes habilitar el cambio en producción con fines de prueba antes de que se lance en Chrome. Este mecanismo se denomina prueba de origen.
Las pruebas de origen te permiten probar funciones nuevas y enviar comentarios sobre su usabilidad, practicidad y eficacia a la comunidad de estándares web. Para obtener más información, consulta la Guía de pruebas de origen para desarrolladores web. Para registrarte en esta o en otra prueba de origen, visita la página de registro.
Para registrar una prueba de origen, sigue estos pasos:
- Solicita un token para tu origen.
- Agrega el token a tu archivo JavaScript de service worker con un encabezado HTTP
Origin-Trial. Para configurar los encabezados HTTP, debes tener acceso a la configuración del servidor. El encabezado de respuesta resultante debería verse de la siguiente manera:
Origin-Trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
Para ver el token de prueba de origen en el archivo del service worker, usa DevTools o el comando curl de la siguiente manera:
$ curl --head <Service Worker JS file URL> | grep -i origin-trial
origin-trial: Auw/tjTQ2eJQ911wiMHi1Bb7i71...
Se vuelven a habilitar los campos de identidad de forma local después de Chrome 111
Si usas Chrome 111 o versiones posteriores, los campos de identidad en el evento canmakepayment se dejan vacíos. Para volver a habilitar los campos de forma local, puedes hacer lo siguiente:
- Usa Chrome 111 o una versión posterior.
- Ingresa
chrome://flags/#add-identity-in-can-make-paymenten la barra de URL. - Habilita la marca.
- Reinicia Chrome.
Próximos pasos
Se planea que este cambio se habilite de forma predeterminada a partir de Chrome 111. Puedes comenzar a realizar pruebas hoy para prepararte para el cambio de hora del lanzamiento.