Preguntas frecuentes

En esta página, se proporciona información general y preguntas frecuentes sobre la API de Google Pay.

Acerca de la API de Google Pay

Google Pay permite confirmar compras sin esfuerzo en tu app y sitio web. Con la API de Google Pay, tus clientes pueden usar las tarjetas guardadas en sus Cuentas de Google para confirmar compras sin problemas en tus apps y sitios.

Cómo obtener asistencia

Regístrate en la Consola de Google Pay y la Billetera de Google y selecciona Comunicarse con el equipo de asistencia. Podemos ayudarte a solucionar problemas con tus integraciones. Además, consulta nuestras guías de solución de problemas de Android y de solución de problemas web para depurar tu integración por tu cuenta.

Funciones admitidas

La API de Google Pay tiene varias funciones compatibles.

Formas de pago admitidas

La API de Google Pay puede devolver tarjetas o tokens de red.

Facturación y suscripciones recurrentes

La compatibilidad con la facturación recurrente está vinculada a la forma de pago que se devuelve en la respuesta de la API de Google Pay. Tanto las tarjetas con asignación de token como las tarjetas registradas se pueden usar para la facturación recurrente. Para procesar la facturación recurrente, el comercio no tiene que llamar a nuestra API con una cadencia. En cambio, la credencial de pago se almacena en el lado del comercio para los pagos recurrentes. El comercio usa las APIs de su pasarela de pagos para administrar la facturación recurrente.

Google Pay admite pagos recurrentes si se cumplen las siguientes condiciones:

  • Los comercios cumplen con las reglas de la red, como las transacciones iniciadas por el comercio.
  • El usuario divulga y acepta las condiciones de pago en el flujo de compra del comercio.

También admitimos la facturación recurrente con importes variables. Por ejemplo, se admiten las facturas telefónicas mensuales de los operadores de telefonía celular. Para obtener más información, los comercios deben comunicarse con su representante de la pasarela de pago.

Recarga automática o "recarga"

Para procesar un cargo de recarga automática por el mismo costo, el comercio no tiene que llamar a nuestra API cada vez. La credencial de pago se almacena en el lado del comercio y se vuelve a usar. Para obtener más información, los comercios deben comunicarse con su representante de la pasarela de pagos.

Devoluciones de cargos

Los comercios pueden gestionar las reversiones de transacciones por cancelaciones, reembolsos o reclamos de la misma manera que gestionan las devoluciones de cargos para otras formas de pago. Para obtener más información, los comercios deben comunicarse con el representante de su procesador.

Recolección de donaciones

Las organizaciones sin fines de lucro (OSFL) aprobadas pueden integrar la API de Google Pay para recibir donaciones, siempre y cuando proporcionen documentación que demuestre, certifique y valide su estado de organización sin fines de lucro. Por ejemplo, las ONP de EE.UU. deben proporcionar un comprobante válido del estado 501(c)3 del IRS para cumplir con los requisitos.

Condiciones y políticas

Condiciones del Servicio de Google Pay

Todos los comercios deben aceptar y cumplir las Condiciones del Servicio de Google Pay.

Política de Uso Aceptable de la API de Google Pay

Todos los comercios deben aceptar y cumplir con la Política de Uso Aceptable de la API de Google Pay.

Política de Juegos de Apuestas

Nuestra política sobre juegos de apuestas se define en la Política de Uso Aceptable de la API de Google Pay.

Nuestra política sobre juegos de apuestas puede cambiar periódicamente. Todos los envíos están sujetos a revisión y aprobación.

Aceptamos integraciones de juegos de apuestas de empresas con sede en los siguientes países:

  • Australia
  • Austria
  • Canadá
  • República Checa
  • Francia
  • Georgia
  • Alemania
  • Grecia
  • Hungría
  • Irlanda
  • Italia
  • Japón
  • Países Bajos
  • Polonia
  • Portugal
  • Rumania
  • España
  • Suecia
  • Reino Unido

En una etapa posterior, es posible que decidamos ampliar la compatibilidad más allá del nivel actual.

