Pagos con Google Pay

Con Direct API tú controlas la experiencia completa: renderizas el botón de Google Pay™ con el SDK oficial de Google, recibes el token de pago y creas el cargo directamente en POST /orders. Es la integración con mayor flexibilidad — y la única que requiere registro propio en la Google Pay & Wallet Console para producción.

📘
¿Buscas algo más simple?
Si usas Link de Pago, Checkout redireccionado o el Component embebido, no necesitas registrarte en Google ni nada de esta sección: ve a Google Pay en Checkout.

Ficha del método

Propiedad	Detalle
Plataformas	Sitio web (librería JS de Google Pay) · App Android (SDK nativo) · App iOS (SDK de Google Pay)
Dispositivos	Android, escritorio (Windows / Mac / Linux) e iOS
Navegadores	Chrome, Safari, Firefox, Edge y Opera (escritorio y móvil)
Autenticación	`CRYPTOGRAM_3DS` (token de dispositivo con criptograma, en Android) y `PAN_ONLY` (tarjeta guardada en la cuenta de Google, en escritorio e iOS)
Reembolsos	Totales y parciales, igual que un cargo de tarjeta
Gateway	`gateway: "conektagpay"` + `gatewayMerchantId: "conekta"` (valores fijos)

1. Cumple los requisitos previos

Registro en Google Pay & Wallet Console. Para producción debes registrarte en la Google Pay & Wallet Console, completar la verificación de Google y obtener la aprobación de tu merchant. En sandbox no es necesario — Google Pay permite pruebas sin registro.

Requisitos técnicos:

Sitio web con HTTPS habilitado (o app Android/iOS).
Navegador o dispositivo compatible con Google Pay.
Capacidad de llamar a la API de Conekta desde tu backend (Cómo obtener tus API Keys).

📘
Alcance del botón
Google Pay soporta dos métodos de autenticación y te recomendamos habilitar ambos en tu allowedAuthMethods: CRYPTOGRAM_3DS (token de dispositivo con criptograma, en Android) y PAN_ONLY (tarjeta guardada en la cuenta de Google, en escritorio e iOS). Con ambos, el botón se renderiza en Android, escritorio e iOS; si solo incluyes CRYPTOGRAM_3DS, quedará limitado a Android + Chrome.

2. Integra el botón en tu plataforma

Botón en tu sitio web

Carga la librería de Google, configura el PaymentDataRequest con el gateway de Conekta y procesa el token en POST /orders.

Botón en tu app

Integración con el SDK nativo de Google Pay para Android y el SDK de Google Pay para iOS.

3. Prueba tu integración

Prueba en el sandbox de Conekta (llaves de prueba) con una tarjeta normal agregada a Google Wallet — el cargo no se procesa fuera del ambiente de pruebas. Simula rechazos con emails {motivo}[email protected] en el campo customer_info.email de la orden; la lista completa de escenarios está en el kit de pruebas.

4. Sal a producción

Cuando tu integración esté lista, solicita la aprobación de tu merchant productivo en la Google Pay & Wallet Console: perfil de negocio, screenshots del flujo de compra y ajustes técnicos post-aprobación (merchantId productivo y environment: 'PRODUCTION').

Aprobación de Merchant Productivo — Google Pay

Guía completa: tips de perfil, screenshots requeridos, motivos comunes de rechazo y ajustes finales.

👍
Ver también

Google Pay en Checkout — la integración sin registro en Google Console.

Kit de pruebas — escenarios de prueba para wallets.

Google Pay es una marca de Google LLC.