Передача данных пользователей при подключении интеграции

Что это дает

Данная настройка позволяет получить разработчику персональные данные пользователя, тем самым упрощая процесс регистрации и, соответственно, увеличивая общую конверсию в подключение приложения.

Как включить

В Личном Кабинете, в режиме редактирования приложения перейдите в раздел «Настройки для разработки». Затем отметьте чекбокс «Передавать данные пользователя при подключении интеграции». Пока чекбокс не отмечен, данные по умолчанию передаваться не будут.

Как передаются данные

При нажатии на кнопку «Подключить» в Маркетплейсе происходит переход по ссылке «Registration Redirect Url», указанной в Личном Кабинете партнера. К этой ссылке GET-параметром прикладывается параметр user_data и user_data_sign, помимо уже существующего параметра salon_id. При отключении настройки подключение интеграции происходит по обычному флоу.

Как формируются данные

user_data — это JSON, который кодируется алгоритмом base64.

user_data_sign — это подпись, которую мы крайне рекомендуем проверять во избежание нежелательных регистраций от третьих лиц. Формируется он посредством шифрования алгоритмом SHA-256 раскодированного JSON (user_data) вашим партнерским ключом (он находится в меню «Настройки аккаунта»).

Ниже приведен пример расшифровки данных на языке PHP:

  int(123)
 *   ["name"] => string(25) "Иванов Андрей"
 *   ["email"] => string(18) "[email protected]"
 *   ["phone"] => string(11) "79123456789"
 *   ["salon_name"] => string(12) "Best Barbery"
 * }
 */
// 2 этап - проверяем валидность подписи
$isSignValid = $_GET['user_data_sign'] === hash_hmac('sha256', $userData, PARTNER_TOKEN);
if (! $isSignValid) {
    die("Invalid sign!");