Para obtener acceso de producción a la API de Google Pay para las integraciones de juegos de apuestas, debes completar una serie de requisitos previos:

  • Si tienes una integración de juegos de apuestas solo para Android y te encuentras en uno de los países mencionados anteriormente, primero debes cumplir con la política de juegos de apuestas de Google Play y completar el proceso de verificación de Google Play. Luego, podemos evaluar tu integración solo para Android y otorgarte acceso de producción a la API de Google Pay.
  • Si tienes una integración de juegos de apuestas solo para la Web con sede en uno de los países mencionados anteriormente, debes enviar una licencia autorizada para demostrar que cumples con los requisitos para proporcionar servicios de juegos de apuestas en el país durante el proceso de incorporación con la API de Google Pay. Luego, podemos evaluar tu integración solo para la Web para el acceso a producción de la API de Google Pay.
  • Si tienes una integración de juegos de apuestas para Android y la Web en uno de los países mencionados anteriormente, primero debes cumplir con la política de juegos de apuestas de Google Play y completar el proceso de verificación de Google Play. Luego, podremos evaluar tus integraciones para Android y la Web para otorgarte acceso a producción a la API de Google Pay.

Países con condiciones o restricciones específicas

Las integraciones de juegos de apuestas se permiten en los países enumerados si cumplen con los siguientes criterios:

País Elegibilidad para la integración en Android Elegibilidad para la integración web
Bulgaria Sí, con restricciones:
  • Las apps que redireccionan a un sitio web son aptas.
  • Se prohíben las apps que no redireccionan a un sitio web.
 Sí
Chipre Sí, con restricciones:
  • La lotería estatal es apta.
  • OPAP Cyprus Limited cumple con los requisitos.
  • Se prohíben los casinos en línea.
  • Se prohíben las máquinas tragamonedas.
  • Se prohíben las apuestas de carreras de caballos.
  • Se prohíben las apuestas en carreras de perros.
  • Se prohíben las apuestas con hándicap.
  • Se prohíben los intercambios de apuestas.
 Sí, con restricciones:
  • La lotería estatal es apta.
  • OPAP Cyprus Limited cumple con los requisitos.
  • Se prohíben los casinos en línea.
  • Se prohíben las máquinas tragamonedas.
  • Se prohíben las apuestas de carreras de caballos.
  • Se prohíben las apuestas en carreras de perros.
  • Se prohíben las apuestas con hándicap.
  • Se prohíben los intercambios de apuestas.
Finlandia Sí, con restricciones:
  • Veikkaus Oy es apta.
 Sí, con restricciones:
  • Veikkaus Oy es apta.
Kazajistán Sí, con restricciones:
  • Las loterías son elegibles.
  • Se permiten las apuestas deportivas.
  • Los totalizadores son aptos.
  • Se prohíben los casinos en línea.
  • Se prohíben los casinos electrónicos.
 Sí, con restricciones:
  • Las loterías son elegibles.
  • Se permiten las apuestas deportivas.
  • Los totalizadores son aptos.
  • Se prohíben los casinos en línea.
  • Se prohíben los casinos electrónicos.
Polonia No Sí, con restricciones:
  • Los proveedores de juegos de apuestas con licencia son aptos.
Sudáfrica Sí, con restricciones:
  • Se permiten las apuestas deportivas en línea.
 Sí, con restricciones:
  • Las apuestas deportivas en línea son aptas.

Si expandes la API de Google Pay a un país para el que no recibiste aprobación previa, comunícate con nosotros para obtener la aprobación de la expansión. Ten en cuenta que deberás proporcionar una licencia de juegos de apuestas autorizada para cada país en el que planees ofrecer servicios relacionados con juegos de apuestas. No permitimos que se use la API de Google Pay para servicios de juegos de apuestas que estén dirigidos a personas menores de edad o que, por algún otro motivo, tengan prohibido participar en juegos de apuestas según las leyes locales.

Política de atención médica

Nuestra política sobre atención médica se define en la Política de Uso Aceptable de la API de Google Pay.

Prepárate para compartir una licencia pertinente durante la incorporación para validar tu caso de uso de atención médica. Todos los envíos están sujetos a revisión y aprobación.

Política sobre Servicios Financieros

Nuestra política sobre Servicios Financieros se define en la Política de Uso Aceptable de la API de Google Pay.

Prepárate para compartir una licencia pertinente durante la incorporación para validar tu caso de uso de servicios financieros. Todos los envíos están sujetos a revisión y aprobación.

Preguntas frecuentes generales

