Общие сведения
Фреймворк AssistMobile позволяет разработать мобильное приложение интернет-магазина для проведения через АПК Ассист платежей банковской картой с мобильных устройств.
Пользователями фреймворка AssistMobile являются разработчики мобильного приложения интернет-магазина.
Настоящий документ содержит сведения по установке, настройке и использованию фреймворка AssistMobile, достаточные для его применения.
Системные требования
Для работы с AssistMobile необходимо использовать среду разработки iOS SDK версии не ниже 8.4.
Описание фреймворка AssistMobile
Фреймворк AssistMobile представляет собой файл AssistMobile.framework.
Для доступа к функционалу библиотеки нужно использовать объект класса AssistPay.
Класс содержит:
- инициализатор, принимающий поддерживающие протокол AssistPayDelegate объекты;
- метод start, принимающий объект класса UIViewController и объект PayData с данными об оплате;
- метод getResult, принимающий структуру с данными об оплате PayData.
Протокол AssistPayDelegate определяет метод payFinished, с помощью которого поддерживающий этот протокол объект будет получать результат оплаты. Метод payFinished будет вызван, если оплата завершена. Метод имеет следующие параметры:
- bill - номер транзакции в АПК Ассист в строковом формате;
- status - статус платежа;
- message - описание статуса.
Статус может иметь следующие значения:
Unknown - статус неизвестен – вероятно, произошла непредвиденная ошибка и не удалось получить статус оплаты, через некоторое время следует вызвать метод getResult и дождаться возвращения статуса; если ошибка повторяется, то необходимо связаться со службой поддержки Assist;
- InProgress - оплата находится в обработке, через некоторое время следует повторно вызвать метод getResult, для получения результата;
- Delayed - платеж отложен, используется при включении функции отложенных платежей;
- Approved - платеж завершен успешно;
- PartialApproved - платеж завершен успешно на неполную сумму, используется при включении функции подтверждения платежа на неполную сумму;
- PartialDelayed - платеж частично отложен, используется при включении специальной функции;
- Canceled - платеж отменен;
- PartialCanceled - платеж частично отменен;
- Declined - оплата отклонена;
- Timeout - оплата завершена по таймауту;
- Repeated - в системе есть платеж с таким же номером заказа.
Метод start позволяет инициировать процесс оплаты, принимает параметры:
- UIViewController - контроллер вызывающего приложения;
- PayData - данные оплаты.
Метод getResult позволяет получить результат оплаты из АПК Ассист. Принимает параметр PayData.
PayData - объект этого класса содержит данные платежа.