### Thêm dependency [#add-dependency]
Trên Android, SDK được phát hành trên Maven Central; trên React Native, SDK được cài từ npm bằng
`npx expo install @tapayadot/accept-react-native` và được kết nối thông qua config plugin của nó.
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"]
}
}
```
Đồng bộ dự án (Android) hoặc chạy `npx expo prebuild --clean` (React Native), sau đó khởi tạo và
xác thực trong mã ứng dụng của bạn.
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
```
Xác thực phiên của merchant bằng token lấy từ backend của bạn.
`authenticate` là một hàm `suspend` và ném ra `AcceptException` khi thất bại.
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
}
```
### Onboarding merchant [#onboard-the-merchant]
Trước khi được phép thực hiện bất kỳ giao dịch nào, merchant phải hoàn tất onboarding KYB. Onboarding **không còn
do Accept SDK điều khiển**. Hãy hoàn tất qua Tapaya Platform UI, UI của riêng bạn kết nối với Tapaya
API, hoặc một liên kết mời. Xem [Onboarding merchant](/merchants/onboarding) để biết tất cả các cách.
Trong môi trường sandbox, merchant được tự động duyệt ngay sau khi onboarding, nên bạn không phải chờ đơn vị xử lý thanh toán xét duyệt.
### Kiểm tra merchant đã sẵn sàng [#verify-merchant-readiness]
Đảm bảo merchant đã hoàn tất onboarding và được duyệt để nhận thanh toán.
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';
```
Merchant chỉ sẵn sàng sau khi đơn vị xử lý thanh toán đã duyệt. Nếu thiếu một số thông tin,
phải thực hiện lại onboarding. Trong một số trường hợp, đơn vị xử lý thanh toán có thể chặn hoàn toàn merchant, chẳng hạn khi bán hàng hóa bị cấm.
### Cài đặt và kích hoạt máy thanh toán [#install--activate-terminal]
Để thanh toán bằng thẻ, thiết bị phải cài đặt plugin **Tapaya Accept**.
Dùng `Accept.plugin.isInstalled()` để kiểm tra, và `Accept.plugin.install()` để mở trang ứng dụng
trên cửa hàng nếu plugin chưa được cài.
Plugin Tapaya Accept là bắt buộc đối với thanh toán bằng thẻ. Kiểm tra xem plugin đã được cài đặt chưa, sau đó kích hoạt
máy thanh toán, hoặc mở trang ứng dụng trên Play Store để cài đặt.
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
}
```
### Tạo giao dịch thanh toán [#create-payment-transaction]
Để thực hiện giao dịch, gọi `Accept.payments.pay()` với số tiền (theo đơn vị nhỏ nhất của loại tiền tệ)
và mã tiền tệ ISO 4217. Hàm trả về một `Flow`; hãy collect flow này để theo dõi tiến trình và
kết quả cuối cùng. `pay()` không bao giờ ném ngoại lệ: các lỗi được trả về dưới dạng `PaymentEvent.CreationFailed`.
Phần bắt đầu nhanh chỉ cần `amount` và `currency`. Với mọi tham số tùy chọn, chẳng hạn tiền tip cố định, ghi đè thông tin
biên lai hoặc metadata, xem [Tạo khoản thanh toán](../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);
}
```