Ключ используется для аутентификации: чтобы ЮKassa понимала, что запросы на отправку денег передаёт именно ваш сервис.
Ключ нужно создать в личном кабинете (в разделе Интеграция —
Ключи API), прописать на своей стороне и передавать ЮKassa в запросах на выплаты.
- В личном кабинете выберите нужный шлюз выплат (нажмите на блок со шлюзами в верхнем меню).
- Зайдите в Интеграция — Ключи API, в блоке «Секретный ключ» нажмите Выпустить ключ.
- Подтвердите выпуск ключа смс-кодом (придёт на номер, который привязан к личному кабинету).
- После этого появится окно с вашим секретным ключом. Ключ нужно скопировать и прописать на своей стороне.
Ключ доступен только в этом окне — скопируйте его или скачайте его в файле и сохраните у себя в надёжном месте. После закрытия окна мы скроем ключ, он останется только у вас.
Если с ключом что-то случится (например, вы его потеряете или скомпрометируете), его нужно выпустить заново.
- В личном кабинете выберите нужный шлюз выплат (нажмите на блок со шлюзами в верхнем меню).
Зайдите в Интеграция — Ключи API, в блоке «Секретный ключ» нажмите на значок обновления напротив нужного ключа.
Подтвердите перевыпуск ключа смс-кодом (придёт на номер, который привязан к личному кабинету).
Старый ключ удалится не сразу, он действует ещё 48 часов — чтобы вы успели прописать везде новый.
Скопируйте новый ключ и пропишите на своей стороне. После этого старый ключ можно удалить — или он удалится сам (через 48 часов после выпуска нового).
Перевыпустить секретный ключ можно несколько раз подряд, но активный всегда будет только один: тот, который вы выпустите последним.
- В личном кабинете выберите нужный шлюз выплат (нажмите на блок со шлюзами в верхнем меню).
Зайдите в Интеграция — Ключи API, в блоке «Секретный ключ» нажмите иконку с корзиной напротив нужного ключа.
Подтвердите удаление ключа смс-кодом (придёт на номер, который привязан к личному кабинету).
Ключ сразу перестанет работать — убедитесь, что он не используется.
Ключ нужно передавать в заголовках всех запросов по API ЮKassa.
Прописать его нужно в коде вашей системы: обычно этим занимаются технические специалисты на вашей стороне.