Перейти на сайт

Подключение интернет-эквайринга Юkassa (Яндекс.Касса)

Подключите интеграцию с интернет-эквайрингом Юkassa, чтобы видеть в Финтабло сведения о всех платежах почти сразу после их совершения клиентами. Сервис автоматом списывает комиссию и превращает выплаты на расчетный счет в переводы.


1. Основные термины
2. Возможности интеграции
3. Как подключить интеграцию

4. Особенности работы интеграции

Основные термины

API — в рамках интеграции это механизм, по которому Юkassa и Финтабло автоматически передают друг другу информацию о платежах.

API-токен (OAuth-ключ) — уникальный ключ доступа к магазину в Юkassa. Используется для безопасного подключения интеграции через API.

HTTP — способ передачи данных через интернет по ссылке. В интеграции используется для отправки уведомлений о платежах.

HTTP-уведомления — автоматические сообщения от Юkassa, которые отправляются в другую систему (например, в Финтабло) при совершении платежа.

Shop ID — уникальный идентификатор магазина в Юkassa. Используется при подключении интеграции для определения, из какого магазина передаются данные.

AvisoURL — поле в настройках старого формата магазина Юkassa, в которое указывается ссылка для отправки уведомлений о платежах.

Возможности интеграции

  • Мгновенное отображение поступлений.
    Операции по эквайрингу отображаются на отдельном счёте магазина в Финтабло сразу после оплаты клиентом.

  • Автоматическое списание комиссий.
    Размер комиссии отображается в разделе Отчет о движении денежных средств. Дополнительных действий не требуется.

  • Автоматическое преобразование в переводы.
    Платежи, поступившие от эквайринга на расчётный счёт, автоматически оформляются как переводы в Финтабло. Остатки всегда актуальны.

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

Как подключить интеграцию

💡 Перед подключением убедитесь, что в вашем аккаунте Юkassa (Юкасса) вы обладаете правами Владельца. Если прав нет, настройку должен выполнить сотрудник с соответствующими правами.

Особенность Юkassa - это два формата магазинов: старые и новые. От типа магазина зависит порядок настройки.

  • Новый формат магазина — в меню Юkassa есть пункт:
    Интеграция → HTTP-уведомления.
    Для подключения интеграции используйте один из вариантов: API-токен или API.

  • Старый формат магазина — пункт HTTP-уведомлений отсутствует.
    Для подключения интеграции используйте вариант: HTTP.


Способ 1. Подключение по API токену (рекомендуется)

Используйте, если поле HTTP-уведомлений в Юkassa уже используется для других систем (Систем управления клиентами (CRM), GetCourse и т.д.).

  1. Перейдите: Настройки → Интеграции → Эквайринги → Юkassa.

  2. Введите название счёта.

  3. Укажите текущий остаток по счёту — сумма, ещё не поступившая на расчётный счёт от сервиса эквайринга.

  4. Если подключен модуль Учёта НДС — выберите налоговый режим.

  5. Выберите тип подключения API ключ (токен).


6. В поле Shop ID нажмите «Подключить новый».
7. Пройдите авторизацию в открывшемся окне Юkassa и подтвердите доступ.

8. Укажите номер договора (только цифры и буквы, без пробелов и даты), например: НЭК.000000.00.


💡 Один ключ (токен) — один магазин. Для каждого магазина в Юkassa требуется отдельный счёт и интеграция.

Способ 2. Подключение по API — секретный ключ 

Принципы настройки Юkassa  показаны на видео.


  1. Перейдите в раздел Настройки → Интеграции → Эквайринги → Юkassa.

  2. Укажите название счёта.

  3.  Укажите текущий остаток — сумма, ещё не поступившая на расчётный счёт от сервиса эквайринга.

  4. Выберите налоговый режим, если подключен модуль Учёта НДС.

  5. В типе подключения выберите API.

  6. Заполните поля Shop ID и Договор № (только цифры и буквы, без пробелов и даты).


7. В Юkassa откройте: Интеграция → Ключи API, сгенерируйте ключ и вставьте его в Финтабло.

8. Скопируйте ссылку из Финтабло и вставьте в Юkassa в поле HTTP-уведомления. 

9. Старую ссылку из Юkassa перенесите в Финтабло в поле Отправить уведомление на другой адрес. 

Таким образом передача данных будет осуществляться в следующем порядке:

▪ из Юkassa → в Финтабло;
▪ из Финтабло → в другой сервис (с которым ранее была интеграция у Юkassa).


Способ 3. Подключение по HTTP — для старых магазинов

1. Перейдите: Настройки → Интеграции → Эквайринги → Юkassa.
2. Укажите название счёта.
3. Укажите текущий остаток — сумма, ещё не поступившая на расчётный счёт от сервиса эквайринга.
4. Выберите налоговый режим, если подключен модуль Учёта НДС.
5. В типе подключения выберите HTTP.
6. Зайдите в Юkassa → Настройки → Магазин → Параметры для платежей.
7. Скопируйте ссылку из Финтабло и укажите ее в поле "avisoUrl".
 


8. Заполните поле "Shop Id".
9. Укажите номер Договора без даты и пробелов.

10. Старую ссылку из avisoUrl перенесите в Финтабло в поле Отправить уведомление на другой адрес. 

Особенности работы интеграции

  • Загружаются только новые операции. История не подтягивается.

  • Юkassa списывает комиссию сразу после каждого поступления, в отличие от Т-Банка, где комиссия списывается позднее.

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

👆 На этом пока всё