iOS

post_install do |installer|
  installer.pods_project.targets.each do |t|
    t.build_configurations.each do |config|
      config.build_settings['ENABLE_USER_SCRIPT_SANDBOXING'] = 'NO'
    end
  end
  installer.aggregate_targets.each do |t|
    t.user_project.native_targets.each do |nt|
      nt.build_configurations.each do |config|
        config.build_settings['ENABLE_USER_SCRIPT_SANDBOXING'] = 'NO'
      end
    end
  end
end

// swift-tools-version: 6.0
import PackageDescription

let package = Package(
    name: "YourApp",
    platforms: [
        .iOS(.v15)
    ],
    dependencies: [
        .package(url: "https://github.com/Telr-PG/telr-sdk-ios.git", .upToNextMajor(from: "4.4.1"))
    ],
    targets: [
        .target(
            name: "YourApp",
            dependencies: [
                .product(name: "MobilePaymentSDK", package: "telr-sdk-ios")
            ]
        )
    ]
)

import SwiftUI
import MobilePaymentSDK

struct PaymentView: View {
    @State private var showPayment = false
    private let paymentSDK = PaymentSDK()
    
    var body: some View {
        VStack {
            Button("Pay Now") {
                showPayment = true
            }
        }
        .fullScreenCover(isPresented: $showPayment) {
            paymentSDK.paymentView(
                tokenURL: "https://api.telr.com/token",
                orderURL: "https://api.telr.com/order/123",
                onFinish: { response in
                    if response.success {
                        print("Payment successful: \(response.message)")
                    } else {
                        print("Payment failed: \(response.message)")
                    }
                    showPayment = false
                }
            )
        }
    }
}

import UIKit
import MobilePaymentSDK

class PaymentViewController: UIViewController {
    private let paymentSDK = PaymentSDK()
    
    func showPayment() {
        let paymentView = paymentSDK.paymentView(
            tokenURL: "https://api.telr.com/token",
            orderURL: "https://api.telr.com/order/123",
            onFinish: { response in
                DispatchQueue.main.async {
                    if response.success {
                        self.showAlert(title: "Success", message: response.message)
                    } else {
                        self.showAlert(title: "Error", message: response.message)
                    }
                }
            }
        )
        
        let hostingController = UIHostingController(rootView: paymentView)
        present(hostingController, animated: true)
    }
    
