iOS

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.

Checkout Sessions API

Crea checkout_url desde tu backend, que este SDK abrirá.

Mobile Integration Guide

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

Add the Package

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:

Package.swift

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

Info.plist

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>myapp</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>myapp</string>
    </array>
  </dict>
</array>

También puedes añadirlo mediante la interfaz Info → URL Types de Xcode.

Uso

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.

SwiftUI
SceneDelegate

.onOpenURL { url in
    DodoCheckout.handleOpenURL(url)
}

SceneDelegate.swift

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    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.

CheckoutStatus

requerido

Uno de succeeded, failed, cancelled, pending, expired.

String?

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.

String?

Se establece para los checkouts de suscripciones.

[String]?

Se establece cuando el checkout incluye productos con license key.

String?

Se establece cuando el checkout captura un correo electrónico.

[String: String]

Todos los parámetros de consulta de la URL de retorno, literalmente.

Verificar el pago

Webhooks

Dodo Payments llama a tu backend cuando un pago se realiza correctamente o una suscripción se activa.

Get Payment Detail

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.

import DodoCheckout

if let abandoned = DodoCheckout.getAbandonedSession() {
    // reconcile abandoned.sessionId with your backend, then:
    DodoCheckout.clearAbandonedSession()
}

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Mobile Integration Guide

Instalación

Uso

Reenvío de la URL de retorno

Qué significa el resultado

Verificar el pago

Webhooks

Get Payment Detail

Errores

Sesiones abandonadas

Relacionado

Mobile Integration Guide

React Native SDK

Checkout Sessions API

Mobile Integration Guide

​Instalación

​Uso

​Reenvío de la URL de retorno

​Qué significa el resultado

​Verificar el pago

Webhooks

Get Payment Detail

​Errores

​Sesiones abandonadas

​Relacionado

Mobile Integration Guide

React Native SDK

Instalación

Uso

Reenvío de la URL de retorno

Qué significa el resultado

Verificar el pago

Errores

Sesiones abandonadas

Relacionado