Preguntas frecuentes

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

Acerca de la API de Google Pay

Google Pay permite tramitar las compras sin esfuerzo en tu aplicación y sitio web. Con la API de Google Pay, tus clientes pueden usar las tarjetas guardadas en sus cuentas de Google para completar las compras sin problemas en tus aplicaciones y sitios.

Cómo obtener asistencia

Regístrate en la Consola de Google Pay y Wallet y selecciona Contactar con el servicio de asistencia. Podemos ayudarte a solucionar los problemas de tus integraciones. Además, consulta nuestras guías para solucionar problemas en Android y solucionar problemas en la Web para depurar tu integración.

Funciones disponibles

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 periódicas

La compatibilidad con la facturación periódica está vinculada al método de pago devuelto en la respuesta de la API de Google Pay. Tanto las tarjetas tokenizadas como las registradas se pueden usar para la facturación periódica. Para procesar la facturación periódica, el comerciante no tiene que llamar a nuestra API a una cadencia. En su lugar, la credencial de pago se almacena en el lado del comerciante para los pagos periódicos. El comercio usa las APIs de su pasarela de pagos para gestionar la facturación periódica.

Google Pay admite pagos periódicos si se cumplen las siguientes condiciones:

  • Los comerciantes cumplen las reglas de la red, como las transacciones iniciadas por el comerciante.
  • El usuario conoce y acepta las condiciones de pago en el flujo de compra del comerciante.

También admitimos la facturación periódica con importes variables. Por ejemplo, se admiten las facturas telefónicas mensuales de operadores móviles. Para obtener más información, los comerciantes deben ponerse en contacto con el representante de su pasarela de pago.

Recarga automática

Para procesar un cargo de recarga automática por el mismo coste, el comerciante no tiene que llamar a nuestra API cada vez. La credencial de pago se almacena en el lado del comerciante y se reutiliza. Para obtener más información, los comerciantes deben ponerse en contacto con el representante de su pasarela de pago.

Devoluciones de cargos

Los comerciantes pueden gestionar las anulaciones de transacciones por cancelaciones, reembolsos o disputas de la misma forma que gestionan las devoluciones de cargos de otras formas de pago. Para obtener más información, los comerciantes deben ponerse en contacto con el representante de su procesador.

Recogida de donaciones

Las organizaciones sin ánimo de lucro aprobadas pueden integrar la API Google Pay para recaudar donaciones, pero solo si proporcionan documentación que demuestre, certifique y valide su condición de organización sin ánimo de lucro. Por ejemplo, las organizaciones sin ánimo de lucro de EE. UU. deben proporcionar una prueba válida de su estado 501(c)3 del IRS para poder participar.

Términos y políticas

Términos del Servicio de la API de Google Pay

Todos los comerciantes deben aceptar y cumplir los Términos del Servicio de la API de Google Pay.

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

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

Política de juegos de azar y apuestas

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

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

Aceptamos integraciones de juegos de azar y apuestas de empresas ubicadas en los siguientes países:

  • Australia
  • Austria
  • Canadá
  • Chequia
  • Francia
  • Georgia
  • Alemania
  • Grecia
  • Hungría
  • Irlanda
  • Italia
  • Japón
  • Países Bajos
  • Polonia
  • Portugal
  • Rumanía
  • España
  • Suecia
  • Reino Unido

Más adelante, podríamos ampliar la asistencia más allá del nivel actual.

Para obtener acceso a producción a la API de Google Pay para integraciones de juegos de azar y apuestas, debes cumplir una serie de requisitos:

  • Si tienes una integración de juegos de azar y apuestas solo para Android y tu empresa está ubicada en uno de los países mencionados anteriormente, primero debes cumplir la política de juegos de azar y apuestas de Google Play y superar el proceso de verificación de Google Play. A continuación, podemos evaluar tu integración exclusiva para Android para concederte acceso a producción a la API de Google Pay.
  • Si tienes una integración de juegos de azar y apuestas solo para web y tu empresa está ubicada en uno de los países mencionados anteriormente, debes enviar una licencia autorizada para demostrar que cumples los requisitos para ofrecer servicios de juegos de azar y apuestas en el país durante el proceso de incorporación a la API Google Pay. A continuación, podemos evaluar tu integración solo para web para concederte acceso a producción a la API de Google Pay.
  • Si tienes una integración de juegos de azar y apuestas para Android y la Web en uno de los países mencionados anteriormente, primero debes cumplir la política de juegos de azar y apuestas de Google Play y completar el proceso de verificación de Google Play. De esta forma, podremos evaluar tus integraciones de Android y web para concederte acceso a producción a la API de Google Pay.

