ANDROID-SDK: відмінності між версіями

Матеріал з apidocs
Перейти до: навігація, пошук
← Попереднє редагування
ВізуальнийВікірозмітка
Немає опису редагування
Немає опису редагування
 
(Не показано 19 проміжних версій цього користувача)
Рядок 1: Рядок 1:
{{APINav}}
== Введення ==
== Введення ==
Ця інструкція допоможе вам інтегрувати EasyPay SDK в ваше Android додаток для обробки платежів. Інтеграція дозволяє вашим користувачам здійснювати платежі за допомогою банківських карток, Google Pay, а також зберіганих карток.
Ця інструкція допоможе вам інтегрувати EasyPay SDK в ваш Android додаток для обробки платежів. Інтеграція дозволяє вашим користувачам здійснювати платежі за допомогою банківських карток, Google Pay, а також збережених карток.
 
=== Версії основних бібліотек ===
----'''Версії бібліотек, використаних для написання SDK:'''
* '''gradle version''' = “8.9”
* '''agp''' = "8.5.2"
*'''minSdk''' = "28"
*'''kotlin''' = "2.1.0"
*'''koin''' = "3.6.0-Beta4"
<br>
 
'''Версії сумісних бібліотек для використання у власному застосунку:'''
* '''gradle version''' = “8.9”
* '''agp''' = "8.5.2"
* '''minSdk''' = "28"
* '''kotlin''' = "2.1.0"
* '''koin''' ="3.5.3"
* '''compose''' ="1.7.0"
* '''activity-compose''' = "1.9.0"
* '''room''' ="2.7.1"
 
----
----


Рядок 8: Рядок 29:
'''1.1 Налаштування в settings.gradle (рівень проекту):'''<syntaxhighlight lang="markdown">
'''1.1 Налаштування в settings.gradle (рівень проекту):'''<syntaxhighlight lang="markdown">
dependencyResolutionManagement {
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
 
    repositories {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        google()
repositories {
        mavenCentral()
google()
    }
mavenCentral()
}
}
}
</syntaxhighlight>
</syntaxhighlight>


Рядок 20: Рядок 41:
У файлі '''build.gradle''' (для вашого додатку) додайте залежність для EasyPay SDK:<syntaxhighlight lang="markdown">
У файлі '''build.gradle''' (для вашого додатку) додайте залежність для EasyPay SDK:<syntaxhighlight lang="markdown">
dependencies {
dependencies {
    implementation("ua.easypay:EasyPay-Sdk:1.0.0-alpha8")
implementation("ua.easypay:EasyPay- Sdk:1.0.0")
}
}
</syntaxhighlight>
</syntaxhighlight>


