:arrow_left: [На Головну](/yfyB5CGVTB610Zg-pL3CDQ)

# Створення Партнера

:::info
[TOC]
:::

## Принцип роботи

Для роботи з анкетою Партнера необхідно перейти до розділу **"Partners"** закладки **"Dics & Rules"** (Рисунок 1).

*Рисунок 1 - "Dics & Rules" -> "Partners"*

На сторінці відображається список всіх заведених Партнерів, що формується з наступних колонок (Рисунок 1):

| Параметр | Опис | Приклад |
|:-:|-|:-:|
|`Id`| ID Партнера. |`25`|
|`Name`| Назва Партнера. |`GeoPAY`|
|`Partner Email`| Email Партнера. |`[e-mail]`|
|`Dt Start`| Дата та час початку дії анкети Партнера. |`2018-10-24 14:00:00`|
|`Dt Finish`| Дата та час завершення дії анкети Партнера. |`null`|
|`Act`| Активність анкети Партнера. |`Так`|
|`Data`|JSON структура налаштувань Партнера. Даний атрибут формується з параметрів, описаних нижче. |{"UI": </br> {"CSSFile":"geopay.css", </br> "Captcha": false }}|

Для зручності відбору даних реалізовано сортування по колонках та пошук необхідних записів по введеному значенню будь-якої колонки (Рисунок 2).

*Рисунок 2 - Формування вибірки Партнерів*

## Створення нової анкети Партнера

Для додавання нового Партнера необхідно натиснути на кнопку "+" у правому верхньому кутку сторінки (Рисунок 1), задати необхідний набір параметрів (описаних вище) та натиснути на кнопку "Зберегти" (Рисунок 3).

*Рисунок 3 - Створення нової анкети Партнера*

## Перегляд та редагування анкети Партнера

Для відображення анкети Партнера необхідно натиснути кнопку "око", або "олівець" - для редагування анкети (Рисунок 4).

Для перегляду/редагування гаманців Партнера необхідно натиснути на знак "купюри". Та відповідно, для перегляду/редагування карток Партнера - на знак "картки", траси - на посилання "Траса" (Рисунок 4).

*Рисунок 4 - Перегляд та редагування анкети Партнера*

В результаті натискання на кнопку "олівець" відкривається сторінка редагування анкети Партнера (Рисунок 5).

*Рисунок 5 - Редагування анкети Партнера*

### Структура "Data"

При редагуванні анкети задаються наступні параметри структури "Data":

#### Структура "UI"

| Параметр | Опис | Приклад | За замовчуванням |
|:-:|-|:-:|:-:|
|`AccType`|Дані облікового запису на сторінці чек для віджету, які будуть використані для створення гаманця користувача: електронна пошта, телефон, власний, пропустити або залишити порожнім.|`mail/phone/custom/omit` |опціонально|
|`AccRE`| Користувацький обліковий запис RegExp. | `^\[/0-9\]+$` | опціонально |
|`JSFile`| Підключити js Партнера. |`zsu.gov.ua.js`| опціонально |
|`CSSFile`| Підключити CSS-файл налаштувань стилів віджета. Файл стилів для зміни дизайну віджету під конкретного Партнера (наприклад, замість фіолетового кольору використовувати зелений).| `mtb.css` |опціонально |
|`CC`| Дозволити оплату за допомогою кредитної картки. |`true/false` |`false` |
|`QR`| Дозволити оплату за допомогою QR. | `true/false` |`false`|
|`ApplePay`| Дозволити оплату через "ApplePay". |`true/false` |`false`|
|`GooglePay`| Дозволити оплату через "GooglePay". |`true/false` |`false`|
|`P24`| Дозволити оплату через "Приват24". |`true/false` |`false`|
|`pay_xpay`| Використання токенів XPAY для оплати. |`true/false` |`false`|
|`Header`| Відображати заголовок віджета. | `true/false` |`false`|
|`Banners`| Логотип банку, який буде відображатися у Footer віджету Партнера. | `"Footer": { "Img": "mtb-bank-colored.png", "Partner_Stamp_Img": "мтб_печать_2.png"}` |опціонально|
|`Captcha`| Використовувати Google Captcha.|`true/false` |`false`|
|`Type`| Тип UI для відповідної локалі: en, ru, uk. |`{"en": "", "ru": "", "uk": ""}`| опціонально |
|`AccLabel`| Запрошення для введення даних облікового запису: en, ru, uk. | `{"en": "Enter your email to receive a code", "ru": "Введите Ваш email для получения кода", "uk": "Введіть Ваш email для отримання коду"}` |опціонально|
|`AccTitle`| Підказка, що виводиться для клієнта під час введення даних облікового запису: en, ru, uk. | `{"en": "Enter your personal account number", "ru": "Введите номер личного счета", "uk": "Введіть номер особистого рахунку"}` |опціонально|
|`CmsnAlert`| Попередження: попередньо розрахована комісія відрізняється від поточної комісії: en, ru, uk.|`{"en": "The amount of payment includes service commission!", "ru": "В сумму оплаты включена коммисия сервиса!", "uk": "У загальній сумі включена коммисия сервісу!"}`|опціонально |
|`PopupAlert`| Спливаюче вікно, на яке можна вивести попереджувальну інформацію (на етапі вибору картки): en, ru, uk. |`{"en": "Before sending a payment, make sure that the recipient is not a scammer! Do not use the service to pay on OLX! Payment is not refundable!", "ru": "Перед отправкой платежа убедитесь, что получатель – не мошенник! Не используйте сервис для оплаты на OLX! Платеж возврату не подлежит!", "uk": "Перед відправкою платежу переконайтеся, що одержувач - НЕ шахрай! Не використовуйте сервіс для оплати на OLX! Платіж поверненню не підлягає!"}`| опціонально|
|`QRRecipient`| Одержувач платежу для формування оплати за QR. | `3faada50-0828-451e-93d4-8f94cbbfd810`|опціонально |
|`PromptSums`| Показник, що дозволяє виводити фіксовані значення для оплати (наприклад, для тарифних пакетів із фіксованою щомісячною оплатою). | `[item 1, item 2...]` |опціонально|
|`DetailSum`| Показувати суму комісії на віджеті. |`true/false` |`false`|
|`ServicesDetailSum`| Показувати суму комісії на віджеті у розрізі послуг. | `true/false` |`false`|
|`Agreement`| Оферта банку. | `{"Type": "MTB"}` |опціонально|
|`IFrameLink`| Додатковий час (сек), на який буде продовжено період дії посилання. | `{"ProlongationTime": 300}` |опціонально|
|`WWW`| Сайт Партнера. | `https://www.skarb.com.ua/` |опціонально|
|`Logo`| Завантажити логотип Партнера. | `skarb.png` |опціонально|
|`Name`| Юридична назва Партнера. | `ПТ "Ломбард "Ай ті ломбард"` |опціонально|
|`Tel`| Телефон Партнера. | `380674553322` |опціонально|