Países con condiciones o restricciones específicas

Se permiten las integraciones de juegos de azar y apuestas en los países que se indican a continuación si cumplen los siguientes criterios:

País Requisitos para la integración con Android Requisitos para la integración web
Bulgaria Sí, con restricciones:
  • Las aplicaciones que redirigen a un sitio web cumplen los requisitos.
  • Las aplicaciones que no redirijan a un sitio web están prohibidas.
 Sí
Chipre Sí, con restricciones:
  • La lotería estatal cumple los requisitos.
  • OPAP Cyprus Limited cumple los requisitos.
  • Los casinos online están prohibidos.
  • Las máquinas tragaperras están prohibidas.
  • Las apuestas de carreras de caballos están prohibidas.
  • Las apuestas de carreras de galgos están prohibidas.
  • Las apuestas financieras están prohibidas.
  • Las bolsas de apuestas están prohibidas.
 Sí, con restricciones:
  • La lotería estatal cumple los requisitos.
  • OPAP Cyprus Limited cumple los requisitos.
  • Los casinos online están prohibidos.
  • Las máquinas tragaperras están prohibidas.
  • Las apuestas de carreras de caballos están prohibidas.
  • Las apuestas de carreras de galgos están prohibidas.
  • Las apuestas financieras están prohibidas.
  • Las bolsas de apuestas están prohibidas.
Finlandia Sí, con restricciones:
  • Veikkaus Oy cumple los requisitos.
 Sí, con restricciones:
  • Veikkaus Oy cumple los requisitos.
Kazajistán Sí, con restricciones:
  • Las loterías se pueden anunciar.
  • Las apuestas deportivas se pueden anunciar.
  • Los totalizadores son aptos.
  • Los casinos online están prohibidos.
  • Los casinos electrónicos están prohibidos.
 Sí, con restricciones:
  • Las loterías se pueden anunciar.
  • Las apuestas deportivas se pueden anunciar.
  • Los totalizadores son aptos.
  • Los casinos online están prohibidos.
  • Los casinos electrónicos están prohibidos.
Polonia No Sí, con restricciones:
  • Los proveedores de juegos de azar y apuestas con licencia pueden participar.
Sudáfrica Sí, con restricciones:
  • Se pueden promocionar las apuestas deportivas online.
 Sí, con restricciones:
  • Se pueden promocionar las apuestas deportivas online.

Si amplías la API de Google Pay a un país para el que no tenías aprobación, ponte en contacto con nosotros para obtener la aprobación para la expansión. Ten en cuenta que deberás proporcionar una licencia de juegos de azar y apuestas autorizada para cada país en el que tengas previsto ofrecer servicios relacionados con juegos de azar y apuestas. No permitimos que se use la API Google Pay para ofrecer servicios de juegos de azar y apuestas a menores de edad o a personas que tengan prohibido participar en juegos de azar y apuestas de acuerdo con la legislación local.

Política sanitaria

Nuestra política sobre el sector sanitario se define en la Política de Uso Aceptable de la API de Google Pay.

Prepara una licencia pertinente para compartirla durante el proceso de incorporación y validar tu caso práctico en el ámbito de la atención sanitaria. Todos los envíos están sujetos a revisión y aprobación.

Política de servicios financieros

Nuestra política de servicios financieros se define en la Política de Uso Aceptable de la API de Google Pay.

Prepara una licencia pertinente para compartirla durante el proceso de incorporación y validar tu caso práctico 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 comerciantes:

Uso un proveedor de servicios de pago importante para gestionar todos los riesgos y la autenticación reforzada de clientes. ¿Qué debo saber sobre GPay?

La API Google Pay devuelve los métodos de pago en una carga útil firmada y cifrada. Los métodos de pago devueltos constan de tarjetas PAN o tokenizadas compuestas por PAN de dispositivo (DPAN) y criptogramas.

Las cargas útiles de tarjetas tokenizadas se procesan sin pasos ni verificaciones adicionales.

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

