# Получение API-ключа

Для работы с goodPayments API необходимо получить уникальный пользовательский API-ключ. Данный ключ позволяет идентифицировать мерчанта, обеспечивает авторизацию запросов и защищает от несанкционированного доступа. Обращаем ваше внимание, что API-ключ доступен только пользователям, прошедшим регистрацию в сервисе goodPayments.

### Whitelist IP-адресов

Перед получением API-ключа мерчанту необходимо добавить хотя бы один IP-адрес в белый список. Доступ к API будет разрешен только с указанных адресов.

Для добавления IP-адреса необходимо перейти в раздел **«API»** личного кабинета, ввести IP-адрес в формате IPv4 в соответствующее поле и нажать кнопку **«Добавить»**.

{% hint style="info" %}
Максимальное количество IP-адресов в белом списке – **5**. Если в списке остался только один адрес, его удаление недоступно.
{% endhint %}

{% hint style="warning" %}
Пока в белом списке не добавлен хотя бы один IP-адрес, кнопки **«Показать ключ»** и **«Обновить ключ»** недоступны.
{% endhint %}

### Получение API-ключа

{% stepper %}
{% step %}
Перейдите в раздел **«API»** личного кабинета (через панель управления)
{% endstep %}

{% step %}
Добавьте хотя бы один IP-адрес в белый список
{% endstep %}

{% step %}
Нажмите на кнопку **«Показать ключ»**
{% endstep %}
{% endstepper %}

<figure><img src="/files/GoP0r1mH6iDOMZGaMY4e" alt=""><figcaption></figcaption></figure>

Ключ будет показан в модальном окне. Рекомендуем сохранить ключ и хранить его в безопасном месте.

При необходимости, вы можете изменить API-ключ. Для этого необходимо нажать на кнопку **«Обновить ключ»**. Будет сгенерирован новый API-ключ после подтверждения действия.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.