Lista de verificación de integración

Usa la siguiente lista de tareas para asegurarte de haber completado todos los pasos necesarios en tu integración web.

Acerca del entorno de pruebas

Una configuración de prueba de la API de Google Pay no devuelve información de pago real ni cobrable, sino que te permite probar elementos de tu flujo de compra. Los siguientes son elementos que se pueden probar:

  • Páginas de confirmación
  • Recibos
  • Dirección de facturación (opcional)
  • Número de teléfono de facturación (opcional)
  • Dirección de envío (opcional)
  • Dirección de correo electrónico (opcional)

Para usar un entorno de prueba con una respuesta de datos de pago de ejemplo, inicializa un nuevo objeto PaymentsClient con un objeto JavaScript que contenga una propiedad de entorno establecida en TEST.

A continuación, se muestra una muestra de código:
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Realiza pruebas con la consola para desarrolladores de tu navegador

Prueba tu sitio web en la versión más reciente de un navegador compatible. Para ello, abre las herramientas para desarrolladores de tu navegador y consulta los mensajes de la consola relacionados con tu sitio web. Los mensajes incluyen errores o advertencias de la biblioteca cliente de JavaScript de la API de Google Pay. La API de Google Pay admite Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera y UCWeb UC Browser.

Es posible que se muestren errores adicionales en la ventana de diálogo de selección de pagos de Google después de llamar a loadPaymentData(). Cuando hagas clic en Continuar o Aceptar después de ver el mensaje de error, es posible que se muestren detalles adicionales en el objeto Promise rechazado que controla tu sitio.

Prueba en un dispositivo compatible

Si bien la API de Google Pay está disponible en muchos mercados, las tarjetas tokenizadas solo están disponibles en un subconjunto de países. Si las tarjetas tokenizadas se establecen como una forma de pago permitida, pruébalas en un dispositivo Android con Chrome para Android versión 59 o posterior y Servicios de Google Play versión 16.0.0 o posterior. Si tu forma de pago es compatible con tu país y con tu banco emisor, haz una prueba con una tarjeta almacenada en la app de Google Pay.

Para ver los errores y las advertencias de la consola de Chrome para Android, realiza pruebas con la depuración remota desde Chrome para computadoras. Para obtener más información sobre los posibles errores, consulta los registros de tu dispositivo Android. Es posible que puedas ver los registros de errores con la ventana de herramientas Logcat en Android Studio, con la herramienta de línea de comandos adb logcat o dentro de un informe de errores de Android. Para ver los mensajes de error relacionados con la API de Google Pay, busca WalletMerchantError.

A continuación, se muestra una muestra de código:

adb logcat -s WalletMerchantError

Cómo probar tu integración

Antes de enviar tu integración a Google para su validación con un PaymentsClient configurado para un entorno de TEST, asegúrate de haber cumplido con los criterios de salida para cada una de las siguientes verificaciones funcionales y de desarrollo de la marca.

1. Fundamentos

Asegúrate de que los controles y las verificaciones de riesgo existentes para las transacciones con tarjeta o PAN también se apliquen a las transacciones de Google Pay. Las verificaciones de fraude y validación de Google Pay no tienen como objetivo reemplazar tus procesos de administración de riesgos.
Si activas de forma selectiva 3D Secure (autenticación adicional) para las transacciones normales con tarjeta según los criterios de riesgo, asegúrate de usar los mismos criterios de riesgo para activar 3D Secure para las transacciones con el PAN de Google Pay PAN_ONLY.
Asegúrate de haber leído y estar listo para aceptar nuestras Condiciones del Servicio. El registro en la API de Google Pay requiere que tu dirección de correo electrónico esté asociada a una Cuenta de Google y, de preferencia, que sea una dirección de correo electrónico empresarial asociada a tu dominio comercial, como "admin@midominioempresarial.com". Selecciona Prefiero usar mi dirección de correo electrónico actual en el flujo de creación de la Cuenta de Google para asociar tu correo electrónico con una Cuenta de Google.
Utiliza los datos que recibas de la API de Google Pay solo para procesar transacciones. Todos los demás casos de uso requieren el consentimiento expreso y por separado del usuario.
Confirma las redes de tarjetas y los métodos de autenticación de tarjetas que acepta tu procesador de pagos en tu país.
Si completas una integración de DIRECT tokenizationSpecification type, debes rotar anualmente tu clave de encriptación pública y proporcionar la certificación de cumplimiento de PCI a Google a través de la consola de Google Pay y la Billetera de Google. La certificación de PCI se puede enviar a través de un tercero o un asesor de seguridad calificado certificado por el Consejo sobre Normas de Seguridad de la PCI y aprobado por un proveedor aprobado o un asesor calificado.

2. Pruebas de marca