Si tu proveedor de servicios de pago gestiona toda la lógica de riesgo y de autenticación reforzada de clientes, asegúrate de que tu integración de la API de Google Pay incluya las siguientes propiedades:

  • merchantInfo.merchantName (Android, Web): el nombre del comerciante se muestra en la hoja de pago.
  • transactionInfo.countryCode (Android, Web): indica dónde se procesan las transacciones. Debe especificar el país del banco adquirente.
  • transactionInfo.totalPrice (Android, Web): el valor monetario total de la transacción con una precisión decimal opcional de dos decimales.
¿Cómo puedo obtener un ID de comerciante de Google?
Puede obtener un ID de comerciante de Google después de que Google apruebe su sitio web. Para iniciar el proceso, inicie sesión en la Consola de Google Pay y Wallet y cree una integración de la API de Google Pay. Debe proporcionar una lista de dominios completos junto con subdominios, que le ayudarán a llamar a la API de Google Pay.
¿Podemos usar un único ID de comerciante en varias marcas y canales (web o aplicación)?
Sí, se puede usar un único ID de comerciante en varias marcas y plataformas (como la Web y Android), y, por lo general, se recomienda para simplificar la conciliación.
¿Cómo pueden los comerciantes promocionar la aceptación de Google Pay en sus aplicaciones y sitios entre sus usuarios?
Para destacar la compatibilidad con Google Pay, asegúrate de usar los recursos disponibles en nuestras directrices de marca para Android y Web.
Si tienes una integración con Android, puedes indicar en la descripción de Play Store que ahora ofreces compatibilidad con Google Pay. En el caso de las integraciones web, puede añadir directamente una descripción al sitio web del comerciante.
¿Pueden las plataformas de comercio electrónico admitir Google Pay?
Sí, la API de Google Pay admite la incorporación de plataformas de comercio electrónico. Los partners de procesadores de pagos, pasarelas o plataformas de comercio electrónico que alojan una página de tramitación de la compra en nombre de sus comerciantes pueden usar la función de comprar ahora alojada de Google Pay.
¿Qué proveedores de pagos admiten Google Pay?
Para ver una lista de los procesadores que admiten Google Pay, consulta nuestra lista de procesadores de Google Pay.
¿En qué países y regiones se puede usar Google Pay?
Consulta nuestra lista de países admitidos que usan Google Pay para hacer pagos online o en aplicaciones.
¿En qué países y regiones se admiten los tokens de Google Pay (CRYPTOGRAM_3DS)?
Consulta nuestra página Métodos de pago admitidos para pagos en tienda y contactless para ver una lista de países y los bancos de cada uno de ellos que admiten tokens de Google Pay. (CRYPTOGRAM_3DS) Se muestran tanto las tarjetas admitidas como las no admitidas.
¿Cuál es la diferencia entre la Facturación en Google Play por Compras en Aplicaciones y la API de Google Pay?
Los desarrolladores de Google Play que vendan productos y servicios digitales en aplicaciones Android deben usar la Facturación en Google Play por Compras en Aplicaciones, tal como se especifica en el Centro de Políticas para Desarrolladores de Google Play. Entre los ejemplos de Facturación por compras en aplicaciones se incluyen productos virtuales de juegos, funciones o contenido de aplicaciones y productos de software en la nube. Consulta la página Descripción general de Facturación de Google Play para obtener más información sobre la facturación por compras en aplicaciones.
Cuando se usa en aplicaciones, la API de Google Pay solo está disponible para productos y servicios físicos.
¿Google Pay cobra alguna comisión?
Google Pay no cobra comisiones adicionales a los usuarios, los comerciantes ni los desarrolladores por usar la API de Google Pay para pagos. En concreto, los comerciantes siguen pagando comisiones de procesamiento a su procesador de pagos.
¿Qué hace Google para validar las credenciales y evitar fraudes?
Todas las tarjetas añadidas a Google pasan por una autorización de verificación para validar la información de la tarjeta, incluido el Código de verificación de tarjeta (CVC). Google también utiliza un motor de riesgo propietario basado en datos de instrumentos, perfiles de cuentas de Google, historial de compras, ubicaciones e información de dispositivos. Sin embargo, los comerciantes deben seguir usando sus herramientas actuales de evaluación de riesgos y fraudes con las transacciones de Google Pay.
¿Google Pay es compatible con WebViews de aplicaciones móviles?
Los WebViews de Android son totalmente compatibles con Google Pay y simulan la experiencia web móvil, siempre que añadas la dependencia de WebKit necesaria. Sin embargo, en las vistas web de iOS, la API isReadyToPay siempre devolverá el valor false debido a las restricciones de iOS en las cookies de terceros. Tanto la aplicación Android como el dominio del sitio web de WebView deben aprobarse para obtener acceso a producción. Para obtener información específica sobre la implementación, consulta la documentación sobre uso de WebView en Android o uso de WKWebView en iOS.
Mi procesador no aparece en la lista. ¿Puedo seguir integrando Google Pay?
Google Pay está creando continuamente colaboraciones 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 tu procesador esté disponible.
¿Cómo habilito Google Pay si ya tengo un procesador de pagos o un proveedor de plataforma de pagos?
Google Pay funciona con varios proveedores de servicios de pago y proveedores de plataformas de comercio electrónico. Cada uno de ellos ofrece documentación específica y personalizada para ayudarte a dar los primeros pasos, así como nuestro tutorial principal para que la configuración sea sencilla.
¿Cómo puedo ofrecer Google Pay a gran escala a mis comerciantes si soy un procesador de pagos admitido?
Los procesadores de pagos admitidos pueden implementar nuestra solución de checkout alojada para integraciones web. La tramitación de la compra alojada permite a tus clientes ofrecer Google Pay a sus clientes y omitir la configuración individual de Google Pay.

