# Использование captcha

После того, как вы определились с типом виджета, вам нужно создать учетную запись captcha.

## Доступные типы captcha и их отличия <a href="#whats-the-difference" id="whats-the-difference"></a>

На данный момент виджет поддерживает три вида captcha: hCaptcha, Google Recaptcha v3 и Yandex SmartCaptcha.

Сравнительные характеристики

| Характеристика                                                          | hCaptcha                                                                                                                                                 | Google Recaptcha v3                                             | Yandex SmartCaptcha              |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | -------------------------------- |
| Безопасность использования                                              | Более безопасна, менее подвержена фрод-атакам                                                                                                            | Менее безопасна, более подвержена фрод-атакам                   | Достаточно безопасна             |
| Невидимая капча                                                         | Доступна только при использовании платной лицензии. При бесплатной лицензии пользователям всегда будет необходимо проходить капчу с выбором изображений. | Доступна бесплатно, виджет совместим только с невидимой версией | Пока не поддерживается в виджете |
| Количество показов/загрузок капчи при использовании бесплатной лицензии | До 1 000 000 в месяц                                                                                                                                     | До 10 000 в месяц                                               | До 250 000 в месяц               |
| Просмотр статистики использования капчи                                 | Доступна только при использовании платной лицензии                                                                                                       | Доступна бесплатно                                              | Доступна бесплатно               |
| Возможность ограничения использования по домену                         | Да                                                                                                                                                       | Да                                                              | Да                               |

## Создание учетной записи hCaptcha <a href="#set-up-hcaptcha" id="set-up-hcaptcha"></a>

Для использования виджета необходимо создать учетную запись в сервисе hCaptcha.

1. Зарегистрируйтесь по [ссылке](https://dashboard.hcaptcha.com/signup), указав вашу почту и страну

<figure><img src="/files/j4P9HryYFxoKLCcmMZci" alt="" width="563"><figcaption></figcaption></figure>

2. После этого сервис отобразит вам ваши Sitekey и Secret – сохраните их. Secret потребуется для настройки виджета в личном кабинете, а Sitekey –  для инициализации виджета на вашем сайте.

&#x20;

<figure><img src="/files/X8XWXvhkAu1ILfPMeMBX" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Сервис hcaptcha позволяет прогрузить капчу до 1 млн раз в месяц на бесплатной лицензии. При использовании платной лицензии появляется возможность использования невидимой капчи. Подробнее с типами и возможностями лицензий сервиса вы можете ознакомиться [здесь](https://www.hcaptcha.com/plans).
{% endhint %}

## Создание учетной записи Google Recaptcha

Для работы с Google Recaptcha вам потребуется любой google-аккаунт. Если у вас его нет, то создайте его [здесь](https://accounts.google.com/signup)

После создания google-аккаунта вам будет доступна форма создания Recaptcha по [ссылке](https://www.google.com/u/1/recaptcha/admin/create)

<figure><img src="/files/9sM2lD51LsOGdTSrZOqS" alt="" width="563"><figcaption></figcaption></figure>

Укажите ярлык, по которому вы позднее сможете найти нужную пару ключей, **выберите тип v3** (наш сервис совместим только с этой версией recaptcha), укажите домен вашего сайта и нажмите "Отправить".

{% hint style="info" %}
Для локального использования при тестировании укажите среди доменов **localhost**
{% endhint %}

На следующем шаге сервис отобразит вам ваши ключи – сохраните их. Секретный ключ (Secret) понадобится для настройки виджета в личном кабинете, а ключ сайта (Sitekey) – для инициализации виджета на вашем сайте.

<figure><img src="/files/jTyxEJgzByWsxIsXikWt" alt="" width="563"><figcaption></figcaption></figure>

## Создание учетной записи Yandex SmartCaptcha

Процесс описан в [официальной документации](https://yandex.cloud/ru/docs/smartcaptcha/quickstart). Для создания понадобится учетная запись Yandex Cloud.

В дальнейшем для работы вам понадобятся ключ клиента (чтобы указать в виджете на вашем сайте) и ключ сервера (чтобы указать в личном кабинете Direct)

## Дальнейшие шаги

После создания учетной записи captcha и получения секретного ключа и ключа для сайта можно переходить к [настройке виджета в личном кабинете](/verifier/vidzhet-verifikacii-telefona/set_up_widget.md).


---

# 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://api.docs.direct.i-dgtl.ru/verifier/vidzhet-verifikacii-telefona/captcha-usage.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.