iOS SDK Integration Guide

              
              import MTVerify

// 1. Enable debug mode (optional, recommended during development)
MTVerifySDK.setDebug(true)

// 2. Initialize the SDK
MTVerifySDK.setup(appKey: "your_app_key", environment: .production) { result in
    if result.isSuccess {
        print("SDK initialization succeeded")
    } else {
        print("SDK initialization failed: \(result.message)")
    }
}

// 3. Check coverage
MTVerifySDK.checkCoverage(phoneNumber: "6281234567890") { result in
    if result.isSuccess && result.isAvailable {
        print("Authentication service available, carrier: \(result.operatorCode ?? "")")
    }
}

// 4. Initiate authentication
MTVerifySDK.startAuthentication(phoneNumber: "6281234567890") { result in
    if result.isSuccess {
        print("Authentication succeeded, Token: \(result.token ?? "")")
    }
}

            

              
              @import MTVerify;

// 1. Enable debug mode (optional)
[MTVerifySDK setDebug:YES];

// 2. Initialize the SDK
[MTVerifySDK setupWithAppKey:@"your_app_key" 
                 environment:MTEnvironmentProduction 
                  completion:^(MTSetupResult *result) {
    if (result.isSuccess) {
        NSLog(@"SDK initialization succeeded");
    } else {
        NSLog(@"SDK initialization failed: %@", result.message);
    }
}];

// 3. Check coverage
[MTVerifySDK checkCoverageWithPhoneNumber:@"6281234567890" 
                               completion:^(MTCoverageResult *result) {
    if (result.isSuccess && result.isAvailable) {
        NSLog(@"Authentication service available, carrier: %@", result.operatorCode);
    }
}];

// 4. Initiate authentication
[MTVerifySDK startAuthenticationWithPhoneNumber:@"6281234567890" 
                                     completion:^(MTAuthResult *result) {
    if (result.isSuccess) {
        NSLog(@"Authentication succeeded, Token: %@", result.token);
    }
}];

            

              
              static func setDebug(_ enabled: Bool)

            

              
              static func isDebug() -> Bool

            

              
              static func setup(appKey: String,
                  environment: MTEnvironment = .production,
                  completion: @escaping (MTSetupResult) -> Void)

            

              
              static func checkCoverage(phoneNumber: String,
                          completion: @escaping (MTCoverageResult) -> Void)

            

              
              static func startAuthentication(phoneNumber: String,
                                completion: @escaping (MTAuthResult) -> Void)

            

              
              @objc public enum MTEnvironment: Int {
    case sandbox = 0      // Sandbox environment (testing)
    case production = 1   // Production environment
}

            

              
              @objcMembers
public class MTSetupResult: NSObject {
    /// Result code (0 means success, others mean failure)
    public let code: Int
    
    /// Description message
    public let message: String
    
    /// Whether successful
    public var isSuccess: Bool { return code == 0 }
}

            

              
              @objcMembers
public class MTCoverageResult: NSObject {
    /// Result code (0 means success, others mean failure)
    public let code: Int
    
    /// Description message
    public let message: String
    
    /// Whether available
    public let isAvailable: Bool
    
    /// Carrier code
    public let operatorCode: String?
    
    /// Whether successful
    public var isSuccess: Bool { return code == 0 }
}

            

              
              @objcMembers
public class MTAuthResult: NSObject {
    /// Result code (0 means success, others mean failure)
    public let code: Int
    
    /// Description message
    public let message: String
    
    /// Authentication token (used for backend verification)
    public let token: String?
    
    /// Whether successful
    public var isSuccess: Bool { return code == 0 }
}

            

              
              import UIKit
import MTVerify

class ViewController: UIViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Enable debug mode
        MTVerifySDK.setDebug(true)
        
        // Initialize the SDK
        initializeSDK()
    }
    
    // MARK: - SDK Initialization
    
    private func initializeSDK() {
        MTVerifySDK.setup(
            appKey: "your_app_key",
            environment: .production
        ) { [weak self] result in
            if result.isSuccess {
                print("✅ SDK initialization succeeded")
                print("SDK version: \(MTVerifySDK.version)")
                print("Initialized: \(MTVerifySDK.isInitialized)")
            } else {
                print("❌ SDK initialization failed: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - Check Coverage
    
    func checkCoverage(phoneNumber: String) {
        // Check whether the SDK is initialized
        guard MTVerifySDK.isInitialized else {
            print("⚠️ SDK not initialized")
            return
        }
        
        MTVerifySDK.checkCoverage(phoneNumber: phoneNumber) { result in
            if result.isSuccess {
                if result.isAvailable {
                    print("✅ Service available")
                    print("Carrier: \(result.operatorCode ?? "Unknown")")
                } else {
                    print("⚠️ The current environment does not support the authentication service")
                }
            } else {
                print("❌ Check failed: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - Initiate Authentication
    
    func authenticate(phoneNumber: String) {
        // Check whether the SDK is initialized
        guard MTVerifySDK.isInitialized else {
            print("⚠️ SDK not initialized")
            return
        }
        
        MTVerifySDK.startAuthentication(phoneNumber: phoneNumber) { result in
            if result.isSuccess {
                print("✅ Authentication succeeded")
                print("Token: \(result.token ?? "")")
                
                // TODO: Send the token to the backend for verification
                self.verifyTokenOnServer(token: result.token ?? "")
                
            } else {
                print("❌ Authentication failed: \(result.message) (code: \(result.code))")
            }
        }
    }
    
    // MARK: - Backend Verification
    
    private func verifyTokenOnServer(token: String) {
        // Send the token to your backend server for verification
        // The backend uses the token to call the MTVerify server API to verify the phone number
    }
}