Saltar al contenido principal
En Brasil, Yuno admite Google Pay™ como interfaz para pagos con PIX. Los clientes seleccionan Google Pay en el checkout y el pago se procesa mediante PIX, el sistema de pagos instantáneos de Brasil. Esto combina la comodidad de los métodos de pago almacenados de Google Pay con la liquidación en tiempo real de PIX.
Google Pay con PIX está disponible solo en Brasil, con transacciones en BRL (real brasileño).

Qué es Google Pay PIX

Google Pay PIX usa Open Finance para habilitar pagos con PIX a través de la billetera de Google Pay. En lugar de abrir la aplicación de su banco para completar una transferencia PIX, los clientes pueden pagar directamente desde su Google Wallet, lo que hace que la experiencia de checkout sea más rápida y cómoda. Para pagar con Google Pay PIX, el cliente final debe configurar primero una cuenta bancaria para pagos con PIX dentro de su Google Wallet. Google ofrece instrucciones de configuración en Set up PIX in Google Wallet.

Cómo funciona

Desde la perspectiva del comercio, un pago con Google Pay + PIX se comporta como un pago PIX asíncrono estándar, aunque el cliente comience en Google Pay.
  1. El cliente selecciona Google Pay en el checkout.
  2. Google Pay presenta PIX como una opción de pago dentro de la hoja de pago de Google Pay.
  3. El cliente selecciona un banco o una credencial que pueda iniciar una transferencia PIX y autoriza el pago.
  4. Yuno crea el pago en estado PENDING y devuelve los artefactos estándar de PIX (código QR, código de copiar y pegar o deeplink) según el proveedor y la configuración. Consulta los campos de respuesta de PIX para ver los nombres exactos de los campos.
  5. El cliente completa la transferencia PIX a través de su banco.
  6. El banco confirma la transferencia al proveedor, que notifica a Yuno.
  7. Yuno actualiza el estado del pago a SUCCEEDED y dispara un webhook.

Proveedores compatibles

Google Pay PIX está disponible actualmente a través de los siguientes proveedores:
  • Adyen
  • Santander
  • Itau
Para otros proveedores, contacta a tu gerente de cuenta de Yuno para conversar sobre la disponibilidad y priorizar la integración.

Requisitos

  • Una cuenta de Yuno con una conexión a un proveedor compatible
  • Las transacciones deben ser en BRL (real brasileño)
  • El cliente debe tener una cuenta bancaria configurada para PIX en su Google Wallet

Integración

Google Pay con PIX sigue los mismos patrones de integración que Google Pay con pagos con tarjeta. Elige el método de integración que se ajuste a tu arquitectura: Al crear el pago, establece payment_method.type en GOOGLE_PAY_PIX. Esto le indica a Yuno que el pago es una transacción PIX iniciada mediante Google Pay.

Solicitud de pago

Crea un pago usando el tipo de método de pago GOOGLE_PAY_PIX. Establece el país en BR y la moneda en BRL:
Para Google Pay PIX, usa payment_method.type = GOOGLE_PAY_PIX en lugar de GOOGLE_PAY. Esto es diferente de los pagos con tarjeta de Google Pay, que usan GOOGLE_PAY.

Estados del pago

Google Pay con PIX es asíncrono. A diferencia de los pagos con tarjeta mediante Google Pay, que normalmente se resuelven de inmediato, los pagos con PIX pasan por un estado pendiente mientras se espera que se complete la transferencia bancaria.

Ciclo de vida del estado

Manejo de la cancelación del usuario

Si el cliente cierra la hoja de Google Pay o la pantalla de instrucciones de PIX antes de completar la transferencia bancaria:
  • El frontend/SDK informa que el usuario abandonó el flujo (por ejemplo, el SDK devuelve un estado de cancelado por el usuario).
  • El pago en la API permanece en PENDING. La referencia PIX sigue siendo válida y el cliente aún puede completar la transferencia desde la aplicación de su banco.
  • El pago PIX solo pasa a EXPIRED cuando se alcanza la fecha límite de expiración, no cuando el usuario cierra la interfaz.
Tu checkout debe manejarlo de la siguiente manera:
  1. Volver a mostrar las instrucciones de PIX si el cliente regresa a la misma sesión, ya que la referencia PIX sigue siendo válida.
  2. Permitir que el cliente pague más tarde si tu UX lo admite. El código PIX permanece activo hasta que expira.
  3. Consultar el estado del pago mediante GET /v1/payments/{id} o escuchar los webhooks para detectar cuándo se completa la transferencia.

Webhooks

Los webhooks de pago estándar se disparan en todas las transiciones de estado. El payload del webhook sigue la misma estructura que cualquier otra notificación de pago de Yuno. Supervisa estos eventos:
  • Pago exitoso: la transferencia PIX se completó. Actualiza el estado de tu pedido y confirma al cliente.
  • Pago expirado: la fecha límite de PIX pasó sin una transferencia. Deja de mostrar el código QR o las instrucciones de PIX e invita al cliente a iniciar un nuevo pago.
Consulta Webhooks para ver los detalles de configuración.

Diferencias con los pagos con tarjeta