=== Крок 2: Ініціалізація SDK ===
=== Крок 2: Ініціалізація SDK ===
Для того щоб почати використовувати EasyPay SDK, потрібно ініціалізувати його у вашому додатку. Для цього додайте наступний код в клас '''Application''' вашого додатку:<syntaxhighlight lang="kotlin">
Для того щоб почати використовувати EasyPay SDK, потрібно ініціалізувати його у вашому додатку. Для цього додайте наступний код в клас '''Application''' вашого додатку:<syntaxhighlight lang="kotlin" line="1">
class App : Application() {
class App : Application() {
     override fun onCreate() {
     override fun onCreate() {
         super.onCreate()
         super.onCreate()
         EasyPaySdk.init(
 
             context = PlatformContext(this@App),
         EasyPaySdk.INSTANCE.init(
             secret = "your secret", // Ваш секретний ключ
             PlatformContext(this@App),
             partnerKey = "your partner key" // Ваш партнерський ключ
             "your secret",
             "your partner key",
            null
         )
         )
     }
     }
Рядок 49: Рядок 71:
                 println("SDK Result: $result")
                 println("SDK Result: $result")
             }
             }
         // Контент
 
         sdkLauncher.launch(SdkPaymentContractArgs(
         // Content
            paymentInstrumentArgs = PaymentInstrumentArgs(
 
                serviceKey = "SomeServiceKey",
         sdkLauncher.launch(
                orderId = "SomeOrderId",
            SdkPaymentContractArgs(
                amount = 1.0,
                PaymentInstrumentArgs(
                description = "payment description",
                    "MERCHANT-TEST",
                additionalItems = mapOf("someKey" to "someValue"), // Необов'язково
                    System.currentTimeMillis().toString(),
                 phoneNumber = "380990000000" // Необов'язково
                    1.0,
                    "payment description",
                    mapOf("someKey" to "test-token-card") // Optional
                ),
                 "someValue" // Optional
             ),
             ),
             showPaymentResult = true
             true
         ))
         )
     }
     }
}
}
Рядок 71: Рядок 97:
fun SomeYourScreen() {
fun SomeYourScreen() {
     Box {
     Box {
        // Контент
         val context = LocalContext.current
         val context = LocalContext.current
         context.navigate(
         SdkUserCardsActivity.navigateToCards(
             args = SdkCardsContractArgs(
             this,
                 phoneNumber = "380990000000", // Номер телефону користувача
            SdkCardsContractArgs(
                 urlToNotifyMerchant = null     // Необов'язково
                 phoneNumber = "380990000000",
                 urlToNotifyMerchant = null // Optional
             )
             )
         )
         )
Рядок 86: Рядок 112:
=== Підсумок ===
=== Підсумок ===


# '''Налаштуйте залежності''' в файлах <code>settings.gradle</code> та <code>build.gradle</code>.
## '''Налаштуйте залежності''' в файлах <code>settings.gradle</code> та <code>build.gradle.</code>
# '''Ініціалізуйте SDK''' у класі <code>Application</code>, використовуючи ваші секретні та партнерські ключі.
## '''Ініціалізуйте SDK''' у класі Application, використовуючи ваші секретні та партнерські ключі.
# '''Запускайте оплату''' за допомогою <code>SdkPaymentContractArgs</code> для створення процесу оплати.
## '''Ініціалізація оплати''': Створіть модель SdkPaymentContractArgs, налаштуйте параметри платежу і викликайте <code>sdkLauncher.launch()</code> для відображення екрану оплати.
# '''Додайте навігацію для роботи з картками''' через <code>SdkCardsContractArgs</code>.
## '''Додайте навігацію''' для роботи з картками за допомогою метода <code>SdkUserCardsActivity.navigateToCards().</code>
 
<br>
Ці кроки дозволяють вам швидко та зручно інтегрувати EasyPay SDK в Android додаток та забезпечити безпечні платежі для ваших користувачів.

Поточна версія на 09:41, 11 вересня 2025

Merchant API

Головна сторінка

(Токенізація з передачею даних картки у запиті

Введення

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

Версії основних бібліотек

Версії бібліотек, використаних для написання SDK:

  • gradle version = “8.9”
  • agp = "8.5.2"
  • minSdk = "28"
  • kotlin = "2.1.0"
  • koin = "3.6.0-Beta4"


Версії сумісних бібліотек для використання у власному застосунку:

  • gradle version = “8.9”
  • agp = "8.5.2"
  • minSdk = "28"
  • kotlin = "2.1.0"
  • koin ="3.5.3"
  • compose ="1.7.0"
  • activity-compose = "1.9.0"
  • room ="2.7.1"

Крок 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")
}

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

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

class App : Application() {
    override fun onCreate() {
        super.onCreate()

        EasyPaySdk.INSTANCE.init(
            PlatformContext(this@App),
            "your secret",
            "your partner key",
            null
        )
    }
}

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

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

@Composable
fun SomeYourScreen() {
    Box {
        val sdkLauncher =
            rememberLauncherForActivityResult(SdkPaymentContract()) { result ->
                println("SDK Result: $result")
            }

        // Content

        sdkLauncher.launch(
            SdkPaymentContractArgs(
                PaymentInstrumentArgs(
                    "MERCHANT-TEST",
                    System.currentTimeMillis().toString(),
                    1.0,
                    "payment description",
                    mapOf("someKey" to "test-token-card") // Optional
                ),
                "someValue" // Optional
            ),
            true
        )
    }
}

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

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

@Composable
fun SomeYourScreen() {
    Box {
        val context = LocalContext.current
        SdkUserCardsActivity.navigateToCards(
            this,
            SdkCardsContractArgs(
                phoneNumber = "380990000000",
                urlToNotifyMerchant = null // Optional
            )
        )
    }
}

Підсумок

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


Отримано з https://apidocs.easypay.ua/index.php?title=ANDROID-SDK&oldid=2222