DIRECT
¿No sabes qué integración usar? Consulta la descripción general de Google Pay para comparar las tres opciones.
Requisitos
Antes de comenzar, asegúrate de cumplir los requisitos generales de Google Pay. Además, debes registrarte en la Google Pay Business Console para obtener un ID de comercio de Google. Completa la configuración de la consola siguiendo estos pasos:- Completa el Business Profile
-
Revisa la información requerida en Google Pay API > Integrate with your website:
- Tu sitio web: debe coincidir exactamente con el dominio de tu página de checkout alojada (con o sin “www”)
- Tipo de integración: GATEWAY
- Capturas de pantalla:
- Pantalla del método de pago: tu página de checkout alojada
- Pantalla de pago de la API de Google Pay: la hoja de pago de Google Pay (se muestra después de hacer clic en el botón de GPay)
- Pantalla posterior a la compra: página de confirmación de la transacción
- Envía las capturas de pantalla, indica que has enviado la solicitud y comparte el merchantId (BCR)
Integración
Para integrar Google Pay con Yuno, sigue estos pasos:- En el dashboard de Yuno, ve a la pestaña Connections. Busca Google Pay y haz clic en Connect. Ingresa tus credenciales en el panel lateral. Elige un nombre para la conexión y usa el ID de comercio obtenido de la Google Pay Business Console en el campo Merchant ID.

- Crea una ruta en el dashboard de Yuno usando el procesador que quieras para los pagos con Google Pay. Consulta la guía Configurar el enrutamiento dinámico para obtener más información.
Habilita y prueba Google Pay con Yuno
Después de integrar, puedes habilitar y probar Google Pay con Yuno de la siguiente manera:- Crea una cuenta de prueba de Google Wallet:
- Visita la página Google Wallet Test Account Sign-In.
- Si no tienes una cuenta de Google, crea una para continuar.
- Una vez que inicies sesión, serás redirigido a la consola de negocios de Google Wallet.
- Accede a la sección de la API de Google Wallet:
- En la consola de negocios de Google Wallet, ve a la sección de administración de la API o de integración (normalmente en la configuración de desarrollador o de integración).
- Selecciona Create a Pass para habilitar el Demo Mode:
- En la sección de la API de Google Wallet, busca la opción llamada Create a Pass.
- Haz clic en esta opción para habilitar el Demo mode. Esto te permite simular y probar la creación de pases y las interacciones sin transacciones reales.

- Descarga la aplicación Google Wallet desde Play Store.
- Recorre el flujo de pago para probar la integración.
Salir a producción
Después de completar todos los pasos de integración en el entorno de pruebas, solicita el Google Production Access y contacta a tu Technical Account Manager. El equipo de Yuno te ayudará a verificar tu configuración y a confirmar que estás listo para salir a producción.Detalles de implementación
Detalles clave de tu integración de Google Pay con Yuno:Métodos de autorización de la API de Google Pay
Yuno admite ambos métodos de autorización de la API de Google Pay:PAN_ONLY: credenciales de tarjeta almacenadas en la cuenta de Google del usuario. Cuando se usa, Yuno gestiona automáticamente la autenticación de 3D Secure si está habilitada.CRYPTOGRAM_3DS: credenciales de tarjeta basadas en el dispositivo con autenticación integrada. Estas credenciales incluyen autenticación criptográfica y no requieren procesamiento 3DS adicional. Estas credenciales se descifran en un número específico del dispositivo (DPAN), así que consulta Últimos cuatro dígitos de la tarjeta para tokens de dispositivo si muestras los últimos cuatro dígitos de la tarjeta al titular de la tarjeta.
PAN_ONLY y CRYPTOGRAM_3DS en tu arreglo allowedAuthMethods para lograr las máximas tasas de éxito de pago.
- 3D Secure (3DS) para credenciales
PAN_ONLY: si Google Pay devuelve una credencialPAN_ONLY(una tarjeta almacenada en la cuenta de Google del usuario), Yuno gestionará automáticamente el flujo de autenticación de 3D Secure si 3DS está habilitado. En el frontend, asegúrate de que tu solicitud a la API de Google Pay incluyaPAN_ONLYen el arregloallowedAuthMethods. - Configuración de Gateway y GatewayMerchantID: al registrarte en la Google Pay Business Console, asegúrate de que, en Google Pay API > Integrate with your website, el Integration type esté configurado como GATEWAY. El
Merchant IDde la Google Pay Business Console se usa en el campo “Merchant ID” al configurar la conexión de Google Pay en el dashboard de Yuno. Configuragatewaycomoyunoy usa tu ID de comercio asignado comogatewayMerchantIden la configuración de tu API de Google Pay. - Métodos de autorización: Yuno admite los métodos de autorización estándar (compra, autorización, captura). La disponibilidad depende del procesador de pagos y del banco adquirente de cada país y pago.
- Requisitos de dirección de facturación: si el procesamiento de tu pago requiere la dirección de facturación del cliente (por ejemplo, para verificaciones AVS), configúralo en tu solicitud a la API de Google Pay. Google proporciona
BillingAddressParameterspara especificar el detalle requerido (por ejemplo, MIN o FULL). Consulta la documentación de Google. Solicita los datos de la dirección de facturación solo si es necesario, ya que esto puede aumentar la fricción en el checkout. - Datos de la transacción y criptografía de pago: los comercios integran los SDK de Yuno (Android, iOS, Web) en sus aplicaciones. Cuando un cliente elige Google Pay, el SDK de Yuno interactúa con la API de Google Pay y recibe de forma segura los datos de pago cifrados (token de pago) de Google. Este token pasa de tu aplicación a tu servidor backend, que luego usa las API del lado del servidor de Yuno para enviar el token para su procesamiento de pago. Yuno se encarga del descifrado y del procesamiento con el procesador de pagos.
Envía el token de pago de Google Pay en la solicitud
Cuando inicias una transacción con Google Pay, se devuelve un token de pago que contiene datos de pago cifrados. Envía el token completo recibido de Google Pay en el campopayment_method.detail.wallet.payment_token como una cadena JSON en tu solicitud de pago.
Objeto de respuesta de la billetera de Google Pay
El SDK de Google Pay devuelve la siguiente estructura de objeto, que debe enviarse como el valor completo depayment_token:
Ejemplo de solicitud
Pagos recurrentes (CIT y MIT)
Para cobros recurrentes, guarda en el vault el instrumento en el primer pago y cobra después elvaulted_token resultante. En el CIT, payment_token y stored_credentials van juntos en detail.wallet. En el MIT, el instrumento es una tarjeta almacenada, por lo que stored_credentials pasa a detail.card. La matriz completa de reason y usage está en Stored credentials.
CIT, primer pago con la hoja de Google Pay mostrada:
vault_on_success requiere customer_payer.id. customer_payer.id debe hacer referencia a un cliente existente (créalo primero con Create Customer). Sin él, el pago igualmente es exitoso, pero no se guarda nada en el vault: la respuesta trae un vaulted_token vacío y ningún error. El vaulted_token se devuelve solo en la respuesta del pago CIT, así que guárdalo de tu lado. No coloques stored_credentials en detail.card en el CIT: no se valida para un pago con billetera y puede descartarse, lo que deja el registro guardado sin los indicadores de credenciales almacenadas y sin un network_transaction_id.
Últimos cuatro dígitos de la tarjeta para tokens de dispositivo
Cuando Google Pay devuelve una credencialCRYPTOGRAM_3DS, el token cifrado se descifra en el DPAN, un número específico del dispositivo, no la tarjeta almacenada por el titular de la tarjeta. Sus últimos cuatro dígitos no son los que el titular de la tarjeta reconoce, por lo que card_data.lfd en la respuesta del pago está vacío o muestra los últimos cuatro del DPAN.
Los últimos cuatro dígitos de la tarjeta real están disponibles para ti en la respuesta de Google, fuera del token cifrado:
paymentMethodData.info.cardDetails como payment_method.detail.wallet.card_data.lfd y Yuno lo usa en lugar del valor derivado del DPAN.
El campo es opcional y compatible con versiones anteriores. Si no lo envías, el comportamiento no cambia.
- Yuno aplica el valor solo cuando el token es un token de dispositivo:
auth_methodesCRYPTOGRAM_3DS, opan_typeesDPANcuandoauth_methodno está presente. - Las credenciales
PAN_ONLYignoran el valor. Estas se descifran en la tarjeta real, así que Yuno conserva los últimos cuatro descifrados. - Solo se acepta
lfd.brandy los demás campos de la tarjeta conservan sus valores descifrados, porque el BIN del DPAN ya identifica correctamente la red de la tarjeta. - El valor se ignora para otras billeteras, como Apple Pay.
payment_method.detail.card.card_data.lfd. Los payloads de webhook lo anidan en payment_method_detail en lugar de detail.
Si lfd está presente pero no tiene exactamente 4 dígitos numéricos, la solicitud se rechaza: