API Документация

Начало работы

Обзор API

API 2328 построен на принципах REST. Все запросы выполняются через HTTPS, данные передаются в формате JSON.

Базовый URL для всех запросов:

Base URL

https://api.2328.io/v1

Аутентификация

Все запросы должны содержать API-ключ в заголовке X-Api-Key. Получить ключ можно в личном кабинете в разделе «Настройки → API».

HTTP HeaderКопировать

X-Api-Key: your_api_key_here
Content-Type: application/json

cURLКопировать

curl -X POST https://api.2328.io/v1/invoices \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"amount": "100.00", "currency": "USD", "coin": "USDT"}'

Платежи

Создание счёта

Создаёт новый платёжный счёт. В ответ возвращается адрес кошелька и сумма к оплате в криптовалюте.

POST /v1/invoices

Создать новый счёт для оплаты

Параметры запроса:

Параметр	Тип	Описание
amount	string	Сумма в фиатной валюте required
currency	string	Код валюты: USD, EUR, RUB required
coin	string	Криптовалюта: USDT, BTC, ETH... required
order_id	string	ID заказа в вашей системе optional
webhook_url	string	URL для получения уведомлений optional
success_url	string	Редирект после оплаты optional

ЗапросКопировать

{
  "amount": "49.99",
  "currency": "USD",
  "coin": "USDT",
  "network": "TRC20",
  "order_id": "order_12345",
  "webhook_url": "https://yoursite.com/webhook"
}

Ответ 200Копировать

{
  "id": "inv_8f4a2b1c",
  "status": "pending",
  "address": "TXyz...abc",
  "amount_crypto": "49.99",
  "coin": "USDT",
  "network": "TRC20",
  "expires_at": 1735689600,
  "created_at": 1735686000
}

Webhook

Webhook уведомления

После изменения статуса платежа 2328 отправляет POST-запрос на указанный webhook_url с данными транзакции.

Для проверки подлинности уведомления используйте заголовок X-Signature — HMAC-SHA256 подпись тела запроса с вашим Secret-ключом.

Webhook payloadКопировать

{
  "event": "invoice.paid",
  "id": "inv_8f4a2b1c",
  "status": "paid",
  "order_id": "order_12345",
  "amount": "49.99",
  "coin": "USDT",
  "tx_hash": "abc123...",
  "paid_at": 1735686900
}

Статусы платежей:

Статус	Описание
pending	Ожидает оплаты
confirming	Транзакция найдена, ожидает подтверждений
paid	Оплачен и подтверждён
expired	Истёк срок ожидания
failed	Ошибка при обработке

Выплаты

Создание выплаты

Отправка криптовалюты на указанный адрес. Требует достаточного баланса на счёте 2328.

POST /v1/payouts

Создать выплату на внешний адрес

ЗапросКопировать

{
  "address": "TXyz...abc",
  "amount": "100.00",
  "coin": "USDT",
  "network": "TRC20"
}

Справочник

Поддерживаемые валюты

Список криптовалют и сетей поддерживаемых платформой: