Referencia de cliente

En esta referencia se describen los métodos de cliente de JavaScript que se deben usar para implementar la API de Google Pay en tus aplicaciones web.

Constructor

Inicializa el objeto PaymentsClient. Debes llamar a este constructor antes de llamar a los métodos de miembro.

new PaymentsClient(paymentOptions)

Argumentos

Propiedad Descripción
paymentOptions

Un objeto que contiene pares clave-valor de datos de configuración de la API de Google Pay. Consulta las diferentes propiedades que se pueden configurar en PaymentOptions.

Ejemplo: {environment:'PRODUCTION'}

Devoluciones

Tipo Descripción
google.payments.api.PaymentsClient El objeto PaymentsClient.

Mantas

Tipo Descripción
Error

El valor de la propiedad de entorno transferido no se admite.

Métodos de objeto

createButton(options)

El método de conveniencia se usa para generar un botón de pago de Google Pay con el estilo de la marca Google Pay más reciente para insertarlo en una página web.

El HTMLElement generado incluye CSS insertado dinámicamente y una imagen SVG alojada en la CDN de Google.

Consulta nuestras directrices de marca para obtener más información sobre cómo seleccionar el color y el tipo de botón adecuados para el diseño de tu sitio. Puede que tengas que modificar las dimensiones del botón para que coincida con botones similares o elementos de tramitación de la compra de tu página. Usa nuestra herramienta Personalizar el botón para configurar un botón que se ajuste a tu caso práctico.

Argumentos

Nombre Descripción
options

Un objeto que contiene pares clave-valor para la configuración de un botón. Consulta las propiedades configurables en ButtonOptions.

Ejemplo: {onClick:onGooglePaymentButtonClicked}

Devoluciones

Tipo Descripción
HTMLElement Un elemento HTML <button> dentro de un contenedor de contenido de flujo genérico, como un <div>.

Mantas

Tipo Descripción
Error

No se ha definido una propiedad obligatoria.

isReadyToPay(isReadyToPayRequest)

Usa el método isReadyToPay(isReadyToPayRequest) para determinar si un usuario puede devolver una forma de pago de la API Google Pay.

Si el navegador admite Google Pay, isReadyToPay devuelve true. Para determinar si el usuario ha iniciado sesión en una cuenta de Google o si ya ha guardado un método de pago en Google Pay, asigna el valor true a IsReadyToPayRequest.existingPaymentMethodRequired y verifica que paymentMethodPresent devuelva true en la promesa resuelta. Para obtener más información, consulta IsReadyToPayResponse.

Si PaymentsClient se ha inicializado con una propiedad de entorno de TEST, paymentMethodPresent siempre devuelve true.

Argumentos

Nombre Descripción
isReadyToPayRequest Un objeto que contiene los métodos de pago que admite el comercio. Para obtener más información sobre las diferentes propiedades que se pueden configurar, consulta IsReadyToPayRequest.

Devoluciones

Tipo Descripción
Promise

Resolved: objeto que contiene información sobre la capacidad de pago del usuario. Para obtener más información, consulta IsReadyToPayResponse.

Rejected: un objeto de error que contiene más información sobre el motivo del rechazo. Para obtener más información, consulta la sección PaymentsError.

Errores

statusCode Descripción
DEVELOPER_ERROR
  • El objeto IsReadyToPayRequest que se ha transferido no tiene el formato correcto, no incluye los parámetros mínimos necesarios para determinar si el usuario puede pagar o contiene un parámetro o un valor no válidos.
  • La solicitud se ha iniciado desde un contexto de seguridad que el agente de pagos o el navegador han decidido no cumplir. Lo más habitual es que se trate de un error de contexto de navegador no seguro.

loadPaymentData(paymentDataRequest)

Este método presenta una hoja de pago de Google Pay que permite seleccionar un método de pago y parámetros configurados opcionalmente.

Se debe llamar a este método mientras el navegador procesa un comportamiento de activación como resultado de un evento de clic. Puede que se muestre una ventana emergente al usuario para que seleccione un método de pago u otros datos obligatorios especificados en el parámetro de solicitud transferido.

Argumentos

Nombre Descripción
paymentDataRequest Objeto que contiene pares clave-valor de la configuración completa de la API de Google Pay. Consulta las propiedades configurables en PaymentDataRequest.

Devoluciones

Tipo Descripción
Promise

Resuelta: un objeto que contiene los datos del comprador solicitados. Consulta PaymentData para obtener más información.

Rejected: un objeto que contiene un código de error y más información sobre el motivo del rechazo. Consulta PaymentsError para obtener más información.

Errores

statusCode Descripción
CANCELED
  • El navegador actual o el usuario de Google que ha iniciado sesión no son compatibles.
  • El comprador ha cerrado la hoja de pago de Google Pay sin autorizar el pago.
  • La solicitud se ha iniciado desde un contexto de seguridad que el agente de pagos o el navegador han decidido no cumplir. Lo más habitual es que se trate de un contexto de navegador no seguro.
  • Se ha llamado al método mientras ya se mostraba la hoja de pago de Google Pay.
  • La hoja de pago de Google Pay ha rechazado el objeto PaymentDataRequest que se ha enviado. Una causa habitual es que falten parámetros de PaymentMethodTokenizationSpecification o que estén incompletos en tu pasarela, o bien que los valores de los parámetros no sean válidos.
DEVELOPER_ERROR El objeto PaymentDataRequest transferido no tiene el formato correcto, le faltan los parámetros mínimos obligatorios o contiene un parámetro o un valor no válidos.

prefetchPaymentData(paymentDataRequest)

Usa este método para precargar una configuración de PaymentDataRequest y mejorar el tiempo de ejecución de loadPaymentData en interacciones posteriores de los usuarios. No se devuelve ningún valor.

Las optimizaciones de precarga están disponibles en Chrome para Android.

Argumentos

Nombre Descripción
paymentDataRequest Objeto que contiene pares clave-valor de la configuración completa de la API de Google Pay. Consulta las propiedades configurables en PaymentDataRequest. Un cambio en la propiedad transactionInfo no afecta al valor de precarga almacenado en caché.

Retrollamadas de datos de pago

Los siguientes controladores de retrollamada se pueden pasar a PaymentOptions.paymentDataCallbacks para admitir la autorización de pagos y las actualizaciones del sistema de precios dinámico.

onPaymentAuthorized(paymentData)

Se llama a este método cuando se autoriza un pago en la hoja de pago.

Argumentos

Nombre Descripción
paymentData Un objeto que contiene los datos del comprador solicitados. Para obtener más información, consulta PaymentData.

Devoluciones

Tipo Descripción
Promise

Resolved: objeto que contiene información sobre los resultados de las transacciones de pago. Para obtener más información, consulta PaymentAuthorizationResult.

Rechazado: un objeto de error con un intent de error y un mensaje que se mostrará en la hoja de pago. Para obtener más información, consulta PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

Este método gestiona los cambios en los datos de pago de la hoja de pago, como la dirección de envío y las opciones de envío.

Argumentos

buenas
Nombre Descripción
intermediatePaymentData Un objeto que contiene la dirección y la opción de envío seleccionadas en la hoja de pago. Para obtener más información, consulta IntermediatePaymentData.

Devoluciones

Tipo Descripción
Promise

Resolved: un objeto que contiene información sobre la nueva transacción, las opciones de envío y los errores de los datos de pago. Para obtener más información, consulta PaymentDataRequestUpdate.

Rechazado: un objeto de error con un intent de error y un mensaje que se mostrará en la hoja de pago. Para obtener más información, consulta PaymentDataError.