Las siguientes preguntas frecuentes se aplican a los comercios:

Uso un PSP importante para administrar todo el riesgo y la autenticación reforzada de clientes. ¿Qué debo saber sobre GPay?

La API de Google Pay devuelve formas de pago en una carga útil firmada y encriptada. Las formas de pago devueltas consisten en PAN o tarjetas asignadas con token compuestas por PAN de dispositivo (DPAN) y criptogramas.

Las cargas útiles de tarjetas con asignación de token se procesan sin pasos ni desafíos adicionales.

Las cargas útiles de tarjetas que consisten en un PAN requieren 3D Secure a través de una solución interna o proporcionada por un PSP.

Si tu PSP administra toda la lógica de riesgo y SCA, asegúrate de que tu integración de la API de Google Pay incluya las siguientes propiedades:

  • merchantInfo.merchantName (Android, Web): El nombre del comercio se renderiza en la hoja de pago.
  • transactionInfo.countryCode (Android, Web): Indica dónde se procesa la transacción. Debes especificar el país del banco adquirente.
  • transactionInfo.totalPrice (Android, Web): Es el valor monetario total de la transacción con una precisión decimal opcional de dos decimales.
¿Cómo obtengo un ID de comerciante de Google?
Puedes obtener un ID del comerciante de Google después de que Google apruebe tu sitio web. Para iniciar el proceso, accede a la Consola de Google Pay y la Billetera de Google y crea una integración de la API de Google Pay. Debes proporcionar una lista de dominios completamente calificados junto con los subdominios, que te ayudarán a llamar a la API de Google Pay.
¿Podemos usar un solo ID del comerciante en varias marcas y canales (Web y aplicación)?
Sí, se admite el uso de un solo ID del comerciante en varias marcas y plataformas (como la Web y Android) y, en general, se recomienda para simplificar la conciliación.
¿Cómo pueden los comercios promocionar la aceptación de Google Pay en sus apps y sitios para sus usuarios?
Para destacar la compatibilidad con Google Pay, asegúrate de usar los recursos disponibles en nuestros lineamientos de desarrollo de la marca para Android y Web.
Si tienes una integración de Android, puedes indicar en la descripción de Play Store que ahora admites Google Pay. En el caso de las integraciones web, puedes agregar una descripción directamente al sitio web del comercio.
¿Las plataformas de comercio electrónico pueden admitir Google Pay?
Sí, la API de Google Pay admite la incorporación de plataformas de comercio electrónico. Los socios procesadores de pagos, las puertas de enlace o las plataformas de comercio electrónico que alojan una página de confirmación de compra en nombre de sus comercios pueden usar la función de confirmación de compra alojada de Google Pay.
¿Qué proveedores de pagos admiten Google Pay?
Para encontrar una lista de procesadores que admiten Google Pay, consulta nuestra lista de procesadores de Google Pay.
¿En qué países y regiones se admite Google Pay?
Consulta nuestra lista de países admitidos que usan Google Pay para pagos en línea o en apps.
¿Qué países y regiones se admiten para los tokens de Google Pay (CRYPTOGRAM_3DS)?
Consulta nuestra página Descubre las formas de pago admitidas para realizar compras en tiendas y sin contacto para obtener una lista de los países y los bancos de cada uno que admiten tokens de Google Pay (CRYPTOGRAM_3DS). Se incluyen las tarjetas compatibles y las no compatibles.
¿Cuál es la diferencia entre la Facturación integrada en Google Play y la API de Google Pay?
Los desarrolladores de Google Play que venden servicios y artículos digitales en apps para Android deben usar la facturación integrada de Google Play, como se especifica en el Centro de políticas para desarrolladores de Play. Algunos ejemplos de la facturación integrada en la aplicación son los productos virtuales de juegos, las funciones o el contenido de las apps, y los productos de software en la nube. Consulta la página de descripción general de la Facturación Google Play para obtener más información sobre la Facturación integrada.
Cuando se usa en apps, la API de Google Pay solo está disponible para productos y servicios físicos.
¿Google Pay cobra alguna tarifa?
Google Pay no cobra comisiones adicionales a los usuarios, comercios ni desarrolladores por usar la API de Google Pay para pagos. En particular, los comercios siguen pagando tarifas por procesamiento a su procesador de pagos.
¿Qué hace Google para validar las credenciales y prevenir fraudes?
Todas las tarjetas que se agregan a Google pasan por una autorización de verificación para validar los detalles de la tarjeta, que incluyen el código de verificación de la tarjeta (CVC). Google también ejecuta un motor de riesgo propietario basado en datos de instrumentos, perfiles de Cuentas de Google, historial de compras, ubicaciones y la información del dispositivo. Sin embargo, los comercios deben seguir usando sus herramientas actuales de evaluación de riesgos y fraudes con las transacciones de Google Pay.
¿Se admite Google Pay en WebViews de apps para dispositivos móviles?
Las WebViews de Android admiten Google Pay por completo y simulan la experiencia de la Web para dispositivos móviles, siempre que agregues la dependencia de WebKit necesaria. Sin embargo, en las WebViews de iOS, la API de isReadyToPay siempre devolverá false debido a las restricciones de iOS sobre las cookies de terceros. Tanto la app para Android como el dominio del sitio web dentro de WebView deben estar aprobados para el acceso a producción. Para obtener detalles específicos de la implementación, consulta la documentación de Uso de WebView de Android o Uso de WKWebview de iOS.
Mi procesador no aparece en la lista. ¿Puedo seguir integrando mi servicio con Google Pay?
Google Pay sigue creando asociaciones con plataformas de comercio electrónico y procesadores de pagos. Si no encuentras tu procesador en g.co/pay/processors, puedes enviar una solicitud. Recibirás una notificación cuando el procesador esté disponible.
¿Cómo habilito Google Pay si ya tengo un procesador de pagos o un proveedor de plataforma de pagos?
Google Pay trabaja con una variedad de proveedores de servicios de pago y proveedores de plataformas de comercio electrónico. Cada uno ofrece documentación específica y personalizada para ayudarte a comenzar, junto con nuestro instructivo principal para una integración sencilla.
¿Cómo puedo ofrecer Google Pay a gran escala a mis comercios si soy un procesador de pagos admitido?
Los procesadores de pagos admitidos pueden implementar nuestra solución de confirmación de compra alojada para las integraciones web. La confirmación de compra alojada permite que tus clientes ofrezcan Google Pay a sus clientes y omitan la integración individual con Google Pay.

