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

# React Native Lite

> Usa el Lite SDK para una integración semipersonalizada en la que controlas la interfaz de selección del método de pago.

> [!NOTE]
>
> **Esta página documenta un SDK heredado.** ¿Vas a iniciar una nueva integración? Usa el [Yuno SDK](https://docs.y.uno/docs/yuno-sdk/get-started.md). ¿Ya usas un SDK heredado? Sigue la [guía de migración](https://docs.y.uno/docs/yuno-sdk/migration/overview.md).
>
> El nuevo **Yuno SDK** (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en **2027**. Contacta a tu Account Manager para planificar la migración.

> [!WARNING]
>
> **Orientación: elige tu flujo de integración**. Antes de comenzar, revisa el [flujo de integración oficial](https://docs.y.uno/docs/sdks/overview/understanding-flows.md).
>
> * **Flujo estándar ([Full Checkout](https://docs.y.uno/docs/sdks/full-checkout/web-payments))**: Recomendado para la mayoría de los comercios. Yuno se encarga de la interfaz, la seguridad y las actualizaciones automáticas de los métodos de pago.
> * **Flujo personalizado (este SDK)**: Úsalo solo si necesitas control total sobre la experiencia de usuario. **Nota**: Serás responsable de gestionar manualmente los estados de los pagos, las transiciones de 3DS y la recopilación de datos para el enrutamiento de fraude.

El Lite SDK te permite crear tu propia pantalla de selección del método de pago mientras Yuno gestiona el proceso de pago y la seguridad.

## Opciones de montaje alternativas

El [flujo de pago básico](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native.md#basic-payment-flow-full-checkout) usa la visualización automática de métodos de pago. Para tener más control, usa estas alternativas:

### Selección personalizada del método de pago (`startPaymentLite`)

Selecciona qué método de pago mostrar:

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// 1. Fetch available methods
const methods = await fetchPaymentMethods(sessionId);

// 2. Display in your UI
// 3. Start payment with selected method

await YunoSdk.startPaymentLite(
  {
    checkoutSession: session.checkoutSession,
    methodSelected: {
      paymentMethodType: selectedMethod, // 'CARD', 'PIX', etc.
      vaultedToken: null, // or saved token
    },
    showPaymentStatus: true,
  },
  'US' // Optional country code override
);
```

### Flujo simplificado (`startPaymentSeamlessLite`)

Similar a Lite, pero con creación automática del pago:

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
await YunoSdk.startPaymentSeamlessLite({
  checkoutSession: session.checkoutSession,
  methodSelected: {
    paymentMethodType: 'CARD',
    vaultedToken: null, // or saved token
  },
  showPaymentStatus: true,
  countryCode: 'US',
});
```

## Pagos con token guardado

Usa métodos de pago guardados para una experiencia de checkout más rápida.

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
await YunoSdk.startPaymentLite({
  checkoutSession: session.checkoutSession,
  methodSelected: {
    paymentMethodType: 'CARD',
    vaultedToken: 'vtok_saved_card_123',
  },
  showPaymentStatus: true,
});
```

## Parámetros

| Parámetro | Descripción |
| - | - |
| `checkoutSession` | ID de la sesión de checkout de tu backend. |
| `methodSelected.paymentMethodType` | Tipo de método de pago (por ejemplo, `CARD`, `PIX`). |
| `methodSelected.vaultedToken` | Token del método de pago guardado, o `null` para una tarjeta nueva. |
| `showPaymentStatus` | Cuando es `true`, el SDK muestra la interfaz con el resultado del pago. |
| `countryCode` | Código de país ISO opcional que reemplaza al predeterminado (por ejemplo, `US`). |


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