Pulichev / tisdk-ios

Tinkoff Insurance SDK for iOS

Tinkoff Insurance SDK for iOS

Позволяет клиенту оформить ОСАГО или КАСКО за 5 минут!

Установка

TISDK поддерживает версии iOS 9, 10, 11 & 12.

1. Установите SDK в проект следующими способами

Cocoapods

Добавьте в ваш Podfile и вызовите pod install

pod 'TISDK'

Carhage

1. Добавьте github "TinkoffCreditSystems/tisdk-ios" в ваш Cartfile.
2. Вызовите carthage update в терминале.
3. Перейдите во вкладку "General Settings" в вашем проекте . Перенесите TISDK.framework из папки Carthage/Build/iOS в секцию "Embedded Binaries". Проверьте, что стоит флаг “Copy items if needed”.

Manual установка

1. Скачайте TISDK for iOS и распакуйте архив.
2. Перейдите во вкладку "General Settings" в вашем проекте . Перенесите TISDK.framework из папки Carthage/Build/iOS в секцию "Embedded Binaries". Проверьте, что стоит флаг “Copy items if needed”.
3. Добавьте новый "Run Script Phase" в таргет вашего проекта во вкладке "Build Phases" и вставьте следующий скрипт: bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/TISDK.framework/strip-frameworks.sh" Данный шаг важен для ворк-эраунда App Store submission bug при архивировании универсального фреймворка.

2. Обновите Info.plist

1. Конфигурация SDK

<key>TISDK</key>
<dict>
<key>environment</key>
<string>$(TISDK_ENVIRONMENT)</string>
<key>origin</key>
<string>origin</string>
</dict>

Ключ	Описание
origin	Идентификатор вашего приложения
environment	это текущее окружение (staging или production). В соответствии с примером $(TISDK_ENVIRONMENT) - это User-Define переменная из Build Settings проекта.

2. Для корректной работы SDK требуются permissions для использования камеры и фото-библиотеки

<key>NSCameraUsageDescription</key>
<string>Разрешите пожалуйста доступ для загрузки документов</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Разрешите пожалуйста доступ для загрузки документов</string>

3. Настройте окружение для конфигурации SDK

Для этого нужно добавить User-Define переменную с именем TISDK_ENVIRONMENT, которую вы использовали при добавлении в Info.plist в пункте 2.1, если брать из примера. Затем определить окружение для конкретной конфигурации проекта.

Например:

Debug - production
DebugQA - staging
Release - production
ReleaseQA - staging

Использование

Основное взаимодействие с SDK происходит непосредственно с помощью класса TIInsurance.

Оформление ОСАГО

Для открытия формы для расчета и покупки ОСАГО предназначен следующий метод:

- (void)buyOSAGOInViewController:(UIViewController *)viewController completionBlock:(void (^ _Nullable)(TIPolicyInfo *))completionBlock;

Параметр	Описание
viewController	UIViewController, который будет презентовать форму оформления полиса
completionBlock	При успешной покупке полиса, в блоке будет возвращена информация об оформленном полисе

Оформление КАСКО

Для открытия формы для короткой заявки на КАСКО предназначен следующий метод:

- (void)buyKACKOInViewController:(UIViewController *)viewController;

Параметр	Описание
viewController	UIViewController, который будет презентовать форму оформления полиса

Поддержка

• По вопросам партнерства просьба обращаться на [e-mail]
• Дефекты и проблемы с интеграцией и работой SDK просьба заводить тикеты в issues