Para comenzar, primero debes incorporarte como procesador de pagos admitido. Para integrar la solución de confirmación de la compra alojada, comunícate con el punto de contacto técnico de Google que te ayudó con la incorporación.

¿Cómo puede Google Pay adaptar diferentes opciones de envío y precios para mis usuarios si ofrezco envíos en mi proceso de confirmación de compra?
En el caso de las integraciones web, necesitas una dirección de envío y mostrar diferentes opciones de envío y precios dentro del objeto PaymentDataRequest, el objeto PaymentOptions y el objeto PaymentDataCallbacks. Para ver un ejemplo de situación, consulta la demostración de actualización de precios dinámica.

Para las integraciones de Android, necesitas una dirección de envío dentro del objeto PaymentDataRequest.

¿Cómo recibo el dinero de las compras realizadas con Google Pay?
La API de Google Pay facilita las transacciones, ya que pasa la información de pago de los usuarios a tu proveedor de servicios de pago. No forma parte del flujo de dinero y está diseñada para funcionar sobre tu infraestructura de pagos existente.
¿Cuáles son los requisitos para obtener acceso a producción?
Los comercios deben crear un Perfil de Negocio en la Consola de Google Pay y la Billetera de Google, y subir capturas de pantalla de su flujo de compra para su revisión. Cada dominio que aloje la API de Google Pay debe enviarse para su aprobación de forma individual, ya que no se aceptan dominios comodín (p.ej., *.merchant.com). Consulta la página Publica tu integración para Android o Web para obtener más información.
¿Cómo puedo saber el estado de mi envío de integración y si necesito realizar algún cambio después del proceso de revisión?
Después de enviar tu integración de la API de Google Pay para su revisión, recibirás un correo electrónico con los resultados. Si tu integración cumple con nuestra Política de Uso Aceptable y los lineamientos de la marca, se aprobará y mostrará el estado Activo en la consola de Google Pay y la Billetera. Si se necesitan cambios, el estado mostrará Se necesita más información, y el correo electrónico proporcionará los detalles de lo que se debe corregir antes de volver a enviar la solicitud. Si tienes preguntas sobre tu envío, puedes comunicarte con el equipo de asistencia directamente desde la Consola de Google Pay y la Billetera de Google.
¿Cómo puedo solucionar los problemas de mi integración de la API de Google Pay si veo un mensaje de error?
Para conocer los códigos de error comunes y sus soluciones, consulta nuestras guías de solución de problemas para Android y la Web. Si tienes más preguntas, comunícate con el equipo de asistencia a través de la Consola de Google Pay y la Billetera de Google.
¿Cómo puedo personalizar mi integración de la API de Google Pay para restringir tarjetas?
Todas las personalizaciones de las tarjetas están disponibles en el objeto CardParameters para Android y la Web. Por ejemplo, puedes elegir qué redes de tarjetas quieres permitir y qué países emisores de tarjetas quieres permitir.
¿Qué es la API de Google Pay?
La API de Google Pay permite que tus clientes paguen con solo presionar un botón con las formas de pago guardadas en su Cuenta de Google. La API proporciona una confirmación de compra simple a millones de usuarios con cientos de millones de tarjetas guardadas. Ofrece mayor seguridad, ya que los datos de pago de los clientes se encriptan de extremo a extremo desde los servidores de Google hasta tu procesador de pagos. Es un proceso de integración sencillo que funciona con tu pila de procesamiento de pagos existente y se puede implementar con unas pocas líneas de código.
¿Cómo se relacionan la API de Google Pay y la API de Google Wallet?
La API de Google Pay y la API de Google Wallet son dos APIs independientes. La API de Google Pay permite que tus clientes usen Google Pay como forma de pago en tu sitio web o aplicación para Android. La API de Google Wallet permite que los desarrolladores creen y administren pases digitales para una variedad de casos de uso. Por ejemplo, tarjetas de lealtad, entradas, pases de acceso, registros de salud y otros elementos personalizables. Para obtener más información sobre la API de Google Wallet, consulta la documentación para desarrolladores de la API de Google Wallet.

