> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instaforge.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Онлайн-оплата

> Один раз підключіть власний акаунт клієнта в Stripe, WayForPay або monobank для передоплати, магазину, абонементів і подарункових сертифікатів.

Клієнти можуть оплачувати карткою онлайн передоплату, замовлення в магазині, абонементи й подарункові сертифікати. Платежі проходять через власний платіжний акаунт клієнта, тому гроші надходять безпосередньо клієнтові, а не через агенцію. Дані карток ніколи не потрапляють до InstaForge: покупці платять на сторінці самого платіжного сервісу.

Підключення належить клієнтові: ним користуються всі асистенти клієнта.

![Онлайн-оплата: платіжний сервіс (1), його ключі (2) і що його використовує (3)](https://mintcdn.com/instaforge/DZPPAhB5awuvrT5G/images/uk/online-payments.png?fit=max\&auto=format\&n=DZPPAhB5awuvrT5G\&q=85\&s=e4d9031857e57f87fce69fcc5489f716)

Онлайн-оплата: платіжний сервіс (1), його ключі (2) і що його використовує (3)

## Виберіть платіжний сервіс (1)

У меню асистента відкрийте **Бізнес → Онлайн-оплата**. Змінювати налаштування можуть адміністратори й редактори, власник бізнесу цієї сторінки не бачить.

| Сервіс | Для кого | Корисно знати |
| - | - | - |
| **Stripe** | Бізнеси, зареєстровані в країні, де працює Stripe | Картки з будь-якої країни. Треба один раз налаштувати вебхук у Stripe |
| **WayForPay** | Бізнеси в Україні (ФОП або компанія) з рахунком у будь-якому українському банку | Visa і Mastercard з будь-якої країни, Apple Pay і Google Pay. Виплати в гривнях. Для підтверджень нічого налаштовувати не треба |
| **monobank** (Plata by mono) | Бізнеси з рахунком ФОП або компанії в monobank | Приймає гривні. Фіскальні чеки може видавати автоматично сам mono. Для підтверджень нічого налаштовувати не треба |

Одночасно використовується лише один сервіс. Виберіть його, заповніть ключі й натисніть **Використовувати** (наприклад, **Використовувати WayForPay**). Ключі, збережені для іншого сервісу, не видаляються, тож пізніше можна перемкнутися назад.

## Підключення WayForPay (2)

**1. Скопіюйте логін мерчанта й секретний ключ**

У WayForPay відкрийте налаштування магазину. Скопіюйте **Merchant login** (merchantAccount) і **Merchant secret key** (SecretKey) у поля **Логін мерчанта** і **Секретний ключ**.

**2. Вкажіть сайт магазину**

Введіть сайт, з яким магазин зареєстровано у WayForPay. Якщо залишити поле порожнім, буде використано адресу сторінки запису й магазину клієнта.

**3. Збережіть і перевірте**

Натисніть **Використовувати WayForPay** (або **Зберегти**), потім **Перевірити підключення**.

Кожен платіж повідомляє WayForPay, куди надіслати підтвердження, а InstaForge перевіряє кожне підтвердження секретним ключем, тому більше нічого налаштовувати не треба. WayForPay списує гроші у валюті передоплати, товару чи абонемента й виплачує бізнесу гривні.

## Підключення monobank (2)

**1. Скопіюйте токен**

У бізнес-кабінеті monobank ([web.monobank.ua](https://web.monobank.ua)) відкрийте інтернет-еквайринг і скопіюйте токен для API. Вставте його в поле **API-токен**.

**2. Збережіть і перевірте**

Натисніть **Використовувати monobank** (або **Зберегти**), потім **Перевірити підключення**. У результаті з'явиться назва бізнесу, до якого mono прив'язав цей токен.

mono приймає платежі в гривнях, тому вказуйте ціни передоплати, товарів і абонементів в UAH. Кожен платіж повідомляє mono, куди надіслати підтвердження, і InstaForge звіряє кожне підтвердження із самим mono, перш ніж вважати щось оплаченим.

> [!NOTE]
>
> Бізнес в Україні, який продає товари (замовлення в магазині), зобов'язаний видавати покупцеві фіскальний чек. mono може видавати їх автоматично, якщо чеки налаштовано в його кабінеті. З WayForPay використовуйте сервіс чеків, який у бізнесу вже є.

## Підключення Stripe (2)

**1. Вставте секретний ключ**

У панелі Stripe клієнта відкрийте **Developers → API keys** і скопіюйте секретний ключ. Підійде й обмежений ключ із правом запису для Checkout Sessions і Refunds. Натисніть **Використовувати Stripe** (або **Зберегти**).

**2. Додайте вебхук у Stripe**

Коли вибрано Stripe, на сторінці з'являється блок **Вебхук у Stripe**. У Stripe відкрийте **Developers → Webhooks** і додайте endpoint. Вставте **Адреса вебхука** зі сторінки й виберіть подію `checkout.session.completed`.

**3. Вставте секрет підпису**

Stripe покаже секрет підпису для нового вебхука. Вставте його в поле **Секрет підпису** й натисніть **Зберегти**.

**4. Перевірте**

Натисніть **Перевірити підключення**. InstaForge спитає Stripe, чи працює ключ, і покаже акаунт, якому він належить.

> [!WARNING]
>
> Без вебхука Stripe і його секрету підпису клієнти зможуть заплатити, але InstaForge про це не дізнається: час запису залишиться утриманим, замовлення значитимуться неоплаченими, а коди подарункових сертифікатів не буде надіслано.

## Що використовує оплату (3)

Кожна функція вмикається й налаштовується на своїй сторінці. Список показує, які з них увімкнено.

| Функція | Де налаштовується |
| - | - |
| Передоплата, щоб закріпити запис | **Записи**, у блоці «Передоплата, щоб закріпити час». Див. [Підтвердження, неявки й передоплата](https://docs.instaforge.app/uk/bookings/confirmations-and-no-shows.md) |
| Онлайн-оплата замовлень у магазині | **Магазин**. Див. [Магазин і замовлення](https://docs.instaforge.app/uk/grow-sales/shop-and-orders.md) |
| Купівля абонементів і подарункових сертифікатів у чаті | **Абонементи та сертифікати**. Див. [Абонементи та сертифікати](https://docs.instaforge.app/uk/grow-sales/packages-and-gift-cards.md) |

Без онлайн-оплати замовлення в магазині оплачуються під час самовивозу або доставки, а про оплату абонементів і подарункових сертифікатів домовляється команда.

Платіж, який надійшов, коли час уже віддали іншому (передоплату сплачено після закінчення утримання, замовлення оплачено після скасування), повертається автоматично. Це працює з усіма трьома сервісами.

## Тестовий режим

Ключ Stripe, що починається з `sk_test_`, підключає тестовий режим Stripe, а тестовий мерчант WayForPay (`test_merch_n1`) підключає тестовий режим WayForPay. На сторінці з'являється мітка **Тестовий режим**. Проведіть платіж тестовими картками сервісу, а потім замініть ключі на робочі.

## Відключення

**Відключити** видаляє ключі вибраного сервісу. Якщо це сервіс, який зараз використовується, спершу вимкніть передоплату: без онлайн-оплати вона працювати не може.

> [!NOTE]
>
> Оплата послуг агенції налаштовується окремо: скільки клієнт платить агенції, вказується на сторінці [Оплата](https://docs.instaforge.app/uk/running-the-agency/billing.md) з вашим власним посиланням на оплату.

> [accordion] Чи може ШІ-агент це налаштувати?
>
> [ШІ-агент](https://docs.instaforge.app/uk/running-the-agency/ai-agents.md) може переглянути підключення через `online_payments` і перемкнутися на сервіс, ключі якого вже збережено, через `set_payment_provider`. Самі ключі вводяться лише на цій сторінці.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.