«Твои платежи», SDK для IOS

НКО «Твои Платежи» - платёжная система для сайтов, платформ, игр и приложений.

Тестовое приложение

Для запуска тестового приложения нужно:

-Клонировать репозиторий

-Запустить терминал

-Перейти в скаченную дирректорию (в папку Example)

-Выполнить команду pod install

Скриншоты Тестового приложения

Добавление библиотеки в проект:

Библиотека IOS_SDK_PAYU доступна через систему управления зависимостями CocoaPods.

-Добавьте строчку в Podfile вашего приложения

pod "IOS_SDK_PAYU"

-Выполните команду в терминале pod update

-Подключаем библиотеку #import "PAYU_SDK.h"

Описание API:

LU - класс для работы с протоколом Live Update

Инициализируем платежный класс

LU *lu=[[LU alloc] initWithSecretKey:@"e5|S|X~0@l10_?R4b8|1" merchant:@"ipolhtst" orderRef:@"3886786" orderDate:@"2016-11-21 10:51:58"];
// необязательные параметры
lu.BILL_FNAME=@"Max";
lu.BILL_LNAME=@"Mel";
lu.BILL_EMAIL=@"ALoon12@gmail.com";
lu.BILL_PHONE=@"+79261122334";
lu.BILL_COUNTRYCODE=CountryCodeRU;
lu.LANGUAGE=LanguageTypeRU;
lu.DISCOUNT=[NSNumber numberWithFloat:200.1];
lu.PAY_METHOD=LUPayMethodTypeCCVISAMC;
lu.ORDER_SHIPPING=[NSNumber numberWithInt:1200];
lu.PRICES_CURRENCY=USD;
lu.ORDER_TIMEOUT=[NSNumber numberWithInt:200];
lu.TIMEOUT_URL=@"http://yandex.ru";
lu.TESTORDER=NO;
lu.Debug=YES;

Создаем продукт (товар)

LUProduct *product=[[LUProduct alloc] initLUProductWithName:@"test" code:@"123" price:[NSNumber numberWithInt:50] qty:10 vat:13 ];
// необязательные параметры
product.pgGroup=@"2313123";
product.pinfo=@"Сбербанк 132132321";

Описание LUProduct

Добавляем созданный продукт (товар)

NSError *error;
[lu addProduct:product error:&error];

Коды ошибок LUErrorInputData

Создаем форму пользователя

NSError *error;
[self.webView loadRequest: [lu getLURequstWitherror:&error]];

Коды ошибок LUErrorInputData при добавлении продуктов/ товаров

Cохраняем номер заказа, для “отмены транзакции” или “подтверждения транзакции”

- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType{
NSLog(@"%@",request.URL.absoluteString);

NSString *string = request.URL.absoluteString;
//отлавливаем переход на нашу ссылку
if ([string rangeOfString:@"?result=0"].location != NSNotFound) {

NSArray *array = [request.URL.absoluteString componentsSeparatedByString:@"&"];

//сохраняем номер заказа, он нам понадобится для "отмены транзакции" и для "подтверждения транзакци"
self.payrefno = [[array objectAtIndex:3] stringByReplacingOccurrencesOfString:@"payrefno=" withString:@""];

UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:[NSString stringWithFormat:@"Оплата прошла успешно payrefno=%@",self.payrefno] delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

}

return YES;
}

ALU - класс для работы с протоколом ALUv3 (Automatic Live Update)

Инициализируем платежный класс ALU

ALU *alu = [[ALU alloc] initWithSecretKey:@"e5|S|X~0@l10_?R4b8|1" merchant:@"ipolhtst" orderRef:@"3886786" orderDate:@"2016-11-21 10:51:58"]; 

alu.ORDER_SHIPPING=[NSNumber numberWithInt:1007];     //стоимость доставки    
alu.PRICES_CURRENCY=RUB; 
alu.LANGUAGE=LanguageTypeRU;
alu.PAY_METHOD=ALUPayMethodTypeCCVISAMC;
alu.CLIENT_IP=@"192.168.0.1";
alu.TESTORDER=NO;

###Поля заказа

###Добавляем информация о продукте

NSError *productError;
ALUProduct *product=[[ALUProduct alloc] initALUProductWithName:@"Phone" code:@"12" price:[NSNumber numberWithInt:1000] qty:1];
NSError *productError;
product.pinfo=@"Носки хлопковые";
product.ver=@"1.0.0";
[alu addProduct:product error:&productError];

Описание ALUProduct

Коды ошибок ALUErrorInputData при добавлении продуктов/ товаров

###Добавляем реквизиты покупателя

alu.BIllCLIENTINFO=[[ALUBillClientInfo alloc] initWithFNAME:@"Mel" LNAME:@"Maxim" EMAIL:@"lolo@gmail.com" PHONE:@"7-926-177-77-22" COUNTRYCODE:CountryCodeRU];

Описание ALUBillClientInfo

###Добавляем реквизиты карты

alu.CARDINFO=[[ALUCardInfo alloc] initWithCC_NUMBER:@"1122334455667777" EXP_MONTH:@"01" EXP_YEAR:@"2017" CC_CVV:@"071" CC_OWNER:@"Maxim"];