¿Cuál es la versión actual de la API de Google Pay y cómo se manejan las actualizaciones?
La versión actual se indica en la documentación de Android y la Web. Google mantuvo esta versión durante varios años y solo agregó funciones nuevas y campos opcionales. Todas las actualizaciones que se realicen en la API son retrocompatibles para garantizar que no se interrumpan las integraciones actuales.
¿Qué plataformas admiten DPAN (CRYPTOGRAM_3DS) en comparación con FPAN (PAN_ONLY)?
Los DPAN son específicos de Android y solo están disponibles cuando se realiza el pago en dispositivos Android o en la Web móvil o en WebView de Android. La Web para computadoras y los dispositivos iOS no admiten DPAN y, de forma predeterminada, devolverán PAN_ONLY.
¿Cómo diferenciamos entre un DPAN y un FPAN, y cómo se deben manejar?
En lugar de identificar estrictamente los DPAN frente a los FPAN, el objeto assuranceDetails está diseñado para ayudar a los comercios a determinar si una transacción debe someterse a una autenticación reforzada a través de 3D Secure para cumplir con los requisitos de la autenticación reforzada de clientes (SCA). Para recibir estos detalles, los comercios deben agregar assuranceDetailsRequired: true al parámetro de la tarjeta en su solicitud a la API de Google Pay.
¿Cuál es la diferencia entre cardHolderAuthenticated y accountVerified?
Cuando assuranceDetailsRequired se establece en true en la solicitud, la respuesta incluirá dos propiedades:
  • accountVerified: Indica que la tarjeta que se usó para pagar es auténtica y que la cuenta está en regla. Sin embargo, esta verificación por sí sola no proporciona protección de autorización.
  • cardHolderAuthenticated: Indica que el usuario comenzó la transacción con su dispositivo Android y usó un token de red aprovisionado basado en el dispositivo.