Para empezar, primero debes incorporarte como procesador de pagos admitido. Para integrar la solución de tramitación de la compra alojada, ponte en contacto con el punto de contacto técnico de Google que te ayudó a completar el proceso de incorporación.

¿Cómo puede Google Pay adaptarse a las diferentes opciones y precios de envío para mis usuarios si ofrezco envíos en mi proceso de compra?
En las integraciones web, se necesita una dirección de envío y se muestran diferentes opciones de envío y precios en el objeto PaymentDataRequest, el objeto PaymentOptions y el objeto PaymentDataCallbacks. Para ver un ejemplo, consulta la demo de actualización dinámica de precios.

En las integraciones de Android, necesitas una dirección de envío en el objeto PaymentDataRequest.

¿Cómo recibo el dinero de las compras realizadas con Google Pay?
La API Google Pay facilita las transacciones transfiriendo los datos para pagos de los usuarios a tu proveedor de servicios de pago. No forma parte del flujo de dinero y se ha diseñado para que se integre en tu infraestructura de pagos actual.
¿Cuáles son los requisitos para obtener acceso a producción?
Los comerciantes deben crear un Perfil de Empresa en la Consola de Google Pay y Wallet, y subir capturas de pantalla de su flujo de compra para que se revise. Cada dominio que aloje la API Google Pay debe enviarse para su aprobación de forma individual, ya que no se aceptan dominios comodín (por ejemplo, *.merchant.com). Consulta más información en la página Publicar tu integración para Android o Web.
¿Cómo puedo saber el estado de mi envío de integración y si tengo que hacer algún cambio después del proceso de revisión?
Cuando envíes tu integración de la API de Google Pay para que se revise, recibirás un correo con los resultados. Si tu integración cumple nuestra Política de Uso Aceptable y las directrices de marca, se aprobará y mostrará el estado Activo en la Consola de Google Pay y Wallet. Si es necesario hacer cambios, el estado será Necesita más información y en el correo se indicará qué debe corregirse antes de volver a enviar la solicitud. Si tienes alguna pregunta sobre tu envío, puedes ponerte en contacto con el equipo de Asistencia directamente desde la Consola de Google Pay y Wallet.
¿Cómo puedo solucionar los problemas de mi integración de la API de Google Pay si veo un mensaje de error?
Para ver los códigos de error habituales y sus soluciones, consulta nuestras guías para solucionar problemas en Android y la Web. Si tienes alguna pregunta, ponte en contacto con el equipo de Asistencia a través de la Consola de Google Pay y Wallet.
¿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 tanto para Android como para web. Por ejemplo, puedes elegir qué redes de tarjetas quieres permitir y qué países de la entidad emisora de la tarjeta quieres permitir.
¿Qué es la API de Google Pay?
La API Google Pay permite a tus clientes pagar con solo pulsar un botón con los métodos de pago que hayan guardado en su cuenta de Google. La API ofrece un proceso de compra sencillo a millones de usuarios con cientos de millones de tarjetas guardadas. Ofrece más seguridad, ya que los datos de pago de los clientes están cifrados 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 y se puede implementar con tan solo unas líneas de código.
¿Qué relación hay entre 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 a tus clientes usar Google Pay como método de pago en tu sitio web o aplicación Android. La API de Google Wallet permite a los desarrolladores crear y gestionar pases digitales para diversos casos prácticos. Por ejemplo, tarjetas de fidelización, entradas, pases de acceso, historiales médicos 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 gestionan las actualizaciones?
La versión actual se indica en la documentación de Android y de la web. Google ha mantenido esta versión durante varios años y solo ha añadido funciones y campos opcionales. Las actualizaciones que se hagan en la API serán compatibles con versiones anteriores para que no se interrumpan las integraciones actuales.
¿Qué plataformas admiten DPANs (CRYPTOGRAM_3DS) y FPANs (PAN_ONLY)?
Los PANs digitales son específicos de Android y solo están disponibles al completar la compra en dispositivos Android o en la Web para móviles o las vistas web de Android. Los sitios web para ordenadores y los dispositivos iOS no admiten DPANs y, de forma predeterminada, devuelven PAN_ONLY.
¿Cómo diferenciamos entre un DPAN y un FPAN, y cómo debemos gestionarlos?
En lugar de identificar estrictamente los DPANs y los FPANs, el objeto assuranceDetails se ha diseñado para ayudar a los comerciantes a determinar si una transacción debe completarse mediante 3D Secure para cumplir los requisitos de autenticación reforzada de clientes (SCA). Para recibir estos detalles, los comerciantes deben añadir assuranceDetailsRequired: true al parámetro de tarjeta en su solicitud de la API de Google Pay.
¿Cuál es la diferencia entre cardHolderAuthenticated y accountVerified?
Cuando a assuranceDetailsRequired se le asigna el valor true en la solicitud, la respuesta incluirá dos propiedades:
  • accountVerified: indica que la tarjeta utilizada para pagar es auténtica y que la cuenta está al día. Sin embargo, esta verificación por sí sola no proporciona protección de autorización.
  • cardHolderAuthenticated: indica que el usuario ha iniciado la transacción con su dispositivo Android y ha usado un token de red aprovisionado y basado en el dispositivo.
