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