Preguntas frecuentes
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 las compras sin problemas en tus apps
y sitios.
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 recurrente y suscripciones
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 del 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.
Las condiciones de pago se divulgan y el usuario las acepta dentro del 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 del lado del comercio y se reutiliza. 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 organizaciones sin fines de lucro de EE.UU. deben proporcionar una prueba válida del estado 501(c)3 del IRS para cumplir con los requisitos.
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 expandir 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 en uno de los países mencionados anteriormente, debes
cumplir con la
política de juegos de apuestas de Google Play
y, primero, completar el
proceso de verificación
de Google Play. Luego, podremos evaluar tu integración solo para Android para el acceso a 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 a la API de Google Pay. Luego, podremos evaluar tu integración solo para la Web
y otorgarte acceso a producción a 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
Se permiten las integraciones de juegos de apuestas en los países indicados 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 apto.
Sí, con restricciones:
Veikkaus Oy es apto.
Kazajistán
Sí, con restricciones:
Las loterías son aptas.
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 aptas.
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:
Las apuestas deportivas en línea son aptas.
Sí, con restricciones:
Se permiten las apuestas deportivas en línea.
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 los 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 cuando realices la integració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 las 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 tokenizadas se procesan sin autenticación adicional ni desafío.
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 PSP administra toda la lógica de riesgo y de 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 pagos.
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 del comerciante de Google?
Puedes obtener un ID de 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 de 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 directamente una descripción 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 los procesadores que admiten Google Pay, consulta nuestra lista de procesadores de Google Pay.
¿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 artículos y servicios 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 Facturación integrada son los productos de juegos virtuales, 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 en la aplicación.
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 tarifas adicionales a los usuarios, comercios ni desarrolladores por usar la
API de Google Pay para realizar pagos. Específicamente, los comercios siguen pagando comisiones de 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 propio basado en
datos de instrumentos, perfiles de Cuentas de Google, historial de compras, ubicaciones y datos de dispositivos.
Sin embargo, los comercios deben seguir usando sus herramientas actuales de evaluación de riesgos y fraude 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?
¿Cómo puedo ofrecer Google Pay a gran escala a mis comercios si soy un procesador de pagos compatible?
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?
¿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 como una capa superior de 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 aloja 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 desarrollo de la marca, se aprobará y mostrará el estado Activo en la consola de Google Pay y la Billetera. Si necesita cambios, el estado mostrará Needs More Info, y el correo electrónico proporcionará los detalles de lo que se debe corregir antes de que vuelvas a enviar la solicitud. Si tienes alguna pregunta 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 problemas con mi integración de la API de Google Pay si veo un mensaje de error?
Para conocer los códigos de error y las resoluciones comunes, 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 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 app 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
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 las WebViews 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 y 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 del cliente (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 estas marcas para activar 3D Secure?
Los comercios deben usar estos parámetros para compilar su lógica de activación de 3D Secure. Si tanto
cardHolderAuthenticated como accountVerified se devuelven como true,
las credenciales se consideran altamente seguras y cumplen con la SCA, por lo que no es necesario que intensifiques la
transacción para una autenticación 3DS adicional.
¿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?
¿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.
¿Puede Google 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 el establecimiento dinámico de precios. 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:
¿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:
Incluye el atributo nonce de tu CSP en la etiqueta <script> que carga pay.js:
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, como la seguridad, la prevención de fraudes y la confiabilidad del servicio,
operan de forma independiente de la cookie 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 acuerdo 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-10-15 (UTC)"],[],["The Google Pay API allows customers to use saved cards for checkout in apps and websites. Merchants can manage recurring billing and auto-reloads by storing payment credentials and using payment gateway APIs. Nonprofits can collect donations with proper documentation. The API supports tokenized and PAN cards, with specific handling for 3D Secure. Gambling, healthcare, and financial service integrations require specific licenses and adherence to policies. Google does not charge additional fees but Merchants are still responsible for fraud, risk assessments and payment processor fees.\n"]]
