Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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 tokenizadas 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 pago 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 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
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 controlar las reversiones de transacciones por cancelaciones, reembolsos o disputas de la misma manera en que controlan 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 recaudar donaciones, pero solo si proporcionan documentación para demostrar, certificar y validar 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.
Condiciones y políticas
Condiciones del Servicio de la API de Google Pay
Todos los comercios deben aceptar las Condiciones del Servicio de la API de Google Pay y cumplirlas.
Política de Uso Aceptable de la API de Google Pay
Todos los comercios deben aceptar la Política de Uso Aceptable de la API de Google Pay y cumplir con ella.
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 ocasionalmente. 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
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, podremos 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 a la API de Google Pay. Luego, podemos evaluar tu integración solo para la Web
para el acceso de 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 de 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 de carreras de perros.
Se prohíben las apuestas con hándicap.
Se prohíben las bolsas 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 de carreras de perros.
Se prohíben las apuestas con hándicap.
Se prohíben las bolsas de apuestas.
Finlandia
Sí, con restricciones:
Veikkaus Oy cumple con los requisitos.
Sí, con restricciones:
Veikkaus Oy cumple con los requisitos.
Kazajistán
Sí, con restricciones:
Se permiten las loterías.
Los anuncios de apuestas deportivas son aptos.
Los totalizadores son aptos.
Se prohíben los casinos en línea.
Se prohíben los casinos electrónicos.
Sí, con restricciones:
Se permiten las loterías.
Los anuncios de apuestas deportivas son aptos.
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:
Las apuestas deportivas en línea son aptas.
Si expandes la API de Google Pay a un país para el que no se te había aprobado anteriormente, 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 dirigidos a personas menores de edad o que tienen prohibido participar en juegos de apuestas según las leyes locales.
Política de atención médica
Nuestra política sobre el sector de la salud 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 cuando realices la integració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 todos los riesgos y la autenticación reforzada del cliente. ¿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 que se muestran son tarjetas con PAN o tarjetas tokenizadas compuestas por el PAN del dispositivo (DPAN) y criptogramas.
Las cargas útiles de tarjetas con asignación de token 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 emisor.
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 de comerciante de Google después de que Google apruebe tu sitio web. Para iniciar el proceso, accede a Google Pay & Wallet Console y crea una integración de la API de Google Pay. Debes proporcionar una lista de dominios calificados por completo junto con los subdominios, que te ayudarán a llamar a la API de Google Pay.
¿Podemos usar un solo ID de Merchant en varias marcas y canales (Web/App)?
Sí, se admite el uso de un solo ID de Merchant 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 procesadores que admiten Google Pay, consulta nuestra lista de
procesadores de Google Pay.
¿Cuál es la diferencia entre la facturación integrada en la aplicación de Google Play y la API de Google Pay?
Los desarrolladores de Google Play que venden bienes y servicios digitales en apps para Android deben usar la Facturación
integrada en la app de Google Play, como se especifica en el
Centro de políticas para desarrolladores de Play. Algunos ejemplos de la Facturación integrada son los productos virtuales para 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 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 comisiones?
Google Pay no cobra tarifas adicionales a los usuarios, comercios ni desarrolladores por usar la
API de Google Pay para 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 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 fraude con las transacciones de Google Pay.
¿Se admite Google Pay en WebViews de apps para dispositivos móviles?
Los WebViews de Android son totalmente compatibles con Google Pay y simulan la experiencia web para dispositivos móviles, siempre que agregues la dependencia de WebKit necesaria. Sin embargo, en las WebView de iOS, la API de isReadyToPay siempre devolverá false debido a las restricciones de iOS en las cookies de terceros. Tanto la app para Android como el dominio del sitio web dentro de WebView deben estar aprobados para el acceso de producción. Para obtener detalles específicos de la implementación, consulta la documentación sobre cómo usar WebView en Android o cómo usar WKWebView en iOS.
Mi procesador no aparece en la lista. ¿Aún puedo realizar la integración 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 de asistencia?
Los procesadores de pagos compatibles pueden implementar nuestra solución de confirmación de compra alojada para 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 compatible. Para integrar la solución de confirmación de compra alojada, comunícate con tu punto de contacto técnico de Google que te ayudó a completar la incorporación.
¿Cómo puede Google Pay adaptarse a diferentes opciones de envío y precios para mis usuarios si ofrezco envíos en mi flujo 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 al pasar la información de pago de los usuarios a tu
proveedor de servicios de pago. No se incluye en el flujo de dinero y está diseñada para complementar 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 los dominios comodín (p.ej., *.merchant.com) no se aceptan.
Consulta la página Publica tu integración para Android o Web para obtener más información.
¿Cómo puedo conocer el estado de mi envío de integración y saber si debo realizar algún cambio después del proceso de revisión?
Después de enviar la 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 Google Pay & Wallet Console. 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 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 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 del cliente 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 la Billetera de Google?
La API de Google Pay y la API de la Billetera de Google 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 la Billetera de Google, consulta la documentación para desarrolladores de la API de la Billetera de Google.
¿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 realizadas en la API son compatibles con versiones anteriores para garantizar que no se interrumpan las integraciones actuales.
¿Qué plataformas admiten DPAN (CRYPTOGRAM_3DS) en lugar de 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/WebView de Android. Los dispositivos iOS y la Web para computadoras no admiten DPAN y, de forma predeterminada, devolverán PAN_ONLY.
¿Cómo diferenciamos un DPAN de un FPAN y cómo se deben controlar?
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 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 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 del cambio de responsabilidad depende de la red de tarjetas. MasterCard la proporciona automáticamente para las transacciones con token calificadas, mientras que Visa requiere que los comercios habiliten la opción manualmente a través de Google Pay Console. 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.
¿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 demoradas 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 tokenizada. 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.
[[["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-02-27 (UTC)"],[],["The Google Pay API allows customers to use saved cards for in-app and website checkouts. Merchants can receive support through the Google Pay & Wallet Console and utilize troubleshooting guides. The API supports recurring billing and auto-reloads without repetitive API calls, managing these through payment gateway APIs. Google Pay does not charge additional fees, but merchants still have processing costs. Merchants need to follow specific policies and provide documentation to collect donations or use services like gambling, healthcare and financial services.\n"]]