¿Cómo usamos estos parámetros para activar 3D Secure?
Los comercios deben usar estos parámetros para crear su lógica de activación de 3D Secure. Si ambos cardHolderAuthenticated y accountVerified devuelven true, las credenciales se consideran altamente seguras y compatibles con la SCA, y no es necesario que aumentes la seguridad de la transacción para una mayor autenticación con 3DS.
¿Los comercios recibirán tokens de comercio electrónico si configuran assuranceDetailsRequired: true?
No, los tokens de comercio electrónico se controlan a nivel del PSP.
¿Las transacciones de Google Pay son aptas para el cambio de responsabilidad?
La disponibilidad de la transferencia de responsabilidad depende de la red de la tarjeta. Consulta Habilita la transferencia de responsabilidad de Visa para obtener más detalles.
¿Cómo podemos identificar las transacciones de Compra ahora y paga después (BNPL)?
Actualmente, no hay un identificador específico para las transacciones de BNPL. Aparecerán en tu sistema como credenciales de FPAN normales.
¿Google puede proporcionar tarjetas de prueba para probar situaciones de SCA?
La API de Google Pay no puede proporcionar directamente ninguna tarjeta de prueba de SCA. Tu PSP debería poder usar su paquete de tarjetas de prueba en su entorno de zona de pruebas para tus necesidades de prueba.
¿Cuál es el vencimiento o el tiempo de actividad (TTL) de la credencial de pago encriptada?
La carga útil encriptada de Google Pay vence exactamente después de una semana. Los comercios que manejan autorizaciones retrasadas o procesamiento asíncrono deben asegurarse de que el pago se autorice con su proveedor de servicios de pago (PSP) dentro de este período antes de que venza la carga útil.
¿Cómo se manejan las operaciones posteriores a la compra, como los reembolsos y las reautorizaciones?
Google Pay no participa en el flujo de dinero y actúa estrictamente como un intermediario para la credencial con asignación de token. Una vez que se produce la transacción inicial, tu proveedor de servicios de pago (PSP) asigna la información de pago en la carga útil encriptada a su propio token patentado (como un "token de comercio" o un "ID de perfil del cliente"). Todas las interacciones posteriores a la compra y los movimientos de dinero se administran por completo entre tú y tu PSP.
¿Cómo funciona el establecimiento dinámico de precios con las transacciones iniciadas por el comercio?
Actualmente, las transacciones iniciadas por el comercio (MIT) no admiten los precios dinámicos. Esta es una limitación conocida.
¿Qué configuración de la Política de Seguridad del Contenido (CSP) se requiere para Google Pay en un WebView?

Si usas una Política de Seguridad del Contenido (CSP), asegúrate de establecer los valores correctos para la directiva connect-src para permitir que se use Google Pay en tu WebView. Por ejemplo:

Content-Security-Policy: connect-src pay.google.com google.com account.google.com www.google.com
¿Cómo uso un nonce de la Política de Seguridad del Contenido (CSP) con la API web de Google Pay?

Si tu sitio aplica una CSP estricta que requiere nonces para la ejecución de secuencias de comandos y estilos insertados de forma dinámica, haz lo siguiente:

  1. Incluye tu atributo nonce de la CSP en la etiqueta <script> que carga pay.js:

    <script
  async
  src="https://pay.google.com/gp/p/js/pay.js"
  nonce="your-nonce-value"
  onload="onGooglePayLoaded()">
</script>

  2. Pasa la propiedad nonce en PaymentOptions cuando crees una instancia de PaymentsClient:

    const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'TEST',
  nonce: 'your-nonce-value'
});

Google Pay aplica este atributo nonce a todos los elementos <style> y <script> insertados de forma dinámica, incluidos los estilos de botones creados por createButton().

¿La API de Google Pay usa o requiere la cookie de NID durante la confirmación de compra?

No. La cookie NID no se usa para el proceso de confirmación de compra de la API de Google Pay ni lo admite.

La cookie NID está asociada con un servicio de Google del lado del servidor diseñado para almacenar datos personalizados de los usuarios que no accedieron a una Cuenta de Google.

Las funciones esenciales del servicio, incluidas la seguridad, la prevención de fraudes y la confiabilidad del servicio, operan de forma independiente de la cookie de NID. La API de Google Pay está diseñada para mantener una experiencia segura y confiable para los comercios y los usuarios, independientemente de la presencia de esta cookie.

Google se compromete a proteger la privacidad y garantiza que estas cookies se manejen de conformidad con la Política de Privacidad y la Política de Tecnologías y Cookies de Google. Estos recursos pueden resultarte útiles para tu documentación de cumplimiento y para brindar más transparencia a tus usuarios.