ANDROID-SDK

Введення

Ця інструкція допоможе вам інтегрувати EasyPay SDK в ваше Android додаток для обробки платежів. Інтеграція дозволяє вашим користувачам здійснювати платежі за допомогою банківських карток, Google Pay, а також зберіганих карток.

---

Крок 1: Налаштування залежностей

Для початку потрібно налаштувати проект для роботи з EasyPay SDK. Додайте наступні налаштування в конфігураційні файли вашого Android проекту.

1.1 Налаштування в settings.gradle (рівень проекту):

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

1.2 Налаштування в build.gradle (рівень додатку):

У файлі build.gradle (для вашого додатку) додайте залежність для EasyPay SDK:

dependencies {
    implementation("ua.easypay:EasyPay-Sdk:1.0.0-alpha8")
}

Крок 2: Ініціалізація SDK

Для того щоб почати використовувати EasyPay SDK, потрібно ініціалізувати його у вашому додатку. Для цього додайте наступний код в клас Application вашого додатку:

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        EasyPaySdk.init(
            context = PlatformContext(this@App),
            secret = "your secret",  // Ваш секретний ключ
            partnerKey = "your partner key"  // Ваш партнерський ключ
        )
    }
}

Крок 3: Ініціалізація оплати

Далі, для запуску процесу оплати, вам потрібно ініціалізувати SDK в потрібному екрані вашого додатку. Ось приклад використання Composable функції для запуску процесу оплати:

@Composable
fun SomeYourScreen() {
    Box {
        val sdkLauncher =
            rememberLauncherForActivityResult(SdkPaymentContract()) { result ->
                println("SDK Result: $result")
            }
        // Контент
        sdkLauncher.launch(SdkPaymentContractArgs(
            paymentInstrumentArgs = PaymentInstrumentArgs(
                serviceKey = "SomeServiceKey",
                orderId = "SomeOrderId",
                amount = 1.0,
                description = "payment description",
                additionalItems = mapOf("someKey" to "someValue"), // Необов'язково
                phoneNumber = "380990000000" // Необов'язково
            ),
            showPaymentResult = true
        ))
    }
}

Крок 4: Перехід на флоу перегляду/додавання/видалення карток

Для надання користувачам можливості переглядати, додавати або видаляти картки, ви можете скористатися наступною функцією для навігації до відповідного екрану:

@Composable
fun SomeYourScreen() {
    Box {
        // Контент
        val context = LocalContext.current
        context.navigate(
            args = SdkCardsContractArgs(
                phoneNumber = "380990000000",  // Номер телефону користувача
                urlToNotifyMerchant = null     // Необов'язково
            )
        )
    }
}

Підсумок

1. Налаштуйте залежності в файлах settings.gradle та build.gradle.
2. Ініціалізуйте SDK у класі Application, використовуючи ваші секретні та партнерські ключі.
3. Запускайте оплату за допомогою SdkPaymentContractArgs для створення процесу оплати.
4. Додайте навігацію для роботи з картками через SdkCardsContractArgs.

Ці кроки дозволяють вам швидко та зручно інтегрувати EasyPay SDK в Android додаток та забезпечити безпечні платежі для ваших користувачів.