Получение API ключей

Где найти API KEY, SHOP ID и SECRET KEY и как безопасно их хранить.

Ключи связывают вашу систему с конкретным проектом в Trybit: по ним сервис понимает, от кого пришел запрос, а вы — что уведомление действительно отправил Trybit. У каждого проекта свой набор ключей.

Как получить ключи

1. Зарегистрируйтесь в личном кабинете Trybit.

2. Добавьте проект в разделе «Добавить проект»: выберите тип проекта, заполните шаг «О проекте» и пройдите «Верификацию».

3. Выберите способ интеграции на шаге «Интеграция и API».

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

После создания проекта ключи всегда доступны в шапке страницы проекта: «Мои проекты» → нужный проект. SECRET KEY скрыт — чтобы увидеть его, нажмите «Показать».

Какие ключи нужны и где они используются

Ключ	Для чего нужен	Где используется
API KEY	Авторизация запросов к API	Заголовок Authorization каждого запроса: Token <API KEY> — см. Авторизация запросов
SHOP ID	Идентификатор проекта	Параметр shop_id при создании счета, код HTML-виджета, настройки модулей для CMS
SECRET KEY	Проверка подлинности уведомлений	Проверка JWT-токена в POSTBACK

Какие настройки меняются только в тестовом режиме

Все параметры раздела «Интеграция и API» — способ интеграции, URL успешной оплаты, URL неудачной оплаты, URL для уведомлений и формат получения POSTBACK — можно менять только при включенном тестовом режиме. После выхода из него раздел закрывается; чтобы внести изменения, нужно снова включить тестовый режим, и проект повторно уйдет на проверку.

Как хранить ключи

• Храните ключи на сервере — в переменных окружения или защищенном хранилище конфигурации.

• Не размещайте API KEY и SECRET KEY в коде страниц, мобильных приложениях и публичных репозиториях.

• Не передавайте ключи третьим лицам, в том числе в обращениях в поддержку — для диагностики достаточно SHOP ID.

• Ограничьте доступ сотрудников к настройкам проекта — см. Команда и доступ.

Что делать, если ключ скомпрометирован

1. Включите тестовый режим в текущем проекте и добавьте новый проект в разделе «Добавить проект» — новые ключи выдаются на шаге «Ключи и тестовые платежи». Сменить ключи уже созданного проекта нельзя.

2. Замените API KEY, SHOP ID и SECRET KEY в интеграции на своей стороне, протестируйте ее и отправьте заявку на выход из тестового режима для нового проекта.

3. Проверьте последние операции в разделах «Платежи» и «Вывод средств».

4. Убедитесь, что для аккаунта включена двухфакторная аутентификация.

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

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