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

> Migra la inscripción Headless de iOS (Yuno.apiClientEnroll) a la API unificada Transaction.

La inscripción headless era una API de tokenización pura: recopilabas los datos en tu propia UI, llamabas a `continueEnrollment(data:)` y recibías un diccionario con `vaultedToken`, `customerSession` y `status`.

En la API unificada, la inscripción headless ya no es un cliente separado. Es el mismo `Transaction.start(paymentSelected:)` con `transactionData` establecido en el `PaymentMethodSelected`. El SDK ejecuta la inscripción internamente e informa la finalización mediante `onStatus`.

## Antes de empezar

* Reemplaza `import YunoSDK` por `import SdkPayments`. Tu clave de API pública y las sesiones de cliente que crea tu backend no cambian ([Antes de comenzar](https://docs.y.uno/es/docs/yuno-sdk/get-started.md#before-you-begin)).
* No hay ningún pago que crear: `createPayment` no se invoca durante la inscripción, así que sobrescribirlo no tiene efecto.

## Comparación lado a lado

```swift Before. Headless enrollment theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import YunoSDK

Yuno.initialize(apiKey: "your-public-api-key")

let enrollHeadless = try Yuno.apiClientEnroll(
    countryCode: "CO",
    customerSession: "session-from-backend"
)

// Card fields come from your own form
let data = EnrollmentCollectedData(
    customerSession: "session-from-backend",
    paymentMethod: CollectedData(
        type: "CARD",
        vaultedToken: nil,
        card: CardData(
            detail: CardData.Detail(
                number: cardNumber,
                expirationMonth: expMonth,
                expirationYear: expYear,
                securityCode: cvv,
                holderName: holder
            )
        ),
        customer: nil
    )
)

let result = try await enrollHeadless.continueEnrollment(data: data)
let vaultedToken = result["vaultedToken"]
let status = result["status"]
```

```swift After. Unified Transaction theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
import SdkPayments

SdkPayments.initialize(apiKey: "your-public-api-key")

final class EnrollmentModel: SdkPayments.TransactionController {

    func onStatus(status: SdkPayments.TransactionStatus) {
        // On a successful status, retrieve the vaulted token from your
        // backend's "list customer payment methods" endpoint.
    }

    func enroll(card: SdkPayments.CardTransactionData) {
        let paymentSelected = SdkPayments.PaymentMethodSelected(
            paymentMethodType: "CARD",
            transactionData: SdkPayments.TransactionData(card: card)
        )

        let config = SdkPayments.TransactionConfig(
            customerSession: "session-from-backend",
            countryCode: "CO",
            controller: self
        )

        SdkPayments.Transaction(config: config)
            .start(paymentSelected: paymentSelected)
    }
}
```

## Qué cambia

Agrupado en el orden en que editas el código. **Renombrado**: mismo rol, nombre nuevo. **Movido**: mismo valor, nuevo responsable. **Eliminado**: nada que llamar. **Nuevo**: sin equivalente heredado. La última columna es lo único que tienes que hacer además del cambio de nombre.

### Inicialización y configuración

| Headless | Unificado | Cambio | Qué hacer |
| - | - | - | - |
| `import YunoSDK` | `import SdkPayments` | Renombrado | |
| `Yuno.initialize(apiKey:)` | `SdkPayments.initialize(apiKey:)` | Renombrado | El parámetro `callback:` ya no existe; usa la sobrecarga `async` si necesitas esperar. |
| `Yuno.Appearance` pasado en `YunoConfig.appearance` | `SdkPayments.Appearance` en `SdkPayments.TransactionConfig.appearance` | Renombrado | Mismo inicializador; quita el prefijo `Yuno.` y pásalo por transacción en lugar de una sola vez al inicio. |
| `EnrollmentCollectedData` / `CollectedData` | `SdkPayments.PaymentMethodSelected` + `SdkPayments.TransactionData` | Renombrado | El contenedor se divide en dos: el tipo de método va en `PaymentMethodSelected` (la sesión determina el método que realmente se inscribe), los datos recopilados bajo su `transactionData` (filas siguientes). |
| `EnrollmentCollectedData.customerSession` y el argumento `customerSession:` de `apiClientEnroll` | `SdkPayments.TransactionConfig.customerSession` | Movido | Pasa a la configuración; pásalo una sola vez. |
| Argumento `countryCode:` de `apiClientEnroll` | `SdkPayments.TransactionConfig.countryCode` | Movido | |
| `CollectedData.type` | `SdkPayments.PaymentMethodSelected.paymentMethodType` | Movido | Pasa al objeto padre. |
| `CollectedData.card.detail` (`CardData.Detail`) | `SdkPayments.TransactionData.card` (`SdkPayments.CardTransactionData`) | Movido | Mismos campos, con espacio de nombres bajo `transactionData`. `CardData.save` y `CardData.installment` no tenían ningún papel en la inscripción y siguen sin tenerlo. Consulta [`TransactionData`](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-pass#transaction-data). |
| `CollectedData.customer` | `SdkPayments.TransactionData.customer` | Movido | Pasa bajo `transactionData`. |
| `CollectedData.vaultedToken` | `SdkPayments.PaymentMethodSelected.vaultedToken` | Movido | No se requiere nada. Se ignora durante la inscripción: la inscripción existe para producir un token almacenado, así que aún no hay nada vinculado a lo que hacer referencia. |

### Controlador

| Headless | Unificado | Cambio | Qué hacer |
| - | - | - | - |
| *(ninguno)* | `SdkPayments.TransactionController` | Nuevo | Haz que una clase lo implemente y pásala como `TransactionConfig.controller`. El SDK no la retiene: mantenla viva durante toda la transacción. |
| Resultado `[String: String]` de `continueEnrollment` (`vaultedToken`, `customerSession`, `status`) | `onStatus(status:)` | Movido | Ahora es el único callback de resultado, una vez por transacción. `status` y `substatus` vienen del backend; el SDK por sí mismo solo emite `INTERNAL_ERROR` y `USER_CANCEL`. **El token almacenado ya no se devuelve al cliente**: obtenlo desde el endpoint de listado de métodos de pago del cliente de tu backend después de que llegue el estado de éxito. Consulta [`Status`](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-receive#status). |
| `YunoEnrollHeadlessError` lanzado por `apiClientEnroll` y `continueEnrollment` | `onStatus` con `status == "INTERNAL_ERROR"` y `message` | Movido | Nada lanza errores: gestiona `INTERNAL_ERROR` en `onStatus`. |

### Puntos de entrada

| Headless | Unificado | Cambio | Qué hacer |
| - | - | - | - |
| `Yuno.apiClientEnroll(countryCode:customerSession:)` | `SdkPayments.Transaction(config:)` | Renombrado | El objeto de transacción reemplaza al cliente headless. Crea la configuración y luego la transacción. |
| `continueEnrollment(data:)` | `start(paymentSelected:)` | Renombrado | Pasa los datos recopilados como `transactionData` en `PaymentMethodSelected`. La llamada ya no devuelve un resultado: el SDK ejecuta la inscripción internamente e informa la finalización mediante `onStatus`. |
| `Yuno.receiveDeeplink(_:)` | `SdkPayments.handleDeeplink(_:)` | Renombrado | Mismo rol: reenvía la URL que tu app recibe después de una redirección externa. Consulta [Gestionar deeplinks](https://docs.y.uno/es/docs/yuno-sdk/features/handle-deeplinks.md). |

## Relacionado

* [Función de inscripción](https://docs.y.uno/es/docs/yuno-sdk/features/enrollment.md). Guía de inscripción de la API unificada.
* [Inscripción lite](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/enrollment/lite.md). El SDK presenta el formulario por ti.
* [Inscripción con render](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/enrollment/render.md). Inserta tú mismo el formulario del SDK.
* [Migración / Headless (pago)](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/headless.md). La contraparte de pago para el submodo Headless.
* [`TransactionData`](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-pass#transaction-data). Forma de los datos recopilados previamente.


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