SS-iOS-SDK

Native iOS SDK for embedding SecondStreet promotions inside any iOS app — no browser takeover.

Supports iOS 13+ · Swift · Swift Package Manager

---

Installation

Swift Package Manager (Xcode)

File → Add Package Dependencies
→ paste: https://github.com/secondstreet/ss-ios-sdk
→ Add Package

Or add to Package.swift

dependencies: [
    .package(url: "https://github.com/secondstreet/ss-ios-sdk", from: "1.0.0")
]

---

Usage

Import

import SecondStreetSDK

Modal (full or partial screen)

// Full screen
PromotionKit.show(promoId: "your-promo-id", from: self)

// 90% bottom sheet
PromotionKit.show(
    promoId:       "your-promo-id",
    from:          self,
    heightPercent: 90
)

Inline (renders directly in your layout)

let promoView = PromotionKit.inline(promoId: "your-promo-id")
stackView.addArrangedSubview(promoView)

Floating Button (FAB)

PromotionKit.attach(
    promoId: "your-promo-id",
    to:      self,
    icon:    "🎁",
    label:   "Win a Prize"
)

With test server

PromotionKit.show(
    promoId:   "your-promo-id",
    from:      self,
    testServer: "staging",  // Uses https://consumer-qa-staging.secondstreetapp.com
    delegate:  self
)

extension MyViewController: PromotionDelegate {
    func promotionDidComplete(promoId: String, reward: [String: Any]?) {
        let coupon = reward?["couponCode"] as? String
        showRewardBanner(coupon: coupon)
    }
    func promotionDidClose(promoId: String) {
        resumeVideo()
    }
}

---

Parameters

Parameter	Type	Default	Description
promoId	String	required	Your promotion ID
testServer	String?	nil	Optional test server name (uses consumer-qa-{testServer}.secondstreetapp.com)
heightPercent	Int	100	Screen height % for modal
delegate	PromotionDelegate?	nil	Optional callback listener for events

Base URLs

• Production: https://consumer.secondstreetapp.com
• Staging: https://consumer-qa-{testServer}.secondstreetapp.com (when testServer is provided)

---

Requirements

• iOS 13.0+
• Swift 5.5+
• Xcode 13+