ARIS Docs/Маркетплейсам/Ключи mk_ / pk_

Ключи mk_ / pk_

Каждому активному маркетплейсу выдаются два ключа. Они появляются в админ-карточке маркетплейса в один клик: «показать» и «сменить».

mk_ — секретный ключ

Используется для server-to-server запросов от вашего бэкенда к ARIS:

создание сделок, прикрепление документов, инициирование эскроу
настройка webhook URL и получение whsec_…
любые операции на правах маркетплейса

Передаётся в заголовке:

X-Aris-Key: mk_xxxxxxxxxxxxxxxxxxxxxxxx

Никогда не публикуйте mk_… в браузерном коде, в репозитории, в логах. Если ключ скомпрометирован — сразу нажмите «сменить» в админ-карточке маркетплейса.

pk_ — публичный ключ

Безопасен для встраивания в HTML. По нему виджет может только создать одну сделку на странице товара. Все последующие действия идут по короткоживущему widget-токену.

<div id="aris-deal-widget" data-public-key="pk_xxxxxxxxxxxxxxxxxxxxxxxx" …></div>

Ротация

При ротации mk_ — старый ключ перестаёт работать немедленно. Запланируйте обновление переменной окружения в вашей CI/CD.

pk_ ротируется отдельно, по запросу — это редкая операция, обычно ключ живёт долго.