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

# Inscripción en Web

> Inscribe métodos de pago en Web con full-checkout, montando el formulario de inscripción y gestionando los callbacks

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

El SDK Web facilita la implementación de flujos de inscripción para guardar métodos de pago en la cuenta de un cliente.

Incluye la biblioteca en tu proyecto siguiendo los mismos pasos que en los [flujos de pago](https://docs.y.uno/docs/sdks/full-checkout/web-payments#include-the-library-in-your-project). Así completas el [paso 1](#step-1-include-the-library-in-your-project) y continúas con el flujo de inscripción que se describe a continuación.

## Recursos adicionales

* Yuno ofrece una [biblioteca de TypeScript](https://www.npmjs.com/package/@yuno-payments/sdk-web-types) que complementa el SDK.

* Consulta [Elige la integración adecuada para ti](https://docs.y.uno/es/docs/sdks/overview/choose-integration.md) si no tienes claro qué flujo seguir.

* Consulta la [aplicación de demostración](https://github.com/yuno-payments/yuno-sdk-web) para ver una implementación completa (clónala desde el repositorio).

## Requisitos

* Un [cliente](https://docs.y.uno/reference/customers/create-customer.md) creado en Yuno, una [sesión de cliente](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session.md) y un [objeto de método de pago de inscripción](https://docs.y.uno/reference/payment-methods-checkout/enroll-payment-method-checkout.md): consulta cada API al configurar tu backend.
* Clave de API pública (obtenla en el [Yuno Dashboard](https://dashboard.y.uno/) → **Developers** > **Credentials**)

## Parámetros

Para ver la lista completa de parámetros y callbacks, consulta la [Referencia común del SDK Web](https://docs.y.uno/es/docs/sdks/resources/references/web.md).

| Parámetro | Descripción |
| - | - |
| `customerSession` | ID de la sesión de cliente de tu backend (API Create customer session). Obligatorio. |
| `countryCode` | Código de país ISO (por ejemplo, `US`). |
| `language` | Código de idioma de la interfaz (por ejemplo, `en`). Opcional. |
| `showLoading` | Muestra el indicador de carga. Opcional. |
| `onLoading` | Callback: actualizaciones del estado de carga. Opcional. |
| `elementSelector` | Selector CSS donde se monta el formulario de inscripción. Opcional. Pásalo dentro de `renderMode: { type: "element", elementSelector }`; a nivel superior el SDK lo ignora. |
| `card` | Opciones del formulario de tarjeta. Opcional. |
| `enrollmentStatus` | Callback: la inscripción terminó; recibe `vaultedToken` y `status`. |
| `issuersFormEnable` | Muestra la lista de emisores (bancos). Opcional. |
| `texts` | Texto personalizado de botones y etiquetas. Opcional. |

## Inscripción con full-checkout (Web)

Este flujo usa `mountEnrollmentLite`, el método de inscripción del SDK Web actual, que renderiza un formulario de inscripción prediseñado. Implementa la inscripción de la siguiente manera.

### Paso 1: incluye la biblioteca en tu proyecto

Incluir la biblioteca en tu proyecto se hace de la misma forma que en los [flujos de pago](https://docs.y.uno/docs/sdks/full-checkout/web-payments#include-the-library-in-your-project).

### Paso 2: inicializa el SDK

Consulta la [guía de inicio rápido](https://docs.y.uno/es/docs/sdks/overview/quickstart.md#web-sdk-integration) para la inicialización.

### Paso 3: crea una sesión de cliente y un objeto de método de pago de inscripción

Crea una [sesión de cliente](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session.md) y un [objeto de método de pago de inscripción](https://docs.y.uno/reference/payment-methods-checkout/enroll-payment-method-checkout.md) en tu **servidor** para mantener seguras tus claves de API privadas. Define qué método de pago puede inscribir el cliente al crear el objeto de método de pago.

#### Ejemplo del lado del servidor

Crea una sesión de cliente y un método de pago de inscripción en tu backend. Así mantienes seguras tus claves de API privadas.

```javascript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// 1. Create customer session
const customerSession = await fetch(
  "https://api-sandbox.y.uno/v1/customers/sessions",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "public-api-key": PUBLIC_API_KEY,
      "private-secret-key": PRIVATE_SECRET_KEY,
    },
    body: JSON.stringify({
      account_id: ACCOUNT_ID,
      customer_id: "your-customer-id",
      country: "US",
    }),
  }
).then((res) => res.json());

// 2. Create enrollment payment method
const enrollment = await fetch(
  `https://api-sandbox.y.uno/v1/customers/sessions/${customerSession.customer_session}/payment-methods`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "public-api-key": PUBLIC_API_KEY,
      "private-secret-key": PRIVATE_SECRET_KEY,
      "X-Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      account_id: ACCOUNT_ID,
      payment_method_type: "CARD",
      country: "US",
    }),
  }
).then((res) => res.json());

// Return the customer session ID to your client
return customerSession.customer_session;
```

#### Ejemplo del lado del cliente

Después de recibir el `customerSession` de tu servidor, inicializa el Yuno SDK y monta el formulario de inscripción en el lado del cliente.

```javascript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
// Initialize Yuno SDK
const yuno = await Yuno.initialize(PUBLIC_API_KEY);

// Mount the enrollment form
await yuno.mountEnrollmentLite({
  customerSession, // Received from your server
  countryCode: "US",
  language: "en",
  showLoading: true,
  onLoading: (args) => {
    console.log(args);
  },
});
```

Para verificar tarjetas (autorización de valor cero) antes de la inscripción, agrega la estructura `verify` al definir el objeto de método de pago en el servidor.

### Paso 4: monta la inscripción

Usa `await yuno.mountEnrollmentLite()` con los parámetros siguientes.

| Parámetro | Descripción |
| - | - |
| `customerSession` | Hace referencia a la [sesión de cliente](https://docs.y.uno/reference/customer-sessions-enrollment/create-customer-session.md) de la inscripción actual. Ejemplo: `e15648b0-fcd5-4799-a14c-cc463ae8a133`. |
| `countryCode` | País del proceso de pago. Usa un valor `ENUM`; consulta [Cobertura por país](https://docs.y.uno/es/docs/sdks/resources/country-coverage.md). |
| `language` | Idioma de los formularios de pago. Usa cualquier código de la lista de [Idiomas compatibles](https://docs.y.uno/es/docs/sdks/resources/languages-supported.md). Ejemplo: `en`. Por defecto usa el idioma del navegador cuando está disponible. |
| `showLoading` | Controla la visibilidad de la página de carga o indicador de Yuno durante el proceso de pago. |
| `onLoading` | Obligatorio para recibir notificaciones sobre llamadas al servidor o eventos de carga. |
| `elementSelector` | Elemento HTML donde se monta el Yuno SDK. Pásalo dentro de `renderMode: { type: "element", elementSelector }`; a nivel superior el SDK lo ignora. |
| `card` | Define ajustes específicos del formulario de tarjeta de crédito. |
| `enrollmentStatus` | Callback que se ejecuta al terminar la inscripción; recibe `vaultedToken` y `status`. Opciones de estado: `CREATED`, `EXPIRED`, `REJECTED`, `READY_TO_ENROLL`, `ENROLL_IN_PROCESS`, `UNENROLL_IN_PROCESS`, `ENROLLED`, `DECLINED`, `CANCELED`, `ERROR`, `UNENROLLED`. |
| `issuersFormEnable` | Habilita el formulario de emisores (lista de bancos). |
| `texts` | Texto personalizado de los botones del formulario de pago para adaptarlo al idioma o a la marca de tu app. |
| `card.isCreditCardProcessingOnly` | Opcional. Obliga a que las transacciones con tarjeta se procesen solo como crédito, lo cual es útil donde las tarjetas funcionan como crédito y débito. |

El siguiente bloque de código presenta un ejemplo de la configuración de los parámetros de inscripción y del montaje.

```javascript theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
await yuno.mountEnrollmentLite({
  customerSession: 'e15648b0-fcd5-4799-a14c-cc463ae8a133',
  /**
   * The complete list of country codes is available on /docs/sdks/resources/country-coverage
   */
  countryCode: country,
  /**
  - Language for payment forms (see Supported languages)
  - Defaults to browser language when available
  */
  language: 'en',
  /**
   * Hide or show the Yuno loading/spinner page
   * Default is true
   * @optional
   */
  showLoading: true,
  /**
   * Required if you'd like to be informed if there is a server call
   * @param { isLoading: boolean, type: 'DOCUMENT' | 'ONE_TIME_TOKEN'  } data
   * @optional
   */
  onLoading: (args) => {
    console.log(args);
  },
  /**
   *  API card
   *  @optional
   */
  card: {
    /**
     * Mode render card can be step or extends
     * Default extends
     */
    type: "extends",
    /**
     * Write custom CSS to style the card form. Your CSS will be injected into the iframe.
     * Example:
     * `@import url('https://fonts.googleapis.com/css2?family=Luckiest+Guy&display=swap');
     *  .Yuno-front-side-card__name-label {
     *    color: red !important;
     *    font-family: 'Luckiest Guy' !important;
     *   }`
     */
    styles: '',
    /**
     * Show checkbox for save/enroll card
     * Default is false
     */
    cardSaveEnable: false,
    /**
     * Custom texts in Card forms buttons
     * Example:
     *
     *  texts: {
     *    cardForm?: {
     *      enrollmentSubmitButton?: string;
     *       paymentSubmitButton?: string;
     *     }
     *     cardStepper?: {
     *       numberCardStep?: {
     *         nextButton?: string;
     *       },
     *       cardHolderNameStep?: {
     *         prevButton?: string;
     *         nextButton?: string;
     *       },
     *       expirationDateStep?: {
     *         prevButton?: string;
     *         nextButton?: string;
     *       },
     *       cvvStep?: {
     *         prevButton?: string;
     *         nextButton?: string;
     *       }
     *     }
     *  }
     */
    texts: {},
    /**
     * Hide or show the document fields into card form
     * Default is true
     * @optional
     */
    documentEnable: true,
  },
  /**
   * Call back is called with the following object
   * @param {{
   *  status: 'CREATED'
   *    | 'EXPIRED',
   *    | 'REJECTED',
   *    | 'READY_TO_ENROLL',
   *    | 'ENROLL_IN_PROCESS',
   *    | 'UNENROLL_IN_PROCESS',
   *    | 'ENROLLED',
   *    | 'DECLINED',
   *    | 'CANCELED',
   *    | 'ERROR',
   *    | 'UNENROLLED',
   *  vaultedToken: string,
   * }}
   */
  enrollmentStatus: ({ status, vaultedToken}) => {
    console.log('status', { status, vaultedToken})
  },
  /**
   * If this is called the SDK should be mounted again
   * @param { error: 'CANCELED_BY_USER' | any }
   * @optional
   */
  error: (error) => {
    console.log('There was an error', error)
  },
});
```

La opción `card.isCreditCardProcessingOnly` descrita arriba se omite de este ejemplo por brevedad; consulta la tabla de parámetros para más detalles.

## Referencia común

Para ver todos los detalles de parámetros y personalización, consulta la [Referencia común del SDK Web](https://docs.y.uno/es/docs/sdks/resources/references/web.md).


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