:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)

# Інтеграція з мобільним додатком (SDK)

:::info
[TOC]
:::

Для швидкої організації онлайн-платежів у мобільному застосунку Партнера, система XPAY надає можливість інтеграції за допомогою SDK бібліотек, що містять набір інструментів для взаємодії з платіжним API XPAY.

## Що таке SDK?

**SDK** (від англ. *"Software Development Kit"*) - набір із засобів розробки, утиліт та документації, який дає програмістам змогу створювати прикладні програми за визначеною технологією або для певної платформи.

**SDK XPAY** - бібліотека методів API, які автоматизують інтеграцію між застосунком партнера та системою XPAY.

## Яке питання вирішує SDK?

SDK надає набір інструментів, необхідних розробникам для легкого створення програмних додатків.

Наприклад, Facebook надає SDK для Android від Google та iOS від Apple. Ці SDK діють як бібліотеки з відкритим вихідним кодом, які допомагають інтегрувати Facebook у вашу програму для Android або iOS.

## Функціональні можливості SDK

* Налаштування платіжної сторінки.
* Управління дизайном сторінки.

## Доступні для інтеграції SDK
SDK з обмеженим доступом, для отримання доступу надішліть запит на [e-mail]

| SDK | Інструкції по налаштуванню| Бібілотека |
|:----:|----|:----:|
| | [**SDK Android**](https://hackmd.io/hR-y8VFAQqKqUynbtr8W0g) | [Завантажити](https://jitpack.io/#pustovitandriy/XPAY_Android_SDK)|
| | [**SDK IOS**](https://hackmd.io/8lOSVgUQT2m-JtPSwQfzCQ)|[Завантажити](https://gitlab.com/xpaygroup/xpay-payment-sdk) |

## Загальна схема взаємодії SDK

Для оплати SDK взаємодіє з платіжною системою, при цьому кожен запит має бути підписаний приватним ключем Партнера. Для генерації підпису SDK виконує запит на заданий endpoint backend Партнера, на якому розгорнуто серверну версію. Серверна версія здійснює підпис платіжної інформації приватним ключем Партнера та повертає підпис.

Схематично процес взаємодії виглядає наступним чином:


## Процес оплати

Після інтеграції для користувача мобільного додатку процес оплати виглядає наступним чином:

1. Перехід до оплати в додатку.
2. Вибір метода оплати.
3. Проходження 3DS (за необхідністю).
4. Відображення результату оплати.
5. Завантаження квитанції про сплату.

## Формування пакета даних

Пакет даних формується наступним чином:

1. Збирається структура **"Data"** у вигляді строки.
2. Структура надсилається POST запитом на backend SDK для **формування підпису** на адресу (тестове середовище):

https://stage-papi.xpaydirect.com/api/cretesign/<partner_token>

3. Пакет **не криптованих** даних та **сформованого підпису** надсилаються на backend XPAY.

## Схема отримання доступних методів оплати


:::info
Перейти до запиту: [[20000] Отримання доступних методів оплати (SDK)](https://hackmd.io/E5abYpORTuCezUaxjRM1iA)
:::

:arrow_left: [На Головну](/Mj2ZqCVpSq6A6Jzm6ladlw)

<details>
<summary>Служба підтримки XPAY</summary>
</br>

Телефон: [phone]
Email: [e-mail]
Telegram: @xpaysupportbot
</details>