FreemiumProBusinessEnterprise

Подключение ЮKassa (Яндекс Касса)

Что нужно для подключения

  • Аккаунт в ЮKassa (yookassa.ru)
  • Статус ИП, ООО/АО или самозанятого (для физлиц без статуса приём платежей недоступен)
  • Расчётный счёт, привязанный к ЮKassa

ЮKassa доступна на всех тарифах tikento, включая Free.

Шаг 1. Регистрация в ЮKassa

Перейдите на yookassa.ru и создайте аккаунт. Для получения доступа к боевым платежам потребуется пройти верификацию: загрузить документы (для ИП — паспорт и свидетельство, для ООО — устав и приказ о назначении).

Тестовый режим (тестовые платежи без реальных денег) доступен сразу после регистрации без верификации.

Шаг 2. Создание магазина

В личном кабинете ЮKassa:

  1. Перейдите в раздел Магазины.
  2. Нажмите «Создать магазин».
  3. Заполните данные: название, URL сайта (укажите app.tikento.com), описание деятельности.
  4. В разделе «Способ подключения» выберите HTTP-уведомления (не виджет).
  5. Сохраните настройки.

Шаг 3. Получение API-ключей

В настройках созданного магазина:

  1. Откройте вкладку «Ключи API».
  2. Скопируйте shopId — это числовой идентификатор магазина (например, 123456).
  3. Нажмите «Создать секретный ключ», введите подтверждение. Скопируйте secretKey вида test_XXXX... (тестовый) или live_XXXX... (боевой).

Секретный ключ показывается только один раз. Если потеряли — создайте новый, старый при этом станет недействительным.

Шаг 4. Настройка в tikento

  1. Откройте Биллинг в боковом меню tikento.
  2. В секции Платёжные шлюзы нажмите «Подключить шлюз».
  3. Выберите ЮKassa, введите Shop ID и Секретный ключ.
  4. Нажмите «Проверить и сохранить» — tikento сделает тестовый запрос к API ЮKassa.

При успешной проверке карточка шлюза покажет зелёный статус «Активен».

Шаг 5. Настройка webhook

В настройках магазина ЮKassa:

  1. Откройте «HTTP-уведомления».
  2. Добавьте webhook URL:
    https://api.tikento.com/v1/webhooks/yokassa
    
  3. Выберите события для отправки:
    • payment.succeeded — платёж успешно выполнен
    • payment.canceled — платёж отменён
    • refund.succeeded — возврат выполнен

Шаг 6. Тестирование

Для тестирования используйте тестовый ключ (начинается с test_). Тестовые карты ЮKassa:

Номер картыРезультат
4111 1111 1111 1111Успешная оплата
4000 0000 0000 0002Карта отклонена
4000 0000 0000 32203D Secure проверка

Срок действия — любая будущая дата, CVV — любые 3 цифры.

Шаг 7. Переход в боевой режим

Когда тестирование пройдено успешно:

  1. В ЮKassa подайте заявку на подключение к боевому режиму (кнопка в дашборде магазина).
  2. Загрузите необходимые документы.
  3. После одобрения ЮKassa пришлёт уведомление.
  4. Замените тестовый секретный ключ на боевой: Биллинг → карточка ЮKassa → «Обновить ключи».

Одобрение обычно занимает 1–3 рабочих дня для ИП и 3–5 дней для ООО.

Альтернатива: подключение через OAuth

ЮKassa также поддерживает подключение через OAuth — без ручного копирования ключей:

  1. В tikento откройте Биллинг → Платёжные шлюзы → «Подключить шлюз».
  2. Выберите ЮKassa → способ подключения OAuth (рекомендуется).
  3. Нажмите «Подключить через ЮKassa» — вы будете перенаправлены в личный кабинет ЮKassa.
  4. Подтвердите доступ для tikento.
  5. После подтверждения вы вернётесь в tikento автоматически, шлюз будет активирован.

При OAuth-подключении ключи хранятся зашифрованно и обновляются автоматически. Webhook настраивать не нужно — tikento сделает это при подключении.