> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# iOS
> Abre el checkout alojado de Dodo Payments desde una app de iOS en SFSafariViewController y obtén un resultado tipado en una sola llamada.
Este es el SDK oficial de checkout de Dodo Payments para iOS y Swift. Abre el checkout alojado de Dodo en una vista de navegador nativa y devuelve un resultado tipado.
Crea checkout\_url desde tu backend, que este SDK abrirá.
Consulta cómo encaja esto en el flujo completo de pagos móviles.
El SDK de iOS abre el checkout alojado de Dodo en `SFSafariViewController`, no almacena ninguna API key y nunca llama directamente a la API de Dodo. Toda la lógica del checkout se ejecuta en el navegador; el SDK simplemente gestiona el ciclo de vida de la vista y captura la URL de retorno.
Requiere iOS 16+ y Swift 6.
## Instalación
En Xcode, ve a **File → Add Package Dependencies** e introduce:
```
https://github.com/dodopayments/dodopayments-mobile-sdk-ios
```
Selecciona la versión 1.0.0 o posterior.
Como alternativa, añádelo a tu `Package.swift`:
```swift Package.swift theme={null}
.package(url: "https://github.com/dodopayments/dodopayments-mobile-sdk-ios", from: "1.0.0")
```
Tu app debe registrar un esquema de URL para recibir la URL de retorno del checkout. Añade esto a tu `Info.plist`:
```xml Info.plist theme={null}
CFBundleURLTypes
CFBundleURLName
myapp
CFBundleURLSchemes
myapp
```
También puedes añadirlo mediante la interfaz **Info → URL Types** de Xcode.
## Uso
```swift theme={null}
import DodoCheckout
let result = try await DodoCheckout.start(
checkoutUrl: checkoutUrl, // from your backend's checkout session
returnUrl: URL(string: "myapp://checkout/return")!,
onEvent: { event in print(event.name) } // logging only
)
switch result.status {
case .succeeded: showSuccess(result.paymentId)
case .failed: showFailure()
case .cancelled: dismiss()
case .pending: showPending()
case .expired: showExpired()
}
```
## Reenvío de la URL de retorno
`SFSafariViewController` no tiene una forma dentro del proceso de capturar su propia URL de retorno. Tu app debe reenviar las URL entrantes al SDK.
```swift theme={null}
.onOpenURL { url in
DodoCheckout.handleOpenURL(url)
}
```
```swift SceneDelegate.swift theme={null}
func scene(_ scene: UIScene, openURLContexts URLContexts: Set) {
guard let url = URLContexts.first?.url else { return }
DodoCheckout.handleOpenURL(url)
}
```
Es seguro reenviar aquí todas las URL. `handleOpenURL` solo actúa sobre las URL que coinciden con tu `returnUrl` registrado y devuelve `false` para cualquier otra.
## Qué significa el resultado
`result.status` es una indicación para la interfaz, no una prueba de pago. Confirma cada pago desde tu backend mediante el webhook `payment.succeeded` / `subscription.active`.
Uno de `succeeded`, `failed`, `cancelled`, `pending`, `expired`.
Se establece cuando la URL de retorno incluía uno. Muéstralo en la interfaz, pero no lo uses para conceder acceso. Consulta Verificar el pago más adelante.
Se establece para los checkouts de suscripciones.
Se establece cuando el checkout incluye productos con license key.
Se establece cuando el checkout captura un correo electrónico.
Todos los parámetros de consulta de la URL de retorno, literalmente.
## Verificar el pago
Dodo Payments llama a tu backend cuando un pago se realiza correctamente o una suscripción se activa.
Consulta `paymentId` con tu secret key para comprobar su estado directamente.
Concede acceso después de que uno de estos confirme el pago, nunca basándote únicamente en `result.status`.
## Errores
`start` lanza `CheckoutError` únicamente por un uso incorrecto o un fallo de la plataforma. Un pago cancelado o rechazado siempre es un resultado, nunca una excepción.
* `invalidCheckoutUrl` (`INVALID_CHECKOUT_URL`): no es una URL de sesión de `checkout.dodopayments.com`.
* `invalidReturnUrl` (`INVALID_RETURN_URL`): no es una URL absoluta válida.
* `alreadyInProgress` (`ALREADY_IN_PROGRESS`): ya hay un checkout en ejecución.
* `platformError` (`PLATFORM_ERROR`): fallo inesperado de la plataforma.
## Sesiones abandonadas
Si la app se cierra durante el checkout, recupera la sesión en el siguiente inicio y reconciliala con tu backend.
```swift theme={null}
import DodoCheckout
if let abandoned = DodoCheckout.getAbandonedSession() {
// reconcile abandoned.sessionId with your backend, then:
DodoCheckout.clearAbandonedSession()
}
```
## Relacionado
El mismo contrato para Android, React Native y Flutter.
Encapsula este mismo núcleo de Swift en iOS.