#### Структура "PartnerRecipient"

| Параметр | Опис | Приклад | За замовчуванням |
|:-:|-|:-:|:-:|
|`MFO`| Код МФО Партнера. |`305299` |опціонально|
|`EDRPOU`| Код ЄДРПОУ Партнера.|`3505506226` |опціонально|
|`Account`| Рахунок IBAN Партнера. | `UA153226690000026503310044433` |опціонально|
|`Purpose`| Призначення платежу. | `Оплата за послуги страхування` |опціонально|

#### Структура "Callback"

| Параметр | Опис | Приклад | За замовчуванням |
|:-:|-|:-:|:-:|
|`PaySuccess`| `URL` - адреса успішного Callback-у, `Type` - тип переадресації (`redirect`). | `https://e-lombard.com/invoice/paysuccess?uuid=:UUID` |опціонально|

#### Структура "AntiFraud"

| Параметр | Опис | Приклад | За замовчуванням |
|:-:|-|:-:|:-:|
|`CheckClientIP`| Використовується в Widget для порівняння IP адреси клієнта з тою, що вказав Партнер при реєстрації платежу в [10005] запиті. Якщо CheckClientIP==true та IP в 10005 не ідентичний IP клієнта - Widget видає локалізовану помилку з: </br> {{XError->getErrMessage(48). | `true/false`| `false`|
|`CheckPanSufix`| Використовується в Widget для перевірки суфікса кредитки в [10005] запиті. Логіка порівняння аналогічна до тієї, що в `CheckClientIP`. Текст помилки виходить з: </br> {{XError->getErrMessage(45). | `true/false`| `false`|

#### Додаткові параметри

| Параметр | Опис | Приклад | За замовчуванням |
|:-:|-|:-:|:-:|
|`user_account_prefix`| Скорочена назва Партнера англ. мовою. | `lom`|опціонально|
|`wallet_statement_type`| Користувацький тип звіту. | `json`| опціонально|
|`widget_check_fraud`| Виконувати перевірку фрода для операцій віджету. | `true/false`| `false`|
|`PayType`| Тип платіжного методу, згідно таб. ["Типи платіжного методу "PayType"](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w?both#%D0%A2%D0%B8%D0%BF%D0%B8-%D0%BF%D0%BB%D0%B0%D1%82%D1%96%D0%B6%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D1%83-%E2%80%9CPayType%E2%80%9D). Встановлюється в залежності від типу підключення клієнта. | `1` |опціонально|

:arrow_left: [На Головну](/yfyB5CGVTB610Zg-pL3CDQ)