### Додавання залежності [#add-dependency]
На Android SDK опубліковано в Maven Central; у React Native він встановлюється з npm командою
`npx expo install @tapayadot/accept-react-native` і підключається через власний конфігураційний плагін.
Android (Kotlin)
React Native (TypeScript)
```kotlin title="build.gradle.kts"
dependencies {
// [!code ++:1]
implementation("com.tapaya:accept:1.15.0")
}
```
```json title="app.json"
{
"expo": {
"plugins": ["@tapayadot/accept-react-native"]
}
}
```
Синхронізуйте проєкт (Android) або запустіть `npx expo prebuild --clean` (React Native), а потім
виконайте ініціалізацію та автентифікацію в коді застосунку.
Android (Kotlin)
React Native (TypeScript)
```kotlin title="MyApplication.kt"
// Step 1: Initialize (once, in Application.onCreate)
Accept.initialize(this) // sandbox by default; pass isProduction = true to go live
```
```typescript title="App.tsx"
import Accept from '@tapayadot/accept-react-native';
// Step 1: Initialize (once, at app startup)
Accept.initialize(); // sandbox by default; pass { isProduction: true } to go live
```
Автентифікуйте сесію мерчанта за допомогою токена, отриманого з вашого бекенду.
`authenticate` є функцією типу `suspend` і в разі невдачі викидає виняток `AcceptException`.
Android (Kotlin)
React Native (TypeScript)
```kotlin
// 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
}
```
```typescript
// Step 2: Authenticate
try {
const sdkToken = await myBackend.login(); // token from POST /merchant/auth/login
await Accept.auth.authenticate(sdkToken);
// Accept.state is now 'authenticated'
} catch (error) {
// handle authentication failure
}
```
### Онбординг мерчанта [#onboard-the-merchant]
Перш ніж буде дозволено будь-які транзакції, мерчант має завершити онбординг KYB. Онбординг **більше не
керується Accept SDK**. Завершіть його через Tapaya Platform UI, власний UI, що працює з Tapaya
API, або за посиланням-запрошенням. Усі способи описано в розділі [Онбординг мерчантів](/merchants/onboarding).
У пісочниці (sandbox) мерчантів схвалюють автоматично одразу після онбордингу, тож вам не потрібно чекати на перевірку платіжним процесором.
### Перевірка готовності мерчанта [#verify-merchant-readiness]
Переконайтеся, що мерчант завершив онбординг і отримав схвалення на прийом платежів.
Android (Kotlin)
React Native (TypeScript)
```kotlin
val ready = when (val status = Accept.merchant.onboardingStatus()) {
OnboardingStatus.ReadyForPayments -> true
is OnboardingStatus.RequiresAction -> false // status.state describes what's blocking
}
```
```typescript
const status = await Accept.merchant.onboardingStatus();
// status.state describes what's blocking when it requires action
const ready = status.type === 'readyForPayments';
```
Мерчант готовий лише після того, як його схвалить платіжний процесор. Якщо якихось даних бракує,
онбординг потрібно пройти повторно. У деяких випадках платіжний процесор може повністю заблокувати мерчанта, наприклад у разі продажу заборонених товарів.
### Встановлення та активація термінала [#install--activate-terminal]
Для платежів карткою на пристрої має бути встановлено плагін **Tapaya Accept**.
Для перевірки використовуйте `Accept.plugin.isInstalled()`, а якщо плагіна немає, відкрийте його сторінку
в магазині застосунків за допомогою `Accept.plugin.install()`.
Плагін Tapaya Accept потрібен для платежів карткою. Перевірте, чи його встановлено, а потім активуйте
термінал або відкрийте сторінку плагіна в Play Store, щоб його встановити.
Android (Kotlin)
React Native (TypeScript)
```kotlin
if (Accept.plugin.isInstalled()) {
// suspend; returns ActivateTerminalResult (Success / Canceled / Failed)
Accept.plugin.activateTerminal()
} else {
Accept.plugin.install() // opens the store listing
}
```
```typescript
if (Accept.plugin.isInstalled()) {
// returns ActivateTerminalResult: { type: 'success' | 'canceled' | 'failed' }
await Accept.plugin.activateTerminal();
} else {
await Accept.plugin.install(); // opens the store listing
}
```
### Створення платіжної транзакції [#create-payment-transaction]
Щоб провести транзакцію, викличте `Accept.payments.pay()` із сумою (у найменшій одиниці валюти)
і кодом валюти за ISO 4217. Метод повертає `Flow`; збирайте з нього події (collect), щоб стежити за перебігом і
остаточним результатом. `pay()` ніколи не викидає винятків: невдачі надходять як `PaymentEvent.CreationFailed`.
Для швидкого старту достатньо лише `amount` і `currency`. Усі необов'язкові параметри, як-от фіксовані чайові, перевизначення
чека або метадані, описано в розділі [Створення платежу](../integration/card_terminal#create-a-payment).
Android (Kotlin)
React Native (TypeScript)
```kotlin
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())
}
}
```
```typescript
// payAsync() reduces the event stream to its outcome; use pay() to render progress
const result = await Accept.payments.payAsync({
amount: 15000,
currency: 'CZK', // 150.00 Kč
});
if (result.type === 'success') {
console.log(result.paymentToken, result.receiptUrl);
}
```