PayBito Payments
iOS SDK Guide

Quick Start

The PayBito iOS Payment SDK is the official high-performance SDK designed for seamless mobile checkout integration. Built on Apple's modern reactive architectures, it helps merchants easily incorporate the PayBito Secure Checkout into their native iOS environments.

Key Features

Installation

Integrating the PayBito iOS Payment SDK is straightforward. Below are the requirements and standard installation procedures.

System Requirements

Swift Package Manager (Recommended)

You can easily integrate the SDK into your project via Swift Package Manager:

https://github.com/hashcashconsultant/PaybitoSDK.git

SDK Initialization

Initialize the SDK once during your app's startup phase (e.g., in your custom AppDelegate class or the root layout's @main struct in SwiftUI). This prepares the config instance to communicate and cache custom Broker UI branding values.

import PayBitoSDK

let config = PaymentConfiguration(
    merchantId: "YOUR_MERCHANT_ID",
    publicKey: "pk_your_public_key",
    brokerId: "YOUR_BROKER_ID",
    origin: "https://portal.paybito.com/payments/merchant/",
    enableDebugLogs: true
)

PayBito.initialize(configuration: config)

Cart Management

The CartManager provided by the SDK is a globally accessible, thread-safe, and highly reactive component that automatically calculates totals and updates the UI whenever updates happen.

A. Adding Items to the Cart

The CartManager handles concurrency internally. Simply instantiate a product and call the helper from anywhere:

let product = PayBitoProduct(
    productId: "P001",
    name: "4K Monitor",
    price: 399.50,
    imageUrl: "https://example.com/monitor.jpg"
)

// Safely add items to the cart from anywhere in your app!
PayBito.addToCart(product)

B. Observing Cart State (Reactive)

Observe the cart state dynamically in SwiftUI to reflect the badge counts or cart details on the fly:

@ObservedObject private var cartManager = PayBito.shared.cartManager

// In the view builder layout...
if cartManager.count > 0 {
    Text("\(cartManager.count)")
        .font(.caption)
        .foregroundColor(.white)
        .padding(6)
        .background(Color.red)
        .clipShape(Circle())
}

C. Updating Quantity

Easily increment or decrement existing quantities inside the shopping cart using the product ID:

// Update quantity (e.g. triggered from plus/minus buttons)
cartManager.updateQuantity(productId: product.productId, newQuantity: newQuantity)

D. Displaying the Checkout Cart

Natively present the user's shopping cart UI by wrapping the SDK's view builder structure inside a standard sheet modifier:

.sheet(isPresented: $isShowingCart) {
    PayBito.openCart()
}

Secure Checkout & Backend Token Sync

For strict security reasons, mobile apps should **never** directly generate checkout session tokens using the CLIENT-SECRET-KEY. The Secret Key must remain isolated on your backend infrastructure.

The Token Generation Flow

Launching Checkout Portal

Once you securely retrieve the checkout session token from your server, initiate checkout via the SDK checkout delegate interface:

// Safely launch the Secure Payment Portal
PayBito.checkout(token: "PCN-GENERATED-TOKEN")

Deep-Link Configuration

To support automatic success and cancellation callbacks from the secure checkout portal back into your native app, you must register a custom URL scheme in Xcode.

Xcode Scheme Registration Steps

TechStore Demo App Guide

The TechStore Demo App serves as a reference implementation for integrating the PayBito Payment SDK into an iOS application using SwiftUI. Below are the key views showing its complete implementation.

Products Grid

Branded Cart Sheet

Secure Checkout Portal

Payment Success Screen

Core Implementation Flow

.onAppear {
    let config = PaymentConfiguration(
        merchantId: "26660L",
        publicKey: "pk_test_...",
        brokerId: "ARNA...", // Merchant's Broker ID for custom UI branding
        origin: "https://portal.paybito.com/payments/merchant/",
        enableDebugLogs: true
    )
    PayBito.initialize(configuration: config)
}

let checkoutPublisher = NotificationCenter.default.publisher(for: NSNotification.Name("PayBitoSDK_LaunchCheckout"))

// Listen in the SwiftUI body modifiers:
.onReceive(checkoutPublisher) { _ in
    fetchCheckoutToken()
}

.sheet(isPresented: $isShowingCheckout) {
    PayBito.checkout(token: checkoutToken)
}

let successPublisher = NotificationCenter.default.publisher(for: NSNotification.Name("PayBitoSDK_PaymentSuccess"))

.onReceive(successPublisher) { _ in
    withAnimation {
        showSuccessScreen = true
    }
}

FAQ & Security Requirements

Review key answers regarding secure token architectures, common setup questions, and developer checklist.

Frequently Asked Questions