Lite SDK

Key Features of Lite SDK

Lightweight Integration

• Smaller artifact size: <300 KB

• Faster initialization: Streamlined setup process

• Web-based UI: Uses web components for payment forms

• Reduced dependencies: Minimal impact on app size

• Shared Configuration: The Lite SDK uses the same PaymentSession options as the main SDK, including:

  • Appearance customization

  • Billing details

  • Shipping information

  • Payment method preferences

  • Branding options

Requirements

• IOS 15.1+

• Cocoapods​

1. Setup the server

Follow the Server Setup section.

2. Build Checkout in Your App

2.1 Add the Dependency

In your Podfile:

Lite SDK only

pod 'hyperswitch-sdk-ios-lite'

Lite SDK with Scan Card functionality

pod 'hyperswitch-sdk-ios-lite/scancard'

Note: The Lite SDK and the regular SDK share a codebase. Their versions must match at all times. Replace Latest_version with the actual version number.

2.2 Setup the Lite SDK and Fetch a Payment

Initialize PaymentSession:

import HyperswitchLite
paymentSession = PaymentSession(publishableKey: <YOUR_PUBLISHABLE_KEY>)

// Initialize with client secret
paymentSession.initPaymentSession(paymentIntentClientSecret: paymentIntentClientSecret)

Complete Payment

// Present the PaymentSheet Lite
paymentSession.presentPaymentSheetLite(
    viewController: self, 
    configuration: configuration, 
    completion: { 
        result in
            DispatchQueue.main.async {
                switch result {
                case .completed:
                    self.statusLabel.text = "Payment complete"
                case .failed(let error):
                    self.statusLabel.text =  "Payment failed: \(error)"
                case .canceled:
                    self.statusLabel.text = "Payment canceled."
            }
    }
})

Final Step

You have successfully integrated the Hyperswitch Lite SDK into your iOS app. The Lite SDK delivers full payment processing capabilities with a smaller footprint, perfect for apps where bundle size matters.