¿Cómo usamos estas marcas para activar 3D Secure?
Los comerciantes deben usar estas marcas para crear su lógica de activación de 3D Secure. Si tanto cardHolderAuthenticated como accountVerified devuelven true, las credenciales se consideran muy seguras y conformes con la ARC, y no es necesario que aumentes la seguridad de la transacción para realizar una autenticación 3DS adicional.
¿Los comerciantes recibirán tokens de comercio electrónico si definen assuranceDetailsRequired: true?
No, los tokens de comercio electrónico se controlan a nivel del PSP.
¿Las transacciones de Google Pay cumplen los requisitos para la transferencia de responsabilidad?
La disponibilidad del cambio de responsabilidad depende de la red de la tarjeta. Mastercard lo proporciona automáticamente para las transacciones con token que cumplan los requisitos, mientras que Visa requiere que los comerciantes habiliten manualmente esta opción a través de la consola de Google Pay. Consulta más información en el artículo Habilitar el cambio de responsabilidad de Visa.
¿Cómo podemos identificar las transacciones de pago aplazado?
Actualmente, no hay ningún identificador específico para las transacciones de pago aplazado. Aparecerán en tu sistema como credenciales de FPAN normales.
¿Puede Google proporcionar tarjetas de prueba para probar escenarios de SCA?
La API de Google Pay no puede proporcionar ninguna tarjeta de prueba de SCA directamente. Tu proveedor de pagos debería poder utilizar su paquete de tarjetas de prueba en su entorno aislado para satisfacer tus necesidades de pruebas.
¿Cuál es la fecha de vencimiento o el tiempo de vida (TTL) de la credencial de pago cifrada?
La carga útil cifrada de Google Pay caduca exactamente al cabo de una semana. Los comerciantes que gestionen autorizaciones retrasadas o procesamiento asíncrono deben asegurarse de que el pago se autorice con su proveedor de servicios de pago (PSP) en este plazo antes de que caduque la carga útil.
¿Cómo se gestionan las operaciones posteriores a la compra, como los reembolsos y las nuevas autorizaciones?
Google Pay no participa en el flujo de dinero y actúa estrictamente como intermediario de la credencial tokenizada. Una vez que se produce la transacción inicial, tu proveedor de pagos (PSP) asigna la información para pagos de la carga útil cifrada a su propio token (por ejemplo, "Token de comerciante" o "ID de perfil de cliente"). Todas las interacciones posteriores a la compra y los movimientos de dinero se gestionan íntegramente entre usted y su PSP.