{"id":19936308,"url":"https://github.com/toss/toss-sdk-ios","last_synced_at":"2026-03-10T02:05:53.610Z","repository":{"id":192719129,"uuid":"685431050","full_name":"toss/toss-sdk-ios","owner":"toss","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-01T08:01:44.000Z","size":15,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-03T13:40:25.923Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-31T08:03:13.000Z","updated_at":"2025-04-25T16:40:44.000Z","dependencies_parsed_at":"2023-12-06T06:28:11.179Z","dependency_job_id":"d62bb639-2f23-4dac-837a-bb3de90f2861","html_url":"https://github.com/toss/toss-sdk-ios","commit_stats":null,"previous_names":["toss/toss-sdk-ios"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/toss/toss-sdk-ios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toss%2Ftoss-sdk-ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toss%2Ftoss-sdk-ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toss%2Ftoss-sdk-ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toss%2Ftoss-sdk-ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toss","download_url":"https://codeload.github.com/toss/toss-sdk-ios/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toss%2Ftoss-sdk-ios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30322638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T23:25:09.767Z","updated_at":"2026-03-10T02:05:48.602Z","avatar_url":"https://github.com/toss.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 토스 iOS SDK\n토스 iOS SDK를 위한 모노레포입니다.\n\n## 설치하기\n### 요구 사항\n토스 iOS SDK를 설치하기 전에 최소 요구 사항을 확인하세요.\n\n- iOS 13.0 이상\n- Swift 5.7 이상\n\n### Swift Package Manager(SPM)로 설치하기\nXcode에서 아래 토스 iOS SDK의 레포지토리(Repository) URL를 검색 후 추가하세요.\n```\nhttps://github.com/toss/toss-sdk-ios.git\n```\n\n## 사전 설정\n### 앱 실행 허용 목록 설정\n토스앱을 열 수 있는지 확인할 수 있게 `Info.plist` 파일에 Array 타입 키(Key)인 `LSApplicationQueriesSchemes`를 추가하고, 해당 키의 [Item]으로 `\"supertoss\"`를 추가하세요.\n추가하지 않으면 토스앱이 열리지 않아요.\n\n### URL Scheme 설정\n로그인 후 서비스 앱으로 돌아오기 위해, `[Info] \u003e [URL Types] \u003e [URL Schemes]`에 `toss${APP_KEY}`를 추가하세요.\n예를 들어 앱 키가 \"AB12CD34EF56GH78\"이라면 [URL Schemes]에 \"tossAB12CD34EF56GH78\"를 입력하세요.\n\n## 시작하기\n### SDK 초기화\n`AppDelegate.swift`에 앱 키를 사용해 SDK를 초기화하는 과정이 필요해요. \n```swift\nimport TossFoundation\n\nfunc application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -\u003e Bool {\n    ...\n    TossSDK.shared.initSDK(appKey: \"${APP_KEY}\")\n    ...\n}\n```\n\n### 토스 로그인 \n토스로 로그인을 하기 위한 설정이에요.\n\n#### 로그인 완료 처리를 위한 설정\n사용자가 토스앱에서 [동의하기] 버튼 또는 [닫기] 버튼을 누르면 토스앱에서 서비스앱으로 이동해요.\n서비스앱으로 돌아왔을 때 정상적으로 완료하기 위해 `AppDelegate.swift` 또는 `SceneDelegate.swift` 파일에 `handleOpenUrl(_:)`을 추가하세요.\n\nAppDelegate.swift: \n```swift\nimport TossLogin\n...\n\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n    ...\n    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -\u003e Bool {\n        if TossLoginController.shared.isCallbackURL(url) {\n            return TossLoginController.shared.handleOpenUrl(url)\n        }\n\n        return false\n    }\n    ...\n}\n```\n\nSceneDelegate.swift:\n```swift\nimport TossLogin\n...\n\nclass SceneDelegate: UIResponder, UIWindowSceneDelegate {\n    ...\n    func scene(_ scene: UIScene, openURLContexts URLContexts: Set\u003cUIOpenURLContext\u003e) {\n        if let url = URLContexts.first?.url, TossLoginController.shared.isCallbackURL(url) {\n            _ = TossLoginController.shared.handleOpenUrl(url)\n        }\n    }\n    ...\n}\n```\n\n##### 로그인 요청\n토스로 로그인을 하기 위해, `login(policy:completion:)`을 호출하세요.\n`isLoginAvailable` 변수로 토스앱 실행 가능 여부를 확인할 수 있어요. \n\u003e 사전 설정의 `앱 실행 허용 목록 설정`을 하지 않으면 토스앱이 설치되어 있어도, 토스앱을 실행할 수 없어요.\n\n토스앱이 설치되어있지 않아 실행이 불가능하면, `moveToBridgePageForNoApp()`를 호출해 앱 설치를 유도하는 웹화면으로 이동할 수 있어요.\n\n```swift\nguard TossLoginController.shared.isLoginAvailable else {\n    TossLoginController.shared.moveToBridgePageForNoApp()\n    return\n}\n\nTossLoginController.shared.login(completion: { result in\n    switch result {\n        case let .success(authCode):\n            // authCode 를 통해 accessToken을 발급받으세요.\n            break\n                    \n        case let .error(error):\n            print(\"error code : \\(error.code), error message: \\(error.message)\")\n\n        case .cancelled:\n            // 사용자가 취소했어요.\n            break\n    }\n})\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoss%2Ftoss-sdk-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoss%2Ftoss-sdk-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoss%2Ftoss-sdk-ios/lists"}