5. API-ключи
Подключение → API-ключи (или «Ещё → Интеграция», в зависимости от экрана). Видят и управляют владелец, администратор, разработчик выбранного магазина.
5. API-ключи
Где
**Подключение → API-ключи** (или «Ещё → Интеграция», в зависимости от экрана). Видят и управляют владелец, администратор, разработчик выбранного магазина.
Как создать ключ
Выберите нужный магазин и среду (test/live).
Нажмите **«Создать ключ»**.
Укажите **название** — где ключ будет использоваться (например, «Сервер сайта»).
Отметьте **разрешённые действия** (права). Выдавайте только необходимые.
Подтвердите вход кодом MFA, если кабинет просит свежий вход.
Нажмите **«Создать ключ»**.
В окне «Новый API-ключ» вы увидите **ID ключа** и **секретный ключ**. Секрет показывается **только один раз**. Скопируйте его и положите в защищённое окружение сервера (переменные окружения, секретное хранилище).
Подтвердите, что секрет сохранён, и нажмите «Готово».
Секрет скрывается при закрытии окна, при уходе со вкладки или через 5 минут. Повторно получить его нельзя, даже если первый ответ потерялся: тогда **отзовите ключ и создайте новый**.
Права ключа (scopes)
| Право | Что разрешает | | --- | --- | | `payments:read` | Читать платежи и способы оплаты. | | `payments:write` | Создавать и отменять платежи. | | `balance:read` | Читать баланс. | | `webhooks:read` | Читать события и попытки доставки. | | `refunds:read` | Читать возвраты. | | `refunds:write` | Запрашивать возвраты (владелец или администратор). | | `withdrawals:read` | Читать условия и заявки на вывод. | | `withdrawals:write` | Запрашивать выводы (владелец или администратор). |
Правило: минимум прав. Для сайта, который только создаёт платежи и проверяет статус, достаточно `payments:read`, `payments:write`, `webhooks:read`.
Управление
**Список ключей:** название или ID, права, дата создания, статус (активен/отозван), поиск и фильтр по статусу. Секреты в список не попадают.
**Отзыв:** действие «Отозвать» (с указанием причины и подтверждением). Новые запросы с ключом отклоняются сразу; отменить отзыв нельзя. Уже начатые запросы могут завершиться.
**История ключа:** карточка ключа показывает, что с ним происходило.
**Лимиты:** количество активных ключей ограничено (показывается на экране); если выпуск выключен администратором, существующие ключи можно просмотреть и отозвать.
**Реквизиты для запросов:** на экране «Подключение» показаны ID магазина (`X-Project-Id`) и базовый адрес API.
---
Страница была полезна?