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.- El cliente selecciona Google Pay en el checkout.
- Google Pay presenta PIX como una opción de pago dentro de la hoja de pago de Google Pay.
- El cliente selecciona un banco o una credencial que pueda iniciar una transferencia PIX y autoriza el pago.
- Yuno crea el pago en estado
PENDINGy 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. - El cliente completa la transferencia PIX a través de su banco.
- El banco confirma la transferencia al proveedor, que notifica a Yuno.
- Yuno actualiza el estado del pago a
SUCCEEDEDy dispara un webhook.
Proveedores compatibles
Google Pay PIX está disponible actualmente a través de los siguientes proveedores:- Adyen
- Santander
- Itau
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:- Integración del SDK: el SDK de Yuno gestiona el flujo completo, incluida la presentación de PIX como opción dentro de Google Pay.
- Integración directa: tú gestionas el frontend de Google Pay y pasas el token de pago de PIX a Yuno.
- Integración mediante proveedor: tu proveedor de pagos gestiona el flujo de Google Pay + PIX.
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 pagoGOOGLE_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
EXPIREDcuando se alcanza la fecha límite de expiración, no cuando el usuario cierra la interfaz.
- 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.
- Permitir que el cliente pague más tarde si tu UX lo admite. El código PIX permanece activo hasta que expira.
- 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.