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

Приложение CloudPayments iOS SDK Demo демонстрирует работу SDK для платформы iOS (iPhone, iPad, iPod) с платежным шлюзом CloudPayments

Полная информация об использовании на сайте http://cloudpayments.ru/docs/mobileSDK

##Установка

Сразу после git clone https://github.com/cloudpayments/CloudPayments_iOSSDKDemo.git необходимо инициализировать и скачать подмодули git. Для этого переходим в папку с проектом

cd CloudPayments_iOSSDKDemo

а уже там:

git submodule update --init CloudPaymentsAPIDemo/Libraries/AFNetworking/
git submodule update --init CloudPaymentsAPIDemo/Libraries/SVProgressHUD/

##Описание работы приложения с SDK CloudPayments

SDK CloudPayments (CloudPaymentsAPI.framework) позволяет

• проводить проверку карточного номера на корректность

	[CPService isCardNumberValid: cardNumberString];

• определять тип платежной системы

	[CPService cardTypeFromCardNumber:cardNumberString];

• шифровать карточные данные и создавать криптограмму для отправки на сервер

	CPService *_apiService = [[CPService alloc] init];
	NSString *cryptogramPacket = [_apiService makeCardCryptogramPacket:self.cardNumberString
															andExpDate:self.cardExpirationDateString
																andCVV:self.cardCVVString
													  andStorePublicID:_apiPublicID];

Пример использования SDK и API CloudPayments дан в файле CPViewController

Демо-приложение представляет из себя форму для ввода карточных данных и обработчик запросов к API CloudPayments.

Перед началом оплаты необходимо определить переменные (их значения можно взять из личного кабинета):

NSString *_apiPublicID = @"pk_0000000000000000000000";
NSString *_apiSecret = @"00000000000000000000000000000000";

После этого необходимо инициализировать SDK CloudPayments:

CPService *_apiService = [[CPService alloc] init];

Вдальнейшем _apiService используется для создания пакета криптограммы.

##Проведение оплаты

Проведение оплаты описано в методе makePaymentAction. Пояснения к описанию метода.

1. В демо-приложении словарь paramsDictionary содержит только обязательные параметры для запроса. Список всех возможных параметров представлен http://cloudpayments.ru/Docs/Api#payWithCrypto
2. Метод для проведения 3DS-авторизации -(void) make3DSPaymentWithAcsURLString: (NSString *) acsUrlString andPaReqString: (NSString *) paReqString andTransactionIdString: (NSString *) transactionIdString
3. Обработка ответа банка происходит в -(BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType
4. Метод для проведения окончания 3DS-авторизации -(void) complete3DSPaymentWithPaResString: (NSString *) paResString andTransactionIdString: (NSString *) transactionIdString

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

• Необходимо отключить ATS для всех доменов, кроме вашего сервера. Это необходимо для корректной работы шифрования при использовании 3ds-авторизации платежа. Сделать это можно в Info.plist файле проекта. О дополнительных настройках можно узнать тут http://habrahabr.ru/company/e-Legion/blog/265767/

	<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSAllowsArbitraryLoads</key>
		<true/>
		<key>NSExceptionDomains</key>
		<dict>
			<key>your.api.server.com</key>
			<dict>
				<key>NSExceptionRequiresForwardSecrecy</key>
				<false/>
				<key>NSExceptionAllowsInsecureHTTPLoads</key>
				<false/>
			</dict>
		</dict>
	</dict>

• Наша библиотека пока не скомпилирована с использованием технологии App Thinning. Поэтому пока мы исправляем это, в вашем проекте генерацию биткода необходимо отключить Проект -> Build Settings -> Enable Bitcode -> No

• Из-за ошибки генерации правильных заголовков в iOS9 на физическом устройстве может происходить возврат 500-й ошибки от сервера 3DS-авторизации (например, при работе с тестовым сервером https://demo.cloudpayments.ru/acs). Для предотвращения этого небходимо вручную выставлять корректное значение для HTTP-заголовка Accept-Language:

[request setValue:@"ru;q=1, en;q=0.9" forHTTPHeaderField:@"Accept-Language"];

В симуляторе данная ошибка не возникает

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

• При тестировании на симуляторе ios10, возникает ошибка EXC_BAD_ACCESS. Она происходит по причине неправильной обработки загрузки ключей в симуляторе ios10.

См. тут https://openradar.appspot.com/27422249 и https://forums.developer.apple.com/message/179846

Простое решение - для тестирования включить Keychain Sharing.

С включением этой опции приложение в симуляторе начинает работать корректно.

На реальных устройствах данная ошибка не возникает.

Ключевые моменты

1. Библиотека поставляется в виде .framework, который скомпилирован для трех текущих архитектур процессора armv7, armv7s, arm64 и i385, x86_64. Таким образом тестировать можно в iPhone Simulator. Библиотека может работать только в версиях iOS 6.0+. iOS 8 также поддерживается.
2. В демо-проекте для сетевого взаимодействия используется библиотека AFNetworing (см. https://github.com/AFNetworking/AFNetworking). Все права на код этой библиотеки принадлежат авторам библиотеки.
3. В демо-проекте для показа экранных уведомлений используется библиотека SVProgressHUD (см. https://github.com/TransitApp/SVProgressHUD). Все права на код этой библиотеки принадлежат авторам библиотеки.