> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Configuración y pagos únicos

> Integra Google Pay con el Yuno SDK: crea la sesión de checkout, deja que el SDK muestre el botón y la hoja de pago, y procesa un pago único.

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.

> [!NOTE]
>
> Antes de implementar, revisa los [requisitos de Google Pay](https://docs.y.uno/docs/google-pay#requirements) 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](https://docs.y.uno/docs/webhooks.md).

## Requisitos

* Una cuenta de Yuno con credenciales de API ([Dashboard](https://dashboard.y.uno/))
* 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](https://docs.y.uno/docs/sdks/resources/references/web.md), [Android](https://docs.y.uno/docs/sdks/resources/references/android.md) o [iOS](https://docs.y.uno/docs/sdks/resources/references/ios.md))

## Pasos de integración

### Paso 1: crea una sesión de checkout

Usa el endpoint [crear sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md) para iniciar una sesión de pago:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "country": "US",
  "customer_id": "customer-uuid",
  "merchant_order_id": "order-123",
  "payment_description": "Google Pay payment",
  "amount": {
    "currency": "USD",
    "value": 5000
  }
}
```

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:

* [Integración del SDK Web](https://docs.y.uno/docs/sdks/full-checkout/web-payments)
* [Integración del SDK Android](https://docs.y.uno/docs/sdks/full-checkout/android-payments)
* [Integración del SDK iOS](https://docs.y.uno/docs/sdks/full-checkout/ios-payments)

### 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](https://docs.y.uno/docs/webhooks.md) 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](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/checkout-builder.md#required-fields). 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.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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.

| Plataforma | Versión mínima |
| - | - |
| Web | 1.8.0 |
| Android | 2.16.0 |

## 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:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "account_id": "your-account-id",
  "description": "Google Pay via SDK",
  "merchant_order_id": "order-123",
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": 5000
  },
  "checkout": {
    "session": "checkout-session-id"
  },
  "customer_payer": {
    "id": "customer-uuid",
    "email": "customer@example.com"
  },
  "payment_method": {
    "type": "GOOGLE_PAY"
  },
  "workflow": "SDK_CHECKOUT"
}
```

> [!WARNING]
>
> 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](https://docs.y.uno/docs/sdks/full-checkout/android-payments) en tu app.
2. Crea una cuenta de prueba de Google e inicia sesión en la [Google Pay Business Console](https://pay.google.com/business/console).
3. En la Google Pay Business Console, ve a la sección API y selecciona **Create a Pass** para habilitar **Demo mode**.

![](https://mintcdn.com/yuno-3979e326/MTlogjS0_SlxtlJG/images/reference/google-pay-sdk-integration/image1.png?fit=max\&auto=format\&n=MTlogjS0_SlxtlJG\&q=85\&s=90097bd7c2ba76e08eaa63d6f551bde6)

4. Descarga la [app Google Wallet](https://play.google.com/store/apps/details?id=com.google.android.apps.walletnfcrel\&hl=en\&gl=US) en tu dispositivo de prueba.
5. 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](https://developers.google.com/pay/api/web/guides/test-and-deploy/request-prod-access) 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](https://docs.y.uno/es/docs/wallets/google-pay/sdk-integration/recurring-payments.md). Transacciones iniciadas por el cliente y por el comercio con el token almacenado.
* [Express checkout](https://docs.y.uno/es/docs/wallets/google-pay/sdk-integration/express-checkout.md). 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).

## Documentación relacionada

* [Resumen de Google Pay](https://docs.y.uno/docs/google-pay)
* [Integración directa de Google Pay](https://docs.y.uno/es/docs/wallets/google-pay/google-pay-direct-integration.md)
* [Google Pay mediante proveedor](https://docs.y.uno/es/docs/wallets/google-pay/integration-via-provider-google-pay.md)
* [Google Pay con PIX](https://docs.y.uno/es/docs/wallets/google-pay/google-pay-with-pix.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.