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

# Migrar desde Stripe Elements

> Relaciona PaymentIntents, SetupIntents, Elements y webhooks de Stripe con sus equivalentes en Yuno.

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

Si tu checkout funciona hoy con Stripe Elements, pasar a Yuno cambia la capa de checkout, no tu cuenta de Stripe. Yuno se conecta a Stripe como uno más de los proveedores que habilitas, por lo que el procesamiento actual con Stripe sigue funcionando mientras agregas enrutamiento, otros proveedores y el checkout de Yuno. Esta página relaciona cada concepto de Stripe con lo que usas en Yuno.

## Conceptos

| Stripe | Yuno | Notas |
| :- | :- | :- |
| PaymentIntent | [Sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md) más [Crear pago](https://docs.y.uno/es/reference/payments/create-payment.md) | La sesión incluye el monto, el país y el cliente, y carga los métodos de pago habilitados en tu cuenta. El pago se crea en tu servidor con el token de un solo uso que devuelve el SDK. |
| `client_secret` | `checkout_session` | Se crea en tu servidor con tu clave privada y se envía al navegador. Expira a las 2.5 horas en producción. |
| SetupIntent | [Inscripción](https://docs.y.uno/es/docs/payment-features/enrollment/enroll-payment-methods.md), o un pago con `vault_on_success: true` | Una sesión de cliente más `mountEnrollmentLite` guarda la tarjeta sin cobrarla. `vault_on_success` la guarda en el primer pago exitoso. Ambos devuelven un `vaulted_token`. |
| ID de PaymentMethod (`pm_...`) | `vaulted_token` | Cóbralo más adelante enviando `payment_method.vaulted_token` con [credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md). |
| Customer (`cus_...`) | [Cliente](https://docs.y.uno/reference/customers/create-customer.md) | Crea el cliente antes de la sesión y envía su ID. |
| `capture_method: 'manual'` | `payment_method.detail.card.capture: false` | Luego [captura](https://docs.y.uno/reference/payments/capture-authorization.md) o [cancela](https://docs.y.uno/reference/payments/cancel-payment.md) la autorización. Consulta [Flujo de cancelación y captura](https://docs.y.uno/es/docs/payment-features/Cancel-and-capture-flow.md). |
| `payment_method.card.fingerprint` | `fingerprint` en el objeto Payment Method | Estable por número de tarjeta dentro de tu organización. Consulta [Huella digital de la tarjeta](https://docs.y.uno/es/docs/security-and-compliance/fingerprint.md). |
| Reglas de Radar y listas de bloqueo | [Risk Conditions](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/risk-conditions.md) | Reglas, listas de bloqueo, listas de permitidos y listas de revisión aplicadas en tus rutas. |
| Suscripciones de Stripe Billing | [Suscripciones](https://docs.y.uno/es/docs/payment-features/subscriptions/index.md) con [Smart Retries](https://docs.y.uno/es/docs/payment-features/subscriptions/retries.md) | Si mantienes Stripe Billing, consulta [Procesar suscripciones de Stripe Billing con Yuno](https://docs.y.uno/es/docs/payment-features/subscriptions/stripe-billing.md). |
| 3D Secure con Stripe | [3D Secure](https://docs.y.uno/es/docs/security-and-compliance/3d-secure.md) | Yuno ejecuta 3DS en el proveedor enrutado y devuelve `checkout.sdk_action_required` cuando el comprador debe completar un desafío. |

## Componentes de checkout

| Stripe Elements | Yuno Web SDK | Guía |
| :- | :- | :- |
| Payment Element | Seamless SDK | [Seamless SDK (Web)](https://docs.y.uno/es/docs/sdks/seamless-sdk/web-payments.md) |
| Card Element | Componente de tarjeta de Lite SDK, o Secure Fields cuando controlas el formulario | [Lite SDK (Web)](https://docs.y.uno/es/docs/sdks/lite-web/payment.md), [Secure Fields](https://docs.y.uno/docs/sdks/customization/secure-fields/payment-secure-fields) |
| Campos de tarjeta separados (`cardNumber`, `cardExpiry`, `cardCvc`) | Secure Fields `pan`, `expiration`, `cvv` | [Secure Fields](https://docs.y.uno/docs/sdks/customization/secure-fields/payment-secure-fields) |
| Express Checkout Element | `mountExternalButtons` de Lite SDK (Apple Pay, Google Pay, PayPal) | [Lite SDK (Web)](https://docs.y.uno/es/docs/sdks/lite-web/payment.md) |
| `stripe.confirmPayment` | `yuno.startPayment` y la llamada a Crear pago de tu servidor | [React y Next.js](https://docs.y.uno/es/docs/sdks/web-frameworks/react-and-nextjs.md) |
| `stripe.confirmSetup` | `yuno.mountEnrollmentLite` | [Inscripción (Web)](https://docs.y.uno/es/docs/sdks/card-enrollment/web-enrollment.md) |
| `elements.update({ amount })` | `yuno.updateCheckoutSession(newSession)` | [Referencia Web](https://docs.y.uno/es/docs/sdks/resources/references/web.md#updatecheckoutsession) |
| `@stripe/react-stripe-js` | `@yuno-payments/sdk-web` con los patrones de la página de React | [React y Next.js](https://docs.y.uno/es/docs/sdks/web-frameworks/react-and-nextjs.md) |
| Appearance API | Checkout Builder y estilos del SDK | [Checkout Builder](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/checkout-builder.md), [Estilos](https://docs.y.uno/es/docs/sdks/customization/web/styling.md) |

## Flujo de pago, lado a lado

> [tab] Stripe Elements
>
> 1. El servidor crea un PaymentIntent y devuelve `client_secret`.
> 2. El navegador monta el Payment Element con el secreto.
> 3. El navegador llama a `stripe.confirmPayment`.
> 4. Stripe redirige o resuelve; tu servidor escucha `payment_intent.succeeded`.

> [tab] Yuno (Lite SDK / Secure Fields)
>
> 1. El servidor crea una [sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md) y devuelve `checkout_session`.
> 2. El navegador monta el SDK con la sesión y llama a `yuno.startPayment()`.
> 3. El SDK te entrega un token de un solo uso en `createPayment`; tu servidor llama a [Crear pago](https://docs.y.uno/es/reference/payments/create-payment.md) con `payment_method.token` y `checkout.session`.
> 4. Si la respuesta incluye `checkout.sdk_action_required: true`, el navegador llama a `yuno.continuePayment()` para 3DS o una redirección. Tu servidor escucha el webhook `payment.purchase` para conocer el estado final.

> [tab] Yuno (Seamless SDK)
>
> 1. El servidor crea una [sesión de checkout](https://docs.y.uno/es/reference/checkout-sessions/create-checkout-session.md) y devuelve `checkout_session`.
> 2. El navegador monta el Seamless SDK con la sesión y llama a `yuno.startPayment()`.
> 3. El SDK crea el pago a partir de la sesión de checkout en tu cuenta. Tu servidor escucha el webhook `payment.purchase` para conocer el estado final.
> 4. Para 3DS o una redirección, el SDK gestiona el desafío automáticamente y devuelve el resultado en `paymentResult`.

Una diferencia estructural en ambos caminos: tu clave privada nunca llega al navegador. La sesión de checkout se crea en tu servidor y, con Lite SDK y Secure Fields, el pago también se crea allí.

## Webhooks

Yuno envía un tipo de evento por objeto y lleva el estado dentro del payload, por lo que varios eventos de Stripe se reúnen en un solo evento de Yuno. Consulta [Webhooks](https://docs.y.uno/docs/webhooks/index.md) y [Configurar webhooks](https://docs.y.uno/es/docs/webhooks/configure-webhooks.md).

| Evento de Stripe | Evento de Yuno | Qué leer |
| :- | :- | :- |
| `payment_intent.succeeded`, `payment_intent.payment_failed`, `payment_intent.canceled` | `payment.purchase` | `status` (`SUCCEEDED`, `DECLINED`, `PENDING`, `ERROR`) y `sub_status` |
| `charge.captured` | `payment.capture` | Estado de la transacción |
| `charge.refunded` | `payment.refund` | Estado de la transacción de reembolso |
| `charge.dispute.created`, `charge.dispute.updated`, `charge.dispute.closed` | `payment.chargeback` | `status` (`IN_DISPUTE`, `CHARGEBACK`, `SUCCEEDED`) y `sub_status` (`RECEIVED`, `PENDING_REVIEW`, `LOST`, `APPROVED`). Consulta [Gestión de contracargos](https://docs.y.uno/es/docs/payouts-and-disputes/chargeback-management.md). |
| `setup_intent.succeeded` | `enrollment.enroll` | `status` `ENROLLED` y el `vaulted_token` |
| `customer.subscription.*`, `invoice.paid`, `invoice.payment_failed` | `subscription.*` (`active`, `past_due`, `cycle_executed`, `cancel` y otros) | Estado de la suscripción y resultado del ciclo |
| `review.opened`, `review.closed` | `payment.fraud_screening` | Resultado del análisis |

Cada webhook de Yuno incluye `data.idempotency_key` y un encabezado `x-hmac-signature`; verifícalo como se describe en [Verificar firmas de webhooks](https://docs.y.uno/es/docs/webhooks/verify-webhook-signatures-hmac.md).

## Tarjetas guardadas

Las tarjetas guardadas en Stripe se pueden llevar a Yuno para que los clientes recurrentes no tengan que volver a ingresarlas. Yuno admite una migración de tokens de proveedor a proveedor, cifrada con PGP, mediante el [Proceso de migración de tokens](https://docs.y.uno/es/docs/security-and-compliance/data-migration-processes/token-migration-process.md). Las series recurrentes continúan sin una nueva autenticación porque Yuno almacena el ID de transacción de la red con cada vaulted token; consulta [Credenciales almacenadas](https://docs.y.uno/es/docs/payment-features/stored-credentials.md).

## Orden de migración

**1. Conecta Stripe en Yuno**

Agrega tu cuenta de Stripe como una conexión y colócala en una ruta. Por ahora nada cambia para los compradores. Consulta [Configurar una conexión de pago](https://docs.y.uno/es/docs/direct-integration-use-cases/set-up-payment-connection.md).

**2. Reemplaza el checkout**

Cambia el Payment Element por el Seamless SDK, o el Card Element por Lite SDK o Secure Fields, siguiendo [React y Next.js](https://docs.y.uno/es/docs/sdks/web-frameworks/react-and-nextjs.md). Ejecútalo primero con la misma conexión de Stripe para poder comparar las tasas de aprobación en igualdad de condiciones.

**3. Mueve los webhooks**

Suscribe tus controladores actuales a los eventos de Yuno de la tabla anterior y cambia la lógica de estados a los valores `status` y `sub_status` de Yuno.

**4. Migra las tarjetas guardadas**

Ejecuta la migración de tokens y cambia los cobros con tarjetas almacenadas a `vaulted_token`.

**5. Agrega proveedores y enrutamiento**

Cuando el tráfico sea estable, agrega otros proveedores y deja que [Routing](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/routing.md) y [Monitors](https://docs.y.uno/es/docs/using-yuno/dashboard-overview/monitors.md) decidan adónde va cada pago.


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