Что нужно для подключения
- Аккаунт в ЮKassa (yookassa.ru)
- Статус ИП, ООО/АО или самозанятого (для физлиц без статуса приём платежей недоступен)
- Расчётный счёт, привязанный к ЮKassa
ЮKassa доступна на всех тарифах tikento, включая Free.
Шаг 1. Регистрация в ЮKassa
Перейдите на yookassa.ru и создайте аккаунт. Для получения доступа к боевым платежам потребуется пройти верификацию: загрузить документы (для ИП — паспорт и свидетельство, для ООО — устав и приказ о назначении).
Тестовый режим (тестовые платежи без реальных денег) доступен сразу после регистрации без верификации.
Шаг 2. Создание магазина
В личном кабинете ЮKassa:
- Перейдите в раздел Магазины.
- Нажмите «Создать магазин».
- Заполните данные: название, URL сайта (укажите
app.tikento.com), описание деятельности. - В разделе «Способ подключения» выберите HTTP-уведомления (не виджет).
- Сохраните настройки.
Шаг 3. Получение API-ключей
В настройках созданного магазина:
- Откройте вкладку «Ключи API».
- Скопируйте shopId — это числовой идентификатор магазина (например,
123456). - Нажмите «Создать секретный ключ», введите подтверждение. Скопируйте secretKey вида
test_XXXX...(тестовый) илиlive_XXXX...(боевой).
Секретный ключ показывается только один раз. Если потеряли — создайте новый, старый при этом станет недействительным.
Шаг 4. Настройка в tikento
- Откройте Биллинг в боковом меню tikento.
- В секции Платёжные шлюзы нажмите «Подключить шлюз».
- Выберите ЮKassa, введите
Shop IDиСекретный ключ. - Нажмите «Проверить и сохранить» — tikento сделает тестовый запрос к API ЮKassa.
При успешной проверке карточка шлюза покажет зелёный статус «Активен».
Шаг 5. Настройка webhook
В настройках магазина ЮKassa:
- Откройте «HTTP-уведомления».
- Добавьте webhook URL:
https://api.tikento.com/v1/webhooks/yokassa - Выберите события для отправки:
payment.succeeded— платёж успешно выполненpayment.canceled— платёж отменёнrefund.succeeded— возврат выполнен
Шаг 6. Тестирование
Для тестирования используйте тестовый ключ (начинается с test_). Тестовые карты ЮKassa:
| Номер карты | Результат |
|---|---|
| 4111 1111 1111 1111 | Успешная оплата |
| 4000 0000 0000 0002 | Карта отклонена |
| 4000 0000 0000 3220 | 3D Secure проверка |
Срок действия — любая будущая дата, CVV — любые 3 цифры.
Шаг 7. Переход в боевой режим
Когда тестирование пройдено успешно:
- В ЮKassa подайте заявку на подключение к боевому режиму (кнопка в дашборде магазина).
- Загрузите необходимые документы.
- После одобрения ЮKassa пришлёт уведомление.
- Замените тестовый секретный ключ на боевой: Биллинг → карточка ЮKassa → «Обновить ключи».
Одобрение обычно занимает 1–3 рабочих дня для ИП и 3–5 дней для ООО.
Альтернатива: подключение через OAuth
ЮKassa также поддерживает подключение через OAuth — без ручного копирования ключей:
- В tikento откройте Биллинг → Платёжные шлюзы → «Подключить шлюз».
- Выберите ЮKassa → способ подключения OAuth (рекомендуется).
- Нажмите «Подключить через ЮKassa» — вы будете перенаправлены в личный кабинет ЮKassa.
- Подтвердите доступ для tikento.
- После подтверждения вы вернётесь в tikento автоматически, шлюз будет активирован.
При OAuth-подключении ключи хранятся зашифрованно и обновляются автоматически. Webhook настраивать не нужно — tikento сделает это при подключении.