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

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

СОДЕРЖАНИЕ:

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

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

Как определить формат магазина?

У магазинов нового формата в меню есть 🗸 пункт:
⚙️ Интеграция -> HTTP-уведомления.
Для такого магазина настраивайте интеграцию как описано в пункте 1. Подключение по API - OAuth-токен.

Если нет ✖ пункта HTTP-уведомления в Юkassa -> у вас магазин старой версии.
Настраивайте интеграцию как описано в пункте 3. Подключение по HTTP - для старых магазинов Юkassa.

1. Подключение по API - OAuth-токен

🛒Данный способ подключения удобен если в Юkassa поле HTTP-уведомлений уже заполнено, отправляются уведомления в другие сервисы, программы (CRM, Getcourse и т.д.)

Для настройки интеграции с Юkassa перейдите в раздел:
1) Справочники -> Счета бизнеса -> Нажмите "Добавить счет➕" ->Эквайринг
->Юkassa
2) Укажите название счета
3) Зафиксируйте остаток по счету на текущий период. Остаток по счету эквайринг - это сумма в Юkassa которая еще не поступила на расчетный счет.
4) Выберите Тип подключения -> API токен

5) Нажмите на поле "Shop Id ". Выберите "Подключить новый" (на этом шаге будет подключен новый токен)
6) Пройдите процедуру авторизации и согласия на предоставление прав на просмотр Юkassa

7) Заполнить поле "Договор №".
Укажите только номер без даты и пробелов, пример:НЭК.000000.00

💡 Один токен = один магазин.
Если у вас два магазина в Юkassa , то под каждый магазин нужно завести отдельный счет - Эквайринг и подключить интеграцию (свой токен для каждого магазина).

2. Подключение по API с использованием секретного ключа

🛒Данный способ подключения используется если у вас в Юkassa поле HTTP-уведомлений пустое, не заполнено ссылкой на другие сервисы, программы (CRM, Getcourse и т.д.)

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

Для настройки интеграции перейдите в Финтабло:
1) Настройки -> Интеграции -> Эквайринги.
2) Укажите название счета
3) Зафиксируйте остаток по счету на текущий период.
Сумма в Юkassa которая еще не поступила вам на расчетный счет.
4) При добавлении магазина выберите Тип подключения -> API.
5) Заполните поле "Shop Id".
6) Укажите номер Договора без даты и пробелов.

7) Перейдите в Юkassa в левом меню выберите ⚙️ Интеграция -> Ключи API, сгенерируйте новый ключ API и добавьте в Финтабло в поле "Секретный ключ".
8) Скопируйте ссылку для получения уведомлений о платежах в Финтабло

9) Перейдите в Юkassa ⚙️ Интеграции -> HTTP-уведомления, скопируйте ссылку из поля URL для уведомлений и замените её на ссылку из Финтабло:

10) Исходную ссылку, которая была в поле URL для уведомлений в Юkassa , нужно перенести в настройки Финтабло в поле "Отправить уведомление на другой адрес".
Например, если интернет-эквайринг был интегрирован с другим сервисом, программой.

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

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

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

🛒При настройке старого типа магазина Юkassa перейдите в Финтабло:
1) Раздел Настройки -> Интеграции -> Эквайринги.
2) Укажите название счета.
3) Зафиксируйте остаток по счету на текущий период. Остаток по счету эквайринг - это сумма в Юkassa которая еще не поступила на расчетный счет.
4) При добавлении магазина выберите Тип подключения -> HTTP.
5) Для старых магазинов, настройка идет через страницу в Юkassa :
Настройки → Магазин.
Ссылку из Финтабло нужно указывать в поле "avisoUrl".

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

8) Ссылку, что была в поле "avisoUrl" в Юkassa , нужно перенести в настройки счета -Эквайринга в Финтабло в поле "Отправить уведомление на другой адрес".

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

♨️ Операции оплаты через эквайринг приходят на отдельный счет магазина в Финтабло почти сразу после совершения

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

♨️ Комиссии платежных систем списываются автоматически

Без интеграции приходится отслеживать комиссии самостоятельно, и вручную делать списания со счета. Вот как мы делали это раньше.

Теперь они списываются автоматически и видно, сколько мы тратим на эквайринг в Отчете о движении денег.

♨️ Автоматическое преобразование платежей от эквайринга в переводы

Без интеграции приходится вручную преобразовывать эти платежи в переводы.

Когда на расчетный счет придет платеж от эквайринга, он будет автоматом преобразован в перевод внутри Табло. Вы всегда будете видеть актуальные остатки.

♨️ Авторазнесение поступлений с помощью гибких правил

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

Нюансы работы интеграций

◼️ После подключения эквайринга будут загружаться только новые поступления. История операций загружена не будет. Поэтому если сейчас на счете эквайринга есть остатки, нужно их указать при подключении магазина в Финтабло в поле Текущий остаток.

◼️ Комиссия со счетов магазинов Тинькофф Оплаты списывается после перевода денег на расчетный счет, сразу за несколько платежей. Юkassa списывает комиссию сразу после каждого поступления.

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

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