Cloudtips SDK позволяет интегрировать прием чаевых в мобильные приложение для платформы iOS.
Для работы Cloudtips SDK необходим iOS версии 11.0 и выше.
Для подключения SDK мы рекомендуем использовать Cocoa Pods. Для корректной работы понадобится Cloudpayments SDK. Добавьте в файл Podfile зависимости:
pod 'Cloudtips', :git => "https://github.com/cloudpayments/CloudTips-SDK-iOS", :branch => "master"
pod 'Cloudpayments', :git => "https://github.com/cloudpayments/CloudPayments-SDK-iOS", :branch => "master"
pod 'CloudpaymentsNetworking', :git => "https://github.com/cloudpayments/CloudPayments-SDK-iOS", :branch => "master"
- demo - Пример реализации приложения с использованием SDK
- sdk - Исходный код SDK
В AppDelegate.swift
вашего проекта в методе application(_:didFinishLaunchingWithOptions:)
осуществите инициализацию SDK:
Если в проекте используется YandexPay, то для настройки YandexLoginSDK используйте пункты 1-3 инструкции.
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
do {
// Инициализируйте SDK
// Если в проекте используется YandexPay, то необходимо указать соответсвующие параметры:
// yandexPayAppId - ваш appId, который вы получили при настройке YandexLoginSDK
// sandboxMode - режим песочницы YandexPay
let yaAppId = "..."
try CloudtipsSDK.initialize(yandexPayAppId: yaAppId, sandboxMode: false)
} catch {
fatalError("Unable to initialize CloudtipsSDK.")
}
// Инициализируйте UIWindow и ViewController
let controller = ViewController()
let window = UIWindow(frame: UIScreen.main.bounds)
window.rootViewController = controller
window.makeKeyAndVisible()
self.window = window
return true
}
Также в AppDelegate.swift
вашего проекта добавьте нотификацию CloudtipsSDK
о событиях жизенного цикла приложения:
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
CloudtipsSDK.instance.applicationDidReceiveUserActivity(userActivity)
return true
}
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
CloudtipsSDK.instance.applicationDidReceiveOpen(url, sourceApplication: options[.sourceApplication] as? String)
return true
}
func applicationWillEnterForeground(_ application: UIApplication) {
CloudtipsSDK.instance.applicationWillEnterForeground()
}
func applicationDidBecomeActive(_ application: UIApplication) {
CloudtipsSDK.instance.applicationDidBecomeActive()
}
- Создайте объект TipsConfiguration, передайте в него номер телефона в формате +7********** и имя пользователя (если пользователя с таким номером телефона нет в системе Cloudtips, то будет зарегистрирован новый пользователь с этим именем)
Если вы являетесь партнером CloudTips, передайте в конфигурацию id партнера
let configuration = TipsConfiguration.init(phoneNumber: "+79001234567", userName: "Walter WWhite", partner: "partner_id")
//или
let configuration = TipsConfiguration.init(phoneNumber: "+" + text, userName: "Cloudtips demo user", partner: "ctdemo", testMode: true) //Если необходимо включить режим тестирования
- Для возможности оплаты с Apple Pay передайте в конфигурацию ваш Apple Pay merchant id.
configuration.setApplePayMerchantId("merchant.ru.cloudpayments")
- Для изменения цвета navigation бара и цвета крестика задайте значения
configuration.navigationBackgroundColor = .white
configuration.navigationTintColor = .blue
- Вызовите TipsViewController внутри вашего контроллера
TipsViewController.present(with: configuration, from: self)
По возникающим вопросам техничечкого характера обращайтесь на support@cloudpayments.ru