Начало работы
Получение API-ключа
Где найти API-ключ и секрет вебхуков магазина и как их хранить.
Где найти ключи
- 1
Войдите в кабинет
Откройте личный кабинет. Если магазина ещё нет, создайте новую интеграцию: укажите название и монеты для приёма.
- 2
Скопируйте API-ключ
В таблице Merchant API-ключи найдите свой магазин и нажмите кнопку копирования рядом с ключом. Ключ выглядит так:
K7P2QX-9DMW4R-T3ZB8N-H6VY5C. - 3
Скопируйте секрет вебхуков
Откройте магазин, перейдите на вкладку Уведомления, укажите URL для вебхуков и скопируйте секрет подписи. Он начинается с
whsec_.
Какие бывают ключи
| Ключ | Формат | Где используется | Кому виден |
|---|---|---|---|
| API-ключ | XXXXXX-XXXXXX-XXXXXX-XXXXXX — 4 группы по 6 заглавных латинских букв и цифр | Заголовок Authorization: Bearer <ключ> во всех запросах к API | Только вашему серверу |
| Секрет вебхуков | whsec_… | Проверка подписи x-ketmus-signature входящих уведомлений | Только вашему серверу |
Передавайте ключ целиком, вместе с дефисами и без пробелов. У каждого магазина свой ключ: счёт, созданный с ключом магазина, зачисляется на баланс именно этого магазина.
Безопасное хранение
- Храните ключи в переменных окружения или менеджере секретов, а не в коде и не в репозитории.
- Не используйте ключ в браузере, мобильном приложении или в коде Telegram Mini App — все запросы к API отправляйте только со своего сервера.
- Если ключ мог попасть к посторонним, сразу перевыпустите его в настройках магазина. Старый ключ перестанет работать.
API-ключ даёт полный доступ к магазину
Тот, у кого есть ключ, может создавать и отменять счета и видеть баланс. Относитесь к нему как к паролю.