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

# Modo Seamless

> Migra las integraciones iOS Seamless (Yuno.startPaymentSeamlessLite) a la API unificada Transaction.

Seamless era el punto de entrada anterior más simple: una sola llamada `await` que devolvía el resultado final. Sin delegate ni callbacks. Entregabas un `SeamlessParams` y un `PaymentMethodSelected`; el SDK renderizaba el formulario, tokenizaba, creaba el pago, ejecutaba 3DS y devolvía un `Yuno.Result`.

En la API unificada el mismo flujo es el **comportamiento por defecto** de `Transaction.start(paymentSelected:)`. No necesitas sobrescribir ningún controlador aparte de `onStatus`. El único cambio estructural es el modelo de entrega del resultado: antes se devolvía de forma asíncrona, ahora llega mediante un callback en `onStatus`.

## Antes de comenzar

* Reemplaza `import YunoSDK` por `import SdkPayments`. Tu clave de API pública y las sesiones de checkout que crea tu backend no cambian ([Before you begin](https://docs.y.uno/es/docs/yuno-sdk/get-started.md#before-you-begin)).
* Decide quién crea el pago. El `workflow` de la sesión de checkout debe coincidir con esa decisión:

| Quién crea el pago | En Seamless tenías | En la API unificada | `workflow` de la sesión |
| - | - | - | - |
| Tu backend | Sin equivalente: Seamless nunca permitía crearlo | Sobrescribe `createPayment` | Por defecto (`SDK_CHECKOUT`) |
| El SDK | Siempre | Sin sobrescritura | `SDK_SEAMLESS` |

> [!WARNING]
>
> Una sesión con el workflow por defecto y sin sobrescritura de `createPayment` termina en `INTERNAL_ERROR`: el backend rechaza la creación del pago por parte del SDK. Consulta [`createPayment`](https://docs.y.uno/es/docs/yuno-sdk/controllers/create-payment).

## Comparación lado a lado

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

// 1. Initialize once at app startup
Yuno.initialize(apiKey: "your-public-api-key")

// 2. Trigger the payment from a single async call
func pay(paymentSelected: PaymentMethodSelected) async {
    let params = SeamlessParams(
        checkoutSession: "session-from-backend",
        countryCode: "CO",
        language: "en",
        viewController: nil
    )

    let result = await Yuno.startPaymentSeamlessLite(
        with: params,
        paymentSelected: paymentSelected,
        showPaymentStatus: true
    )

    switch result.status {
    case .succeeded:      print("Success")
    case .reject:         print("Rejected")
    case .fail:           print("Failed")
    case .processing:     print("Processing")
    case .internalError:  print("Internal error")
    case .userCancelled:  print("User cancelled")
    @unknown default:     break
    }
}
```

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

// 1. Initialize once at app startup
SdkPayments.initialize(apiKey: "your-public-api-key")

// 2. Implement a minimal controller
final class Checkout: SdkPayments.TransactionController {

    func onStatus(status: SdkPayments.TransactionStatus) {
        switch status.status {
        case "INTERNAL_ERROR":  print("Internal error")
        case "USER_CANCEL":     print("User cancelled")
        // Handle other backend statuses (e.g. SUCCEEDED, DECLINED, PENDING) as needed.
        default:                break
        }
    }

    // 3. Trigger the payment
    func pay(paymentSelected: SdkPayments.PaymentMethodSelected) {
        let config = SdkPayments.TransactionConfig(
            checkoutSession: "session-from-backend",
            countryCode: "CO",
            language: "en",
            controller: self,
            showStatusScreen: true,
            viewController: nil
        )

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

## Qué cambia

Agrupado en el orden en que editas el código. **Renombrado**: mismo rol, nuevo nombre. **Movido**: mismo valor, nuevo propietario. **Eliminado**: no hay nada que llamar. **Nuevo**: sin contraparte anterior. La última columna es lo único que debes hacer además del cambio de nombre.

### Inicialización y configuración

| Seamless | 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; elimina el prefijo `Yuno.` y pásalo en cada transacción en lugar de una sola vez al inicio. |
| `SeamlessParams.checkoutSession`, `.countryCode`, `.language`, `.viewController` | Los mismos campos en `SdkPayments.TransactionConfig` | Movido | Mismos valores; `viewController` sigue siendo exclusivo de iOS y opcional en SwiftUI. La configuración también recibe el `controller` (consulta Controlador). |
| Argumento `showPaymentStatus:` de `startPaymentSeamlessLite` | `SdkPayments.TransactionConfig.showStatusScreen` | Movido | Consulta la nota siguiente. |

> [!NOTE]
>
> **La pantalla de resultado del SDK ahora está desactivada por defecto.** Define `showStatusScreen: true` para mantenerla.

### Controlador

| Seamless | Unificado | Cambio | Qué hacer |
| - | - | - | - |
| *(sin delegate)* | `SdkPayments.TransactionController` | Nuevo | Incluso el caso más simple necesita una instancia de controlador: haz que una clase implemente solo `onStatus` y pásala como `TransactionConfig.controller`. El SDK no la retiene: mantenla viva durante toda la transacción. |
| `Yuno.Result` devuelto por `await` | `onStatus(status:)` con `SdkPayments.TransactionStatus` | Movido | El resultado ahora se entrega mediante callback: no puedes usar `await` en línea, así que si tu código encadenaba lógica sobre el valor devuelto o lo devolvía al llamador, refactorízalo para reaccionar dentro de `onStatus`. Sigue siendo el único callback de resultado, una vez por transacción, también cuando el SDK muestra su pantalla de resultado. `status` y `substatus` provienen del backend; el SDK solo emite `INTERNAL_ERROR` y `USER_CANCEL`. Consulta [`Status`](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-receive#status). |
| `Yuno.Result.message` | `SdkPayments.TransactionStatus.message` | Renombrado | Mismo rol. `source` ahora es un enum (`.sdk` / `.backend`) y `code` ya no es opcional. |

### Puntos de entrada

| Seamless | Unificado | Cambio | Qué hacer |
| - | - | - | - |
| `Yuno.startPaymentSeamlessLite(with:paymentSelected:showPaymentStatus:)`, tanto la sobrecarga `async` como la de `callback:` | `SdkPayments.Transaction(config:).start(paymentSelected:)` | Renombrado | Crea la configuración y luego llama a `start`. No hay nada que esperar con `await` ni callback que pasar: el resultado llega en `onStatus`. Sigues eligiendo el método y pasándolo. |
| `Yuno.receiveDeeplink(_:)` | `SdkPayments.handleDeeplink(_:)` | Renombrado | Mismo rol: reenvía la URL que recibe tu app después de una redirección externa. Consulta [Handle deeplinks](https://docs.y.uno/es/docs/yuno-sdk/features/handle-deeplinks.md). |
| `Yuno.hideLoader()` | *(eliminado)* | Eliminado | Elimina la llamada: el SDK cierra su propio indicador de carga. Con una sobrescritura de `showLoading` recibes `isLoading: false` en su lugar. |

## Relacionado

* [Get Started](https://docs.y.uno/es/docs/yuno-sdk/get-started.md). Guía de la API unificada; el nuevo "equivalente de Seamless" es ahora la ruta por defecto.
* [`onStatus`](https://docs.y.uno/es/docs/yuno-sdk/controllers/on-status). Controlador que entrega el estado final.
* [`TransactionConfig`](https://docs.y.uno/es/docs/yuno-sdk/reference/objects-you-pass#transaction-config). Referencia completa de campos.
* [Migration / Lite](https://docs.y.uno/es/docs/yuno-sdk/migration/ios/payment/lite.md). Migración casi idéntica; Seamless y Lite se unifican en la misma ruta por defecto en la API unificada.


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