Описание ALUCardInfo

###Добавляем параметры доставки

alu.DELIVERYDATA.DELIVERY_FNAME=@"John";
alu.DELIVERYDATA.DELIVERY_LNAME=@"Smith";
alu.DELIVERYDATA.DELIVERY_PHONE=@"7-926-231-97-22";
alu.DELIVERYDATA.DELIVERY_ADDRESS=@"3256 Epiphenomenal Avenue";
alu.DELIVERYDATA.DELIVERY_ZIPCODE=@"55416";
alu.DELIVERYDATA.DELIVERY_CITY=@"Moscow";
alu.DELIVERYDATA.DELIVERY_STATE=@"Moscow";
alu.DELIVERYDATA.DELIVERY_COUNTRYCODE=CountryCodeRU;

Описание ALUDELIVERYData

Отправляем созданный заказ и получаем статус заказа от сервера

[alu sendALURequstWithResult:^(NSDictionary *response, NSError *error) {
//результат запроса
if (response) {
NSLog(@"%@",response);
NSString *strHeader=[NSString stringWithFormat:@"STATUS:%@",[response objectForKey:@"STATUS"]];
NSString *message=[NSString stringWithFormat:@"RETURN_MESSAGE:%@",[response objectForKey:@"RETURN_MESSAGE"]];
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:strHeader message:message delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

NSLog(@"%@",response);
}
else{
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:error.localizedDescription delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

NSLog(@"%@",error);
}
HIDE_PORGRESS(view);

}];

Описание ответа от сервера в словаре response

Коды ошибок RETURN_CODE от сервера метода ALU

IOS - класс запроса текущего статуса заказа Live Update

Инициализируем класс IOS

IOS *ios = [[IOS alloc] initWithSecretKey:@"e5|S|X~0@l10_?R4b8|1" Merchant:@"ipolhtst" Refnoext:@"3886786"];

Запрашиваем и получаем статус заказа от сервера

[ios sendIOSRequestWithResult:^(NSDictionary *response, NSError *error) {
//результат запроса
if (response) {
NSLog(@"%@",response);
NSString *respStr=[NSString stringWithFormat:@"ORDER_STATUS:%@,\n ORDER_DATE:%@\n REFNO:%@\n REFNOEXT:%@",[response objectForKey:@"ORDER_STATUS"],[response objectForKey:@"ORDER_DATE"],[response objectForKey:@"REFNO"],[response objectForKey:@"REFNOEXT"]];
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:respStr delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];
}
else{
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:error.localizedDescription delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

NSLog(@"%@",error);
}
}];

Описание ответа от сервера в словаре response

Коды статуса заказа ORDER_STATUS от сервера метода IOS

IRN - класс запроса уведомления об отмене/возврате Instant Refund Notification

Инициализируем класс IRN

IRN *irn = [[IRN alloc] initWithSecretKey:@"e5|S|X~0@l10_?R4b8|1"];

Создаем параметры в виде словаря NSMutableDictionary

NSString *payrefno;
//Instant Refund Notification

//формируем заказ
NSMutableDictionary *orderDetails = [NSMutableDictionary new];

//данные заказа
[orderDetails setValue:@"ipolhtst" forKey:@"MERCHANT"];
[orderDetails setValue:@"3886786" forKey:@"ORDER_REF"];
if (payrefno) {
[orderDetails setValue:payrefno forKey:@"ORDER_REF"];
}
[orderDetails setValue:@"1234" forKey:@"ORDER_AMOUNT"];
[orderDetails setValue:@"RUB" forKey:@"ORDER_CURRENCY"];
[orderDetails setValue:@"2016-12-18 01:26:16" forKey:@"IRN_DATE"];

Если сумма, заданная этим параметром, меньше общей суммы заказа, направляется запрос ЧАСТИЧНОГО ВОЗВРАТА. Если параметр AMOUNT равен стоимости заказа, направляется ЗАПРОС ПОЛНОГО ВОЗВРАТА. Параметр не обязательный, но лучше его всегда передавать. | | REF_URL | NSString | нет | URL, на который посредством HTTP GET направляется ответ (при необходимости). В случае если данный параметр не выслан или его значение является неверным, ответ отображается в режиме “inline” (например: http://www.my-website.com/irn.php) | | PRODUCTS_IDS[] | NSArray | нет | Массив данных с идентификационными номерами продуктов для которых отправлен запрос ОТМЕНЫ/ВОЗВРАТА | | PRODUCTS_QTY[] | NSArray | нет | Массив данных о количестве, соответствующем продуктам, заданным параметром PRODUCTS_IDS |

Запрашиваем и получаем статус заказа от сервера

[irn sendIRNRequest:orderDetails withResult:^(NSData *response, NSError *error) {
if (response) {
NSString *result = [[NSString alloc] initWithData:response encoding:NSUTF8StringEncoding];

UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:result delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

NSLog(@"%@",result);
}
else{
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil message:error.localizedDescription delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];

NSLog(@"%@",error);
}
}];

Варианты ответных сообщений

Автор

Maxim Melikhov, melikhov@ipolh.com

Лицензия

IOS_SDK_PAYU is available under the MIT license. See the LICENSE file for more info.