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

# SDK de React Native

> Integra Yuno en tu app de React Native para aceptar pagos y guardar métodos 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 SDK de Yuno para React Native ofrece un conjunto de componentes y métodos para integrar las funciones de pago de Yuno en tu app móvil. Es compatible con iOS y Android.

## Instalación

```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
npm install @yuno-payments/yuno-sdk-react-native@^1.4.0
```

**Configuración de iOS**:

```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
cd ios && pod install
```

**Requisitos**:

* react-native 0.70+
* Node.js 16+
* Android Min SDK 21
* iOS 14.0+

El SDK incluye definiciones de TypeScript de forma predeterminada.

## Inicialización

Inicializa el SDK lo antes posible en tu app, normalmente en `App.tsx`.

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import { YunoSdk } from '@yuno-payments/yuno-sdk-react-native';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    YunoSdk.initialize({
      apiKey: 'your-public-api-key',
      countryCode: 'US', // Default country
    });
  }, []);
  
  return <YourApp />;
}
```

## Flujo de pago básico (Full Checkout)

La integración más sencilla usa el componente `YunoPaymentMethods` para mostrar los métodos de pago disponibles y `startPayment` para procesar la transacción.

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import { YunoSdk, YunoPaymentMethods } from '@yuno-payments/yuno-sdk-react-native';

export default function PaymentScreen() {
  const [checkoutSession, setCheckoutSession] = useState<string | null>(null);
  const [isReady, setIsReady] = useState(false);
  
  useEffect(() => {
    // 1. Subscribe to payment events
    const subscription = YunoSdk.onPaymentStatus((state) => {
      if (state.status === 'SUCCEEDED') {
        // Handle success
      }
    });
    
    // 2. Fetch checkout session from your backend
    createCheckoutSession().then(session => {
      setCheckoutSession(session);
      setIsReady(true);
    });
    
    return () => subscription.remove();
  }, []);
  
  const handlePayment = async () => {
    // 3. Start payment flow
    await YunoSdk.startPayment(true); // true = show payment status screen
  };
  
  return (
    <View>
      {checkoutSession && (
        <YunoPaymentMethods
          checkoutSession={checkoutSession}
          countryCode="US"
        />
      )}
      <Button title="Pay Now" onPress={handlePayment} disabled={!isReady} />
    </View>
  );
}
```

## Opciones de integración

Elige el nivel de integración que mejor se ajuste a tus necesidades:

> [card] [Lite SDK](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/lite.md)
>
> Controla la interfaz de selección del método de pago mientras Yuno gestiona el proceso de pago.

> [card] [Headless SDK](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/headless.md)
>
> Crea una interfaz completamente personalizada y gestiona el flujo de pago manualmente.

> [card] [Inscripción](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/enrollment.md)
>
> Permite que tus clientes guarden sus métodos de pago para usarlos en el futuro.

> [card] [Estilos](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/styling.md)
>
> Personaliza la apariencia de los componentes del SDK para que coincidan con tu marca.

## Próximos pasos

* Consulta los [Ejemplos de código](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/code-examples.md) para ver escenarios comunes.
* Conoce las [Funciones avanzadas](https://docs.y.uno/es/docs/sdks/additional-platforms/react-native/advanced-features.md) como los deep links y el rendimiento.


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