# Загальна інформація

> Технічна специфікація для інтеграції обробки криптовалютних платежів та виплат із 2328.io.

Ласкаво просимо до документації API 2328.io. Цей довідник описує, як інтегрувати обробку криптовалютних платежів та виплат у вашу програму.

## Початок роботи

Щоб розпочати інтеграцію:

1. Створіть мерчант-акаунт та проєкт на [2328.io](https://2328.io)
2. Отримайте **project UUID** та **API key** у налаштуваннях проєкту
3. Згенеруйте окремий **Payout API key**, якщо плануєте використовувати виплати
4. Прочитайте розділ [Автентифікація](/docs/authentication), щоб дізнатися, як підписувати запити
5. Виконайте свій перший виклик [Створити платіж](/docs/payments)

## Базовий URL

Усі продакшн-запити до API використовують такий базовий URL:

```
https://api.2328.io/api
```

> **WARNING:** Усі запити мають здійснюватися через **HTTPS**. Запити без HTTPS блокуються.

## Що ви можете робити

За допомогою API 2328.io ви можете:

- **Приймати криптоплатежі** — створювати платіжні сесії та перенаправляти клієнтів на хостинговий checkout або Telegram MiniApp
- **Виводити кошти** — програмно надсилати виплати з мерчант-балансу на будь-яку блокчейн-адресу
- **Перевірка балансів** — баланс рахунків мерчанта за кожною валютою, еквівалент у USD та суми, заблоковані AML
- **Використовувати статичні гаманці** — генерувати постійні депозитні адреси, прив'язані до користувача або замовлення
- **Отримувати курси обміну** — отримувати курси у режимі реального часу для пар фіат/крипто
- **Отримувати webhooks** — отримувати миттєві сповіщення про зміну статусу платежу
## Обмеження частоти запитів

API дозволяє до **10 запитів на секунду на проєкт**. Запити, що перевищують ліміт, отримують HTTP-відповідь `429 Too Many Requests` — зачекайте та повторіть запит.