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 (Chrome) · App Android (SDK nativo) · App iOS (SDK de Google Pay)
Dispositivos	Android con Google Wallet con al menos una tarjeta agregada
Navegadores	Chrome en Android
Autenticación	Solo `CRYPTOGRAM_3DS` (token de dispositivo con criptograma 3DS). `PAN_ONLY` no está soportado
Reembolsos	Totales y parciales, igual que un cargo de tarjeta
Gateway	`gateway: "conekta"` + tu `gatewayMerchantId`

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
Como el único método de autenticación soportado es CRYPTOGRAM_3DS, el botón de Google Pay solo se renderiza cuando el entorno del usuario puede generar ese tipo de token: dispositivo Android + Chrome + Google Wallet con una tarjeta válida agregada.

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.