Швидкий старт

Додавання залежності

На Android SDK опубліковано в Maven Central; у React Native він встановлюється з npm командою npx expo install @tapayadot/accept-react-native і підключається через власний конфігураційний плагін.

dependencies {
    implementation("com.tapaya:accept:1.15.0")
}

Синхронізуйте проєкт (Android) або запустіть npx expo prebuild --clean (React Native), а потім виконайте ініціалізацію та автентифікацію в коді застосунку.

// Step 1: Initialize (once, in Application.onCreate)
Accept.initialize(this) // sandbox by default; pass isProduction = true to go live

Автентифікуйте сесію мерчанта за допомогою токена, отриманого з вашого бекенду. authenticate є функцією типу suspend і в разі невдачі викидає виняток AcceptException.

// Step 2: Authenticate (suspend; call from a coroutine)
try {
    val sdkToken = myBackend.login() // token from POST /merchant/auth/login
    Accept.auth.authenticate(sdkToken)
    // Accept.state now emits SdkState.Authenticated
} catch (e: AcceptException) {
    // handle authentication failure
}

Онбординг мерчанта

Перш ніж буде дозволено будь-які транзакції, мерчант має завершити онбординг KYB. Онбординг більше не керується Accept SDK. Завершіть його через Tapaya Platform UI, власний UI, що працює з Tapaya API, або за посиланням-запрошенням. Усі способи описано в розділі Онбординг мерчантів.

Перевірка готовності мерчанта

Переконайтеся, що мерчант завершив онбординг і отримав схвалення на прийом платежів.

val ready = when (val status = Accept.merchant.onboardingStatus()) {
    OnboardingStatus.ReadyForPayments -> true
    is OnboardingStatus.RequiresAction -> false // status.state describes what's blocking
}

Мерчант готовий лише після того, як його схвалить платіжний процесор. Якщо якихось даних бракує, онбординг потрібно пройти повторно. У деяких випадках платіжний процесор може повністю заблокувати мерчанта, наприклад у разі продажу заборонених товарів.

Встановлення та активація термінала

Плагін Tapaya Accept потрібен для платежів карткою. Перевірте, чи його встановлено, а потім активуйте термінал або відкрийте сторінку плагіна в Play Store, щоб його встановити.

if (Accept.plugin.isInstalled()) {
    // suspend; returns ActivateTerminalResult (Success / Canceled / Failed)
    Accept.plugin.activateTerminal()
} else {
    Accept.plugin.install() // opens the store listing
}

Створення платіжної транзакції

Щоб провести транзакцію, викличте Accept.payments.pay() із сумою (у найменшій одиниці валюти) і кодом валюти за ISO 4217. Метод повертає Flow<PaymentEvent>; збирайте з нього події (collect), щоб стежити за перебігом і остаточним результатом. pay() ніколи не викидає винятків: невдачі надходять як PaymentEvent.CreationFailed.

Для швидкого старту достатньо лише amount і currency. Усі необов'язкові параметри, як-от фіксовані чайові, перевизначення чека або метадані, описано в розділі Створення платежу.

Accept.payments.pay(amount = 15000, currency = "CZK") // 150.00 Kč
    .collect { event ->
        when (event) {
            PaymentEvent.Creating -> Log.d("pay", "creating")
            is PaymentEvent.Created -> Log.d("pay", "created ${event.paymentToken}")
            PaymentEvent.Launched -> Log.d("pay", "launched")
            is PaymentEvent.Result -> Log.d("pay", event.payResult.toString())
            is PaymentEvent.CreationFailed -> Log.e("pay", event.cause.toString())
        }
    }