Интеграция с Мобильным кассиром SDK 1.0.1

Для интеграции с “Мобильным кассиром” используйте RemoteCashierSDK. Он позволяет производить оплату и возврат разными способами с помощью App-To-App взаимодействия стороннего приложения с приложением “Мобильный кассир”. Пример интеграции вы можете посмотреть по этой ссылке.

RemoteCashierSDK позволяет:

Требования для работы с RemoteCashierSDK

RemoteCashierSDK — универсальная библиотека для Android. Для ее корректной работы в приложении “Мобильный кассир” нужно:

Настройка интеграции

Для интеграции с Мобильным кассиром нужно добавить в проект зависимость от библиотеки Эвотора и импортировать интерфейс.

Шаг 1. Добавьте зависимость

Добавьте в проект зависимости от библиотеки RemoteCashierSDK. Для этого:

  1. в build.gradle app добавьте:
     dependencies {
       
       implementation 'com.github.EvotorInnTech:RemoteCashierSDK:1.0.1'
     }
    
  2. в build.gradle Project добавьте:
buildscript {
  
  repositories {
    
    maven { url "https://jitpack.io" }
  }
}

Шаг 2. Создайте объект Integration

  1. Импортируйте в проект интерфейс и реализующий его класс:
    • ru.evotor.integration.Integration — интерфейс;
    • ru.evotor.integration.IntegrationImpl — реализующий класс.
  2. Создайте объект Integration:
    private val integration: integration by lazy { IntegrationImpl() }
    

Описание доступных функций

Выполнение платежа

fun startPayment(receipt: Receipt_V1)

На телефоне должно быть установлено приложение «Мобильный кассир». При вызове открывается activity приложения. Параметр функции: чек с типом Receipt_V1, где V1 — текущая версия классов данных библиотеки.

Описание полей класса Receipt_V1:

Обработка ответа на совершённую операцию

fun handlePaymentResult(registry: ActivityResultRegistry, transactionResultHandler (TransactionResult) -> Unit)

В функцию передайте параметр с типом ActivityResultRegistry. Лямбда-выражение возвращает ответ с типом TransactionResult.

Описание полей класса TransactionResult:

Тестирование интеграции

Для проверки интеграции мы рекомендуем использовать в “Мобильном кассире” виртуальную кассу. Это позволит не использовать настоящие деньги при тестировании.