Lite SDK (Payment iOS)

This page documents a legacy SDK. Starting a new integration? Use the Yuno SDK. Already on a legacy SDK? Follow the migration guide.The new Yuno SDK (Web v2.x, iOS v3.x, Android v3.x) replaces the Full, Lite, Seamless, Render, Headless, and Secure Fields SDKs with one API across every platform. Legacy SDKs remain supported side by side during the transition and are scheduled for deprecation in 2027. Contact your Account Manager for migration planning.

Orientation: Choosing Your Integration Flow, before you begin, please review the Official Integration Flow.

Standard Flow (Full Checkout): Recommended for most merchants. Yuno handles the UI, security, and automatic updates for payment methods.
Custom Flow (This SDK): Use this only if you require full control over the UX. Note: You will be responsible for manually handling payment statuses, 3DS transitions, and fraud routing data collection.

Step 1: Include the library in your project

CocoaPods

Add the following line to your Podfile:

pod 'YunoSDK', '~> 2.29.0'

Swift Package Manager

Add YunoSDK as a dependency:

.package(url: "https://github.com/yuno-payments/yuno-sdk-ios.git", .upToNextMajor(from: "2.29.0"))

Step 2: Initialize SDK

Initialize the SDK with your Public API Key:

import YunoSDK

Yuno.initialize(
    apiKey: "PUBLIC_API_KEY",
    config: YunoConfig(),
    callback: { print("Yuno SDK initialized") }
)

Step 3: Adopt YunoPaymentDelegate

Adopt the YunoPaymentDelegate protocol:

Swift 6 Concurrency RequirementsIf you’re using Swift 6, you’ll need to implement the YunoPaymentDelegate protocol with specific concurrency considerations. See the Swift 6 Concurrency guide for detailed implementation options and best practices.

class ViewController: UIViewController, @preconcurrency YunoPaymentDelegate {
    var checkoutSession: String { "checkout_session" }
    var countryCode: String { "US" }
    var viewController: UIViewController? { self }

    func yunoCreatePayment(with token: String) {
        // Call your backend to create a payment
    }

    func yunoCreatePayment(with token: String, information: [String: Any]) {
        // Call your backend to create a payment using the additional token information
    }

    func yunoPaymentResult(_ result: Yuno.Result) {
        // Handle final payment state
    }
}

Method	Description
`yunoCreatePayment(with:)`	Called when a one-time token is generated. Create the payment on your backend.
`yunoCreatePayment(with:information:)`	Alternative callback that also includes additional information about the one-time token, such as card data (DPAN BIN, brand, last four digits). See OTT additional information for the available keys.
`yunoPaymentResult(_:)`	Called when the payment process completes. Receives a `Yuno.Result` value.

Important NoteImplement either yunoCreatePayment(with:) or yunoCreatePayment(with:information:), not both. The SDK calls every version you implement, so implementing both creates the payment twice.

Step 4: Initiate the payment process

Yuno.startPaymentLite(
    with: self,
    paymentSelected: paymentSelected,
    showPaymentStatus: true
)

Step 5: Continue payment (Required)

If sdk_action_required: true is returned by the API, call:

Yuno.continuePayment()

Demo AppSee the Yuno iOS SDK repository for full implementation examples.

Overview

Seamless SDK

Lite SDK

Headless SDK

Card Enrollment

Additional Features

Resources

Additional Platforms

Web Frameworks

Validate your integration

External Native Modules

Step 1: Include the library in your project

CocoaPods

Swift Package Manager

Step 2: Initialize SDK

Step 3: Adopt YunoPaymentDelegate

Step 4: Initiate the payment process

Step 5: Continue payment (Required)

​Step 1: Include the library in your project

​CocoaPods

​Swift Package Manager

​Step 2: Initialize SDK

​Step 3: Adopt YunoPaymentDelegate

​Step 4: Initiate the payment process

​Step 5: Continue payment (Required)

Step 1: Include the library in your project

CocoaPods

Swift Package Manager

Step 2: Initialize SDK

Step 3: Adopt YunoPaymentDelegate

Step 4: Initiate the payment process

Step 5: Continue payment (Required)