Utiliza nuestros recursos aprobados y cumple con todos los elementos de nuestros Lineamientos de desarrollo de la marca.
Asegúrate de que el botón de pago de Google Pay solo aparezca después de que tu sitio confirme la capacidad del usuario para pagar a través de la función isReadyToPay().
Confirma que las dimensiones del botón de pago de Google Pay que se muestran coincidan con las de botones y elementos similares de la página.
Elige un botón adecuado según el color de fondo del área en la que aparece.

3. Pruebas funcionales

Verifica que se llame a loadPaymentData() de forma síncrona cuando haces clic en el botón de pago de Google Pay y que mantenga el comportamiento de activación del usuario del navegador que permite que la API de Google Pay muestre una hoja de pago. Valida que la hoja de pagos de Google Pay no esté bloqueada por bloqueadores de ventanas emergentes.

Cuando solicites el tipo de forma de pago CARD con autenticación de tarjeta PAN_ONLY, completa los siguientes pasos para realizar la prueba de tarjetas registradas:

  1. Si corresponde, quita todas las tarjetas registradas en pay.google.com.
  2. Regresa a tu integración.
  3. Haz clic en Google Pay.
  4. Valida que veas la opción para agregar una tarjeta.
  5. Agrega una tarjeta de una red admitida, como se define en parameters.allowedCardNetworks.
  6. Valida que veas la tarjeta agregada con el logotipo de la cadena en el selector.

La siguiente prueba solo se aplica a Chrome en Android.

Cuando solicites el tipo de forma de pago CARD con autenticación de tarjeta CRYPTOGRAM_3DS, completa los siguientes pasos para realizar la prueba del token del dispositivo Android:

  1. Verifica que se admita la entidad emisora de tu tarjeta y agrega una tarjeta apta en la aplicación de Google Pay para Android.
  2. Regresa a tu integración.
  3. Haz clic en el botón de pago de Google Pay.
  4. Valida que veas la tarjeta agregada, con el diseño de la tarjeta, en el selector.

Si confirmas que tu procesador admite la autenticación de tarjetas 3D-Secure, puedes continuar, incluso si no tienes disponible un token de dispositivo Android como usuario de Android o titular de la tarjeta.

Si necesitas una dirección de envío, prueba el procesamiento de la dirección de envío en varios estados de finalización, como los siguientes:

  • Son las variaciones de un nombre completo que se analizarán en campos estructurados, como "Juan", "Juan Pérez" y "Ana Pérez Sosa".
  • Analiza con precisión todas las líneas de dirección que devuelve la API de Google Pay, que pueden superar la cantidad total de líneas de dirección que se suelen recopilar en tu flujo de confirmación de compra estándar.
  • Verifica que el componente de país devuelto de la dirección coincida con los destinos de envío admitidos de tu sitio. Si especificaste restricciones de envío, pruébalas: Ingresa una dirección de envío no admitida que no esté permitida en nuestra hoja de pagos y verifica si las restricciones funcionan.

Si implementaste la compatibilidad con Authorize Payments, verifica lo siguiente:

  • Cuando falla la autenticación de un pago, se devuelve un ERROR transactionState y PaymentDataError con la intención PAYMENT_AUTHORIZATION.

Si implementaste la compatibilidad con las Actualizaciones de precios dinámicos, completa los siguientes pasos:

  1. Agrega los detalles de la tarjeta y la dirección en la hoja de pagos.
  2. Actualiza las opciones de envío, la lista de pedidos y el precio total.
  3. Importante: Asegúrate de que el precio total coincida con el importe de la transacción. De lo contrario, puede afectar el valor del Indicador de comercio electrónico (ECI) y la parte responsable.
  4. Agrega y selecciona una dirección de envío.
  5. Actualiza las opciones de envío, la lista de pedidos y el precio total.
  6. Selecciona una opción de envío.
  7. Actualiza la lista de pedidos y el precio total.
  8. Valida tus resultados:
    • Si la dirección de envío no tiene opciones de envío disponibles, valida que obtengas PaymentDataError con la intención SHIPPING_ADDRESS.
    • Si la opción de envío seleccionada no es válida, valida que obtengas PaymentDataError con la intención SHIPPING_OPTION.
    • Si falla la autenticación del pago, valida que obtengas ERROR transactionState y PaymentDataError con la intención PAYMENT_AUTHORIZATION.
Si necesitas un número de teléfono, solicítalo a la dirección de facturación. Luego, prueba si puedes analizar y almacenar el número de teléfono según los estándares de datos de tu sitio web con diferentes formatos, como "+8005550100", "18005550100" y "(800) 555-0100".
Asegúrate de que Google Pay se muestre en paridad con otras formas de pago de terceros.
En el caso de los usuarios que seleccionaron Google Pay en la confirmación de compra y lo indicaron como su preferencia de pago en tu sitio web, Google Pay debe establecerse como la forma de pago predeterminada para su compra posterior.
Se debe mostrar un precio final al usuario antes de que se procese la transacción. Si el importe que se cobrará varió según los datos recibidos de la API de Google Pay, se espera que muestres una página de confirmación con el precio final.