Saltar al contenido principal
Esta guía explica cómo integrar Google Pay™ con Yuno mediante el SDK. Con este enfoque, el SDK de Yuno gestiona toda la experiencia de Google Pay: muestra el botón de Google Pay, presenta la hoja de pago y maneja el token de pago. No necesitas integrarte directamente con la API de Google Pay.
Antes de implementar, revisa los requisitos de Google Pay y asegúrate de que Google Pay esté disponible en tus países de operación.

Flujo de integración

  1. Crea una sesión de checkout con Yuno.
  2. Inicializa el SDK de Yuno en tu app (Web, Android o iOS).
  3. El SDK muestra el botón de Google Pay y gestiona la hoja de pago.
  4. El cliente autoriza el pago a través de Google Pay.
  5. Yuno recibe el token de pago y procesa la transacción con tu proveedor configurado.
  6. Monitorea el estado del pago mediante webhooks.

Requisitos

  • Una cuenta de Yuno con credenciales de API (Dashboard)
  • Una conexión con un proveedor de pago configurada en el Dashboard de Yuno que sea compatible con Google Pay
  • Una regla de enrutamiento que incluya el método de pago Google Pay
  • Yuno SDK integrado en tu app (Web, Android o iOS)

Pasos de integración

Paso 1: crea una sesión de checkout

Usa el endpoint crear sesión de checkout para iniciar una sesión de pago:
La respuesta devuelve un ID de checkout_session para inicializar el SDK.

Paso 2: inicializa el SDK

Inicializa el SDK de Yuno con la sesión de checkout. El SDK detecta automáticamente los métodos de pago disponibles, incluido Google Pay, según la configuración de tu Dashboard. Consulta la documentación del SDK de tu plataforma:

Paso 3: el cliente completa el pago

El SDK se encarga del resto. Cuando el cliente selecciona Google Pay:
  1. Aparece la hoja de pago de Google Pay con las tarjetas guardadas del cliente.
  2. El cliente selecciona una tarjeta y autoriza el pago.
  3. El SDK envía a Yuno el token de pago cifrado.
  4. Yuno procesa el pago a través de tu proveedor configurado.

Paso 4: gestiona la respuesta

El SDK devuelve el resultado del pago. También puedes monitorear el estado del pago mediante webhooks para obtener una confirmación asíncrona.

Solicitar información de contacto

Puedes configurar qué campos solicita al cliente la hoja de pago de Google Pay directamente desde el Checkout Builder. Los campos disponibles son:
  • Email
  • Teléfono
  • Nombre del titular de la tarjeta
  • Dirección de facturación
  • Dirección de envío
Cuando alguno de estos campos se habilita como obligatorio en el Checkout Builder, la hoja de pago de Google Pay le pide al cliente esa información antes de completar el pago.
Antes esto se configuraba a nivel de la conexión. Ahora está unificado en Required Fields del Checkout Builder, igual que funciona en Apple Pay.
El nombre del titular de la tarjeta está deshabilitado por defecto en Google Pay, a diferencia de las tarjetas, donde está habilitado por defecto. Habilítalo desde el Checkout Builder si tu integración lo necesita.

Crear un pago con el flujo de trabajo del SDK

Si necesitas llamar directamente a la API de pagos mientras usas el flujo de checkout del SDK, establece workflow en SDK_CHECKOUT e incluye la sesión de checkout:
Al integrar wallets como Google Pay, el campo payment_method.type es obligatorio incluso al usar el flujo de trabajo del SDK. Establécelo en GOOGLE_PAY.

Habilitar y probar Google Pay

Para probar Google Pay en sandbox:
  1. Integra el SDK de Yuno en tu app.
  2. Crea una cuenta de prueba de Google e inicia sesión en la Google Pay Business Console.
  3. En la Google Pay Business Console, ve a la sección API y selecciona Create a Pass para habilitar Demo mode.
  1. Descarga la app Google Wallet en tu dispositivo de prueba.
  2. Recorre el flujo de pago para verificar que la integración funciona.

Pasar a producción

Después de probar, solicita el acceso a producción de Google y contacta a tu Technical Account Manager. El equipo de Yuno verificará tu configuración antes de salir a producción.

Próximos pasos

  • Pagos recurrentes. Transacciones iniciadas por el cliente y por el comercio con el token almacenado.
  • Express checkout. Desglose del pedido, métodos de envío y actualizaciones de la dirección de envío en la hoja de Google Pay (Android y Web).