BETA AgDor Pay direct wallet payments
Войти
AgDor Pay

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

Здесь два разных сценария. Один для проектов, которые работают через API и webhook. Второй для операторов, которые создают счета вручную из панели и отправляют готовую payment page или builder view клиенту.

Через API Через панель
API Flow Автоматическая интеграция Для сайтов, SaaS, Telegram-ботов и клиентских проектов, где invoice создается программно и статус приходит вебхуком. project_code, api_key, wallet_code, invoice.confirmed Dashboard Flow Ручные счета из панели Для операторов, менеджеров и администраторов, которые сами создают invoice, настраивают шаблоны и отправляют клиенту ссылку или готовый текст. Проект, кошелек, шаблоны, payment page, builder view

Ручной поток через Dashboard

Этот сценарий не требует API-интеграции со стороны клиента. Оператор сам создает invoice в панели, получает готовую payment page, builder view и отправляет их клиенту вручную.

1

Войдите через Google

Откройте страницу входа и авторизуйтесь. После входа рабочая зона находится в Dashboard.

2

Создайте проект

Проект нужен даже для ручных счетов, потому что именно к нему привязываются invoice, allowed wallets и webhooks. API-ключ для ручного потока можно не использовать.

3

Добавьте кошелек

Назовите кошелек так, как вам удобно в панели, затем настройте адрес или Binance ID. После этого привяжите кошелек к нужному проекту.

4

Создайте manual invoice

Во вкладке Invoices откройте модалку создания счета, выберите проект, кошелек, сумму и при необходимости добавьте шаблоны.

5

Отправьте клиенту готовую страницу

После создания можно открыть builder view, payment page или взять текст из шаблона и отправить его клиенту через Telegram, email или мессенджер.

Проекты

Что хранится в проекте

  • человеческое название проекта
  • project_code для API-сценария
  • webhook_secret для подписи событий
  • Webhook URL, если нужен callback во внешний сервис
  • список разрешенных кошельков

Что важно помнить

  • для ручных счетов API-ключ не обязателен в ежедневной работе
  • если проекту не нужен webhook, URL можно не заполнять
  • один и тот же кошелек можно выдать нескольким проектам

Кошельки

Во вкладке Wallets вы создаете методы приема оплаты, которые затем доступны проектам.

Сценарий Что указывает оператор Как сервис проверяет оплату
Crypto Wallet / Other Название, валюта, сеть, адрес Прямой on-chain check через provider APIs
Crypto Wallet / Binance Название, валюта, сеть, адрес, личные Binance API keys Сначала on-chain, потом fallback по Binance deposit history
Binance ID Название, Binance ID, личные Binance API keys Проверка по истории Binance переводов на ID
`Wallet name` нужен для вашей панели. Это внутреннее имя, по которому вы быстро понимаете, какой именно кошелек используется в проекте или manual invoice.

Ручное создание invoice

Что заполняется

  • проект
  • запрошенная сумма
  • кошелек / сеть
  • TTL счета
  • external_id и customer_id при необходимости

Что делает сервис автоматически

  • генерирует уникальную точную сумму
  • создает `invoice_id`
  • подготавливает payment page
  • сохраняет историю и запускает checker flow

Что вы получаете на выходе

  • builder view с готовым счетом
  • payment page для клиента
  • шаблоны текста для отправки
  • invoice в списке со статусом и действиями

Шаблоны счета

Invoice Builder нужен для тех случаев, когда invoice надо красиво упаковать: Telegram-текст, HTML-документ, инструкция для клиента, реквизиты компании и так далее.

Telegram / Markdown

Подходит для ручной отправки счета в чат, Telegram-бот или email, когда нужен компактный и быстро читаемый формат.

HTML document

Подходит для брендированной страницы, PDF-печати или отправки клиенту красивого документа с платежными инструкциями.

Когда использовать несколько шаблонов

Один invoice может иметь несколько представлений: например, короткий текст для Telegram и отдельную payment page для браузера клиента.

Отслеживание и действия

После создания счета вся дальнейшая работа идет во вкладках Invoices, Transactions и Webhooks.

Раздел Что видно Что можно сделать
Invoices Статус, сумма, сеть, wallet, сроки Открыть builder view, payment page, manual confirm, cancel, late payment check
Transactions Найденные txid и provider Проверить, через какой источник сервис зафиксировал оплату
Webhooks Очередь отправки, статус, target URL Resend webhook, mark as sent, контроль интеграции

Инструменты

Docs для API-клиентов

Если проект со временем перейдет из ручного режима в автоматический, используйте соседний поток документации.

Открыть API docs

Webhook tester

Во вкладке Integration можно отправить тестовый `invoice.confirmed` на любой webhook URL и проверить подпись без реального платежа.