Как принимать платежи в криптовалюте с помощью BlackPay

1. Подготовка приложения

1) Откройте в боте раздел BlackPay и создайте приложение.

2) Откройте карточку приложения и получите API-токен.

3) Убедитесь, что нужные методы включены в безопасности приложения:

• createCheck — для чеков;
• transfer — для вывода с баланса приложения в кошелёк владельца.

2. Базовые параметры интеграции

Base URL: https://api.nl.tuna.am/api

Заголовок авторизации: Black-Pay-API-Token: YOUR_TOKEN

Поддерживаемый актив в текущей реализации: USDT

3. Минимальный рабочий сценарий

Шаг 1. Проверка токена:

GET /getMe

Шаг 2. Создание счета:

POST /createInvoice с полями asset и amount.

Шаг 3. Передача пользователю ссылки оплаты:

Берите поле result.pay_url из ответа createInvoice.

Шаг 4. Контроль статуса оплаты:

Проверяйте инвойс через GET /getInvoices (фильтр по invoice_ids или status).

4. Что происходит после оплаты

При оплате счета, созданного приложением:

• средства зачисляются в баланс приложения apps.balance;
• применяется комиссия 2% (в приложение приходит сумма после комиссии);
• владелец приложения получает уведомление в боте о платеже.

5. Рекомендованный набор методов для старта

• getMe — проверка токена и приложения;
• getBalance — просмотр баланса приложения;
• createInvoice + getInvoices — прием платежей;
• createCheck + getChecks — выдача чеков клиентам;
• transfer — вывод с баланса приложения в кошелек владельца.