Обзор документации

Цель этой документации — проиллюстрировать, как интегрировать любой проект с Trybit и начать принимать платежи в криптовалюте.

Документация предназначена для специалиста, который отвечает за подключение Trybit на стороне бизнеса: разработчика, технического специалиста или владельца проекта, который настраивает интеграцию самостоятельно. Здесь описаны методы API, форматы запросов и ответов, уведомления о платежах и готовые инструменты для подключения без программирования. Настройки личного кабинета и пользовательские сценарии подробно разобраны в базе знаний.

Что такое Trybit

Trybit — криптоэквайринг для онлайн-бизнеса, которому важны стабильный прием платежей и своевременные выплаты при любой нагрузке. Сервис принимает оплату в популярных криптовалютах и стейблкоинах — Bitcoin, Ethereum, Litecoin, USDT и других — от покупателей по всему миру без банковских барьеров.

Каждая входящая транзакция проходит AML/KYT-проверку: подозрительные поступления помечаются и блокируются до зачисления на баланс, что снижает риск заморозки средств при выводе на биржу. Для проектов с постоянным потоком платежей доступны автоконвертация в стейблкоины, вывод средств через API, статические кошельки и прием платежей под собственным брендом без переадресации (H2H).

Какой способ интеграции выбрать

Способ	Нужен разработчик	Когда подходит	Подробнее
API	Да	Нужен полный контроль над сценарием оплаты: создание счетов, проверка статусов, вывод средств из вашей системы	Авторизация запросов
Host2Host (H2H)	Да	Покупатель оплачивает на вашем сайте, без перехода на платежную страницу Trybit	H2H-интеграция
Модули для CMS	Нет / минимально	Сайт работает на популярной CMS: WooCommerce, OpenCart, Tilda, GetCourse и других	Модули для CMS
HTML-виджет	Нет	Нужно разместить на сайте форму или кнопку оплаты без программирования	HTML-виджет

Для проекта «Telegram-бот» доступна только интеграция по API. Уведомления о статусе платежа через POSTBACK можно получать при любом способе, кроме «HTML-виджета (без постбэка)». Подробное сравнение способов — на странице Способы интеграции в базе знаний.

Как подключить прием платежей

1. Зарегистрируйтесь. Создайте аккаунт в личном кабинете Trybit. → Регистрация и доступ к аккаунту

2. Добавьте проект. В разделе «Добавить проект» выберите тип проекта — «Сайт» или «Telegram-бот», заполните данные о проекте и подтвердите владение доменом или ботом. Тип проекта, домен и ссылку на бота после создания изменить нельзя. → Добавление проекта

3. Выберите способ интеграции. Способ выбирается на шаге «Интеграция и API» процесса добавления проекта. От него зависит набор полей и то, потребуется ли проверка POSTBACK.

   
4. Получите ключи. На шаге «Ключи и тестовые платежи» проекту выдаются API KEY, SHOP ID и SECRET KEY. → Получение API ключей

   
5. Настройте интеграцию и уведомления. Подключите выбранный способ, укажите URL для уведомлений и формат получения POSTBACK. → Принцип работы интеграции, Автоматический POSTBACK

6. Протестируйте интеграцию. Создайте счет тем же способом, что и покупатель, подтвердите его без оплаты и убедитесь, что POSTBACK доставлен на ваш сервер. → Тестирование интеграции

7. Отправьте заявку на выход из тестового режима. Заявка отправляется на шаге «Проверка и отправка». Рассмотрение занимает до 24 часов, статус заявки виден в личном кабинете, результат приходит на email. → Требования и ограничения

8. Принимайте реальные платежи. После одобрения заявки счета подтверждаются только реальной оплатой, а средства зачисляются на баланс.

Возможности API

API V2 закрывает полный цикл работы с платежами — от выставления счета до вывода средств:

• Создание счета — выставление счета покупателю и получение ссылки на оплату или реквизитов.

• Отмена счета — отмена созданного счета.

• Список счетов — получение всех счетов проекта.

• Информация о счете — статус и данные счетов по номеру INV.

• Баланс — остатки на балансе аккаунта.

• Статистика — статистика платежей.

• Вывод средств — создание заявки на вывод.

• Автоматический POSTBACK — уведомления об оплате счета на ваш сервер.

• Статические кошельки — постоянный адрес для платежей без создания нового счета.

• H2H-интеграция — отображение реквизитов для оплаты в вашем интерфейсе.

Базовая информация об API

• Базовый URL: https://api.trybit.com/v2/

• Запросы отправляются методом POST.

• Авторизация: API KEY передается в заголовке Authorization каждого запроса, отдельный запрос на авторизацию не нужен.

Примеры запросов на cURL, Python, JavaScript и PHP — на странице Авторизация запросов. Готовый архив для работы с API — в разделе SDK для работы с API.

Ключевые понятия

Понятие	Что означает
Проект	Отдельная точка приема платежей — сайт или Telegram-бот — со своими ключами, настройками и статистикой
API KEY	Ключ для авторизации запросов к API
SHOP ID	Идентификатор проекта, передается при создании счета и в коде виджета
SECRET KEY	Ключ для проверки подлинности POSTBACK-уведомлений
Счет (INV)	Запрос на оплату с уникальным номером в формате INV-XXXXXXXX
TXID	Хэш транзакции в блокчейне
POSTBACK	Уведомление, которое Trybit отправляет на URL для уведомлений после оплаты счета
Тестовый режим	Режим проверки интеграции: счета подтверждаются без оплаты и не влияют на баланс

Какие валюты поддерживаются

Список криптовалют и сетей, доступных для оплаты, приведен на странице Валюты, сети и лимиты в базе знаний. Валюта суммы счета передается в параметре currency — список кодов на странице Создание счета.

Куда обращаться за помощью

Если у вас возникли вопросы или требуется помощь, вы можете обратиться в наш чат поддержки на сайте и в личном кабинете, а также связаться с нами в Telegram. Контакты поддержки указаны на нашем сайте.

Мы регулярно работаем над улучшением документации сервиса для разработчиков. Пожалуйста, оцените качество и полезность материалов по ссылке.