    private func showAlert(title: String, message: String) {
        let alert = UIAlertController(title: title, message: message, preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        present(alert, animated: true)
    }
}

let configuration = PaymentSDKConfiguration(
    debugLoggingEnabled: false,
    preferredLanguageCode: "en"
)

let paymentSDK = PaymentSDK(configuration: configuration)

let configuration = PaymentSDKConfiguration.builder()
    .withDebugLoggingEnabled(true) // Enable for development
    .withPreferredLanguageCode("ar") // Arabic support
    .build()

let paymentSDK = PaymentSDK(configuration: configuration)

// Update configuration at runtime
let newConfig = PaymentSDKConfiguration.builder()
    .withPreferredLanguageCode("ar")
    .build()

paymentSDK.updateConfiguration(newConfig)

let config = PaymentSDKConfiguration.builder()
    .withColors(SDKColorConfig(
        light: SDKColors(
            primary: "#0057FF",              // Pay button, selected tick, checkbox, links, back chevron
            background: "#FFFFFF",           // payment sheet / surface background
            textLabel: "#101828",            // primary text (merchant name, amount, method names, card details)
            border: "#E4E7EC",               // field/card outlines, dividers
            buttonText: "#FFFFFF",           // text drawn on the Pay button
            textFieldText: "#101828",        // text the user types into inputs
            textFieldBackground: "#F2F4F7"   // input field fill
        ),
        dark: SDKColors(
            primary: "#4C8DFF",
            background: "#101828",
            textLabel: "#F2F4F7",
            border: "#344054",
            buttonText: "#FFFFFF",
            textFieldText: "#F2F4F7",
            textFieldBackground: "#1D2939"
        )
    ))
    .build()

let paymentSDK = PaymentSDK(configuration: config)

let configuration = PaymentSDKConfiguration.builder()
    .withApplePayMerchantIdentifier("merchant.com.yourcompany.yourapp")
    .build()

let paymentSDK = PaymentSDK(configuration: configuration)

let configuration = PaymentSDKConfiguration.builder()
    .withApplePayMerchantIdentifier("merchant.com.yourcompany.yourapp")
    .withApplePayButtonType(.buy)
    .withApplePayButtonStyle(.black)
    .build()

// Called from your own Apple Pay button's action:
paymentSDK.payWithApplePay(
    tokenURL: checkoutTokenURL,
    orderURL: checkoutOrderURL
) { response in
    if response.success {
        // response.orderRef        — Telr order id (for server-side verification)
        // response.transactionRef  — transaction reference
    } else if response.errorCode == "cancelled" {
        // user cancelled the Apple Pay sheet
    } else {
        // show response.message
    }
}

paymentSDK.addCardView(
    tokenURL: addCardTokenURL,
    orderURL: addCardOrderURL
) { response in
    if response.success {
        // response.ref — payment reference from the VERIFY transaction (store for saved-card payments)
        // response.maskedName — masked cardholder name (store for SDKSavedCardInput)
        // response.savedCards — refreshed saved cards list
    } else {
        // show response.message
    }
}

let savedCard = SDKSavedCardInput(
    token: "card_token_here",
    maskedCard: "**** 1111",   // masked card from add-card flow (e.g. SavedCard.maskedCard)
    expiry: "12/30",
    scheme: "VISA",
    maskedName: "J*** D**"    // optional, shown on the sheet
)

paymentSDK.payWithSavedCardView(
    tokenURL: checkoutTokenURL,
    orderURL: checkoutOrderURL,
    savedCard: savedCard
) { response in
    if response.success {
        // payment complete
    } else {
        // show response.message
    }
}

paymentSDK.payWithCardView(
    tokenURL: checkoutTokenURL,
    orderURL: checkoutOrderURL
) { response in
    if response.success {
        // payment complete
        // response.orderRef / response.transactionRef — references for reconciliation
        // response.savedCard — non-nil if the user ticked "Save my card details";
        //   store it to reuse the card via payWithSavedCardView
    } else {
        // show response.message
    }
}

public struct SDKPaymentResponse {
    public let success: Bool
    public let message: String
    public let errorCode: String?
    public let orderRef: String?             // Telr order reference (on success)
    public let transactionRef: String?       // transaction/payment reference (on success)
    public let savedCard: SDKSavedCardInput?  // set when the user opts to save the card during pay-with-card
}

public struct SDKAddCardResponse {
    public let success: Bool
    public let message: String
    public let errorCode: String?
    public let ref: String?              // payment reference from the VERIFY transaction
    public let savedCards: [SavedCard]?
    public let maskedName: String?       // e.g. "J*** D**"
}

.onFinish { response in
    if !response.success {
        switch response.errorCode {
        case "timeout":
            // Handle session timeout
            break
        case let code?:
            // Handle gateway/backend specific codes
            print("Payment failed with code: \(code)")
            break
        default:
            // Network/server failures may be provided as message text
            print("Payment failed: \(response.message)")
            print("Error code: \(response.errorCode ?? "Unknown")")
            break
        }
    }
}

.onFinish { response in
    if !response.success {
        // Payment failed
        print("Payment failed: \(response.message)")
        print("Error code: \(response.errorCode ?? "Unknown")")
        
        // Show user-friendly error message
        showErrorAlert(message: response.message)
    } else {
        // Payment successful
        print("Payment successful: \(response.message)")
        showSuccessAlert(message: response.message)
    }
}

let paymentSDK = PaymentSDK() // Uses system language

let configuration = PaymentSDKConfiguration.builder()
    .withPreferredLanguageCode("ar") // Force Arabic
    .build()

let paymentSDK = PaymentSDK(configuration: configuration)

# Clean derived data
rm -rf ~/Library/Developer/Xcode/DerivedData/*

# Clean pod cache
pod cache clean --all

# Reinstall pods
pod deintegrate
pod install

# Ensure XCFrameworks are used
carthage update --use-xcframeworks --platform iOS

# Verify framework is embedded
# Check project settings > Frameworks, Libraries, and Embedded Content

let configuration = PaymentSDKConfiguration.builder()
    .withDebugLoggingEnabled(true)
    .build()

let paymentSDK = PaymentSDK(configuration: configuration)

public class PaymentSDK {
    public init(configuration: PaymentSDKConfiguration = PaymentSDKConfiguration())
    public func updateConfiguration(_ configuration: PaymentSDKConfiguration)
    
    @MainActor
    public func paymentView(
        tokenURL: String,
        orderURL: String,
        onFinish: @escaping (SDKPaymentResponse) -> Void
    ) -> some View

    @MainActor
    public func addCardView(
        tokenURL: String,
        orderURL: String,
        onFinish: @escaping (SDKAddCardResponse) -> Void
    ) -> some View

    @MainActor
    public func payWithCardView(
        tokenURL: String,
        orderURL: String,
        onFinish: @escaping (SDKPaymentResponse) -> Void
    ) -> some View

    @MainActor
    public func payWithSavedCardView(
        tokenURL: String,
        orderURL: String,
        savedCard: SDKSavedCardInput,
        onFinish: @escaping (SDKPaymentResponse) -> Void
    ) -> some View

    // Runs Apple Pay with no SDK UI (for merchant-owned Apple Pay buttons).
    // Reports the final result only; orderRef/transactionRef populated on success.
    @MainActor
    public func payWithApplePay(
        tokenURL: String,
        orderURL: String,
        onFinish: @escaping (SDKPaymentResponse) -> Void
    )
}

public struct PaymentSDKConfiguration {
    public let debugLoggingEnabled: Bool
    public let preferredLanguageCode: String?
    
    public static func builder() -> Builder
    public init(builder configure: (inout Builder) -> Void)
}

public struct SDKPaymentResponse {
    public let success: Bool
    public let message: String
    public let errorCode: String?
    public let orderRef: String?             // Telr order reference (on success)
    public let transactionRef: String?       // transaction/payment reference (on success)
    public let savedCard: SDKSavedCardInput?  // set when the user opts to save the card during pay-with-card

    public static func success(message: String) -> SDKPaymentResponse
    public static func failure(message: String, errorCode: String?) -> SDKPaymentResponse
}

public struct SDKColorConfig {
    public let light: SDKColors?
    public let dark: SDKColors?
    public init(light: SDKColors? = nil, dark: SDKColors? = nil)
}

public struct SDKColors {
    public let primary: String?             // Pay button, selected tick, checkbox, links, back chevron
    public let background: String?          // payment sheet background
    public let textLabel: String?           // primary text
    public let border: String?              // field/card outlines, dividers
    public let buttonText: String?          // text on the Pay button
    public let textFieldText: String?       // text typed into inputs (also derives placeholder/hint)
    public let textFieldBackground: String? // input field fill
}

public struct SDKSavedCardInput {
    public let token: String        // card token from add-card flow
    public let maskedCard: String   // e.g. "**** 1111"
    public let expiry: String       // e.g. "12/30"
    public let scheme: String       // e.g. "VISA"
    public let maskedName: String?  // optional, e.g. "J*** D**"
}

public struct SDKAddCardResponse {
    public let success: Bool
    public let message: String
    public let errorCode: String?
    public let ref: String?           // payment reference from the VERIFY transaction
    public let savedCards: [SavedCard]?
    public let maskedName: String?    // e.g. "J*** D**", use for SDKSavedCardInput
}

public struct Order {
    public let ref: String
    public let amount: Amount
    public let status: OrderStatus
    public let allowedPaymentMethods: [PaymentMethod]?
    public let _links: OrderLinks?
    public let payments: [PaymentResponse]?
}

public struct Amount {
    public let value: String
    public let currency: String?
}

public struct PaymentMethod {
    public let schemes: [String]          // e.g. ["VISA", "MASTERCARD"]
    public let type: PaymentMethodType    // .card, .applePay, .tabby, .stcBank
}

public enum PaymentMethodType: String {
    case card = "CARD"
    case applePay = "APPLE_PAY"
    case tabby = "TABBY"
    case tamara = "TAMARA"
    case stcBank = "STC_BANK"
    case clickToPay = "CLICK_TO_PAY"
}

public enum OrderStatus: String {
    case pending = "PENDING"
    case authorised = "AUTHORISED"
    case paid = "PAID"
    case cancelled = "CANCELLED"
    case declined = "DECLINED"
}