Оплаты и эквайринг — виджет BazON для amoCRM (v2.0)

Руководство по настройке и работе виджета BazON для amoCRM. Раздел для администратора аккаунта. Виджет принимает онлайн-оплату по СБП прямо из карточки сделки: менеджер создаёт платёж, отправляет клиенту QR или ссылку, банк сообщает об оплате, деньги попадают в BazON-сделку и при настройке пробивается чек. Здесь — подключение терминалов разных банков, автоматизация при оплате, кассы для чеков, брендирование QR и договор-счёт.

Интернет-эквайринг: общая схема

Что делает. Подключает банковский эквайринг, чтобы принимать оплату по QR-коду или ссылке. Цепочка: менеджер создаёт платёж → отправляет клиенту QR/ссылку → банк сообщает виджету об оплате → платёж записывается в BazON-сделку (и при настройке пробивается чек). Возврат — с подтверждением. Поддерживаемые банки по СБП: Модульбанк, Т-Банк (бывш. Тинькофф), Точка-банк, ЮKassa (далее Альфа, Сбер, ВТБ). У каждого банка свои реквизиты — см. разделы ниже.

Как настроить (общий мастер).

1. Откройте виджет → Настройки интеграции → Эквайринг.
2. Нажмите «Добавить терминал» и выберите банк.
3. Пройдите мастер банка (ввод токена/ключей, выбор компании, точки продаж, счёта). Пошаговые инструкции по банкам — ниже.
4. Нажмите «Тест подключения», убедитесь, что реквизиты приняты.
5. По желанию настройте действия при оплате (раздел «Автоматизация эквайринга») и оформление QR (раздел «Брендирование QR»).

Реквизиты банка хранятся в зашифрованном виде. Один аккаунт может иметь несколько терминалов (разные банки, разные точки продаж).

Менеджер: в карточке сделки открывает вкладку BazON → раздел платежей, выбирает терминал, создаёт платёж (по сделке — сумма из сделки; или произвольный — вводит сумму), отправляет клиенту QR-код или ссылку. После оплаты статус обновляется автоматически; при настроенной автоматизации деньги вносятся в BazON и пробивается чек.

Возврат денег делается из таблицы платежей с подтверждением (нужно решить пример-капчу) и доступен только тем, кому разрешён, — защита от случайных и несанкционированных возвратов.

Все платежи аккаунта — в разделе Настройки → Платежи эквайринга: таблица с фильтрами, экспортом в CSV и журналом по каждому платежу.

Ограничения и частые вопросы.

• «Тест подключения» не проходит — перепроверьте реквизиты по инструкции банка, убедитесь, что в банке включён нужный продукт (СБП/возвраты).
• Оплата прошла, но не записалась — откройте Журнал событий, найдите сделку и посмотрите причину; проверьте корректность адреса уведомлений (для некоторых банков задаётся вручную).
• Возврат недоступен — у пользователя нет прав на возврат по этому терминалу.

Автоматизация эквайринга (действия при оплате)

Что делает. Задаёт, что виджет делает автоматически при событиях платежа на каждом терминале (настраивается по каждой кассе отдельно). Убирает ручные шаги в цепочке «клиент оплатил по QR → деньги в BazON → чек пробит → менеджер видит оплату». Четыре сценария:

«По сделке» — сумма из текущей BazON-сделки. «Произвольный» — менеджер сам вводит сумму (рассрочка, частичная оплата, корректировка). Деньги вносятся только в зарезервированную сделку, чек пробивается только после оплаты. По произвольному платежу чек автоматически не пробивается — менеджер делает это вручную с нужным назначением.

Как настроить.

1. Откройте виджет → Настройки интеграции → Эквайринг.
2. В карточке нужного терминала нажмите «Автоматизация» (рядом — число активных правил).
3. В окне — 4 вкладки по сценариям. На нужной включите действия: для BazON укажите параметры (источник оплаты, ОФД-касса), для amoCRM-действия «сохранить ссылку оплаты» выберите поле сделки.
4. Изменения сохраняются сразу.

Настройка по каждому терминалу отдельно: у разных касс могут быть разные источники оплаты, ОФД-кассы и поля amoCRM.

Ограничения и частые вопросы.

• Часть amoCRM-действий в разработке (помечены «Скоро»).
• Автоматизация привязана к терминалу, не глобальная.
• Действие не сработало — откройте Журнал событий, найдите сделку по ID, посмотрите причину (например, сделка не зарезервирована, нет остатка).
• Чек не пробился — проверьте настройку касс и что сценарий «Платёж по сделке оплачен» включает действие «пробить чек».

Кассы и юридические реквизиты

Что делает. Раздел Настройки интеграции → Кассы настраивает онлайн-кассы BazON: какая касса пробивает чек для какого склада и с какими реквизитами. У клиента может быть несколько касс (физическая в офисе, онлайн для интернет-заказов). Виджет по складу заказа сам выберет нужную кассу, подставит реквизиты и пробьёт чек.

Как настроить.

1. Откройте Настройки интеграции → Кассы — виджет покажет список онлайн-касс из справочника BazON (нет нужной — добавьте в BazON и нажмите «Обновить»). Каждая касса — аккордеон с индикатором: зелёная точка — настроена; красная — критическая проблема (например, не выбраны склады); серая — касса есть, но не привязана к складу, чеки не пробьются.
2. Нажмите «Настроить» напротив кассы. В форме две группы:
   • Юридические реквизиты (опциональные): Юр.лицо или ИП, ИНН, название места расчётов, адрес места расчётов. Правило «всё или ничего»: либо все 4 заполнены, либо все 4 пусты — иначе ошибка при сохранении. Пустые поля — касса всё равно пробивает чеки, но клиент не сможет открыть фискальный чек по URL (BazON требует реквизиты). Все 4 заполнены — виджет передаст их в BazON, клиент получит ссылку на свой чек.
   • Привязка к складам: чипы под формой — список складов из BazON. Отметьте те, для которых эта касса пробивает чеки. Один склад привязывается только к одной кассе (иначе виджет покажет конфликт).
3. Добавьте кассира в BazON (один раз): в виджете есть подсказка с именем и логином подключённого сотрудника BazON и кнопка-ссылка «Перейти к настройкам онлайн-касс». В BazON откройте нужную кассу, добавьте этого сотрудника в кассиры, сохраните. Без этого BazON откажется пробить чек от имени виджета.
4. Нажмите «Сохранить» в виджете.

Ограничения и частые вопросы.

• Один склад — одна касса.
• Виджет не редактирует кассы в BazON: регистрация и фискализация кассы делаются в BazON.
• Реквизиты в виджете перебивают дефолтные только для генерации ссылки на чек клиенту; на сам факт пробития влияют реквизиты BazON.
• Красная точка — не привязан ни один склад: раскройте кассу, отметьте склады, сохраните.
• Ошибка «Реквизиты должны быть заполнены полностью» — заполнены 1–3 из 4 юр.полей: заполните все 4 или очистите все.
• Чеки не пробиваются, «Доступ запрещён» — подключённый сотрудник BazON не добавлен в кассиры (шаг 3).
• Кассы нет в списке — проверьте её в BazON (Меню → Кассы), нажмите «Обновить справочники BazON».
• Зачем дублировать реквизиты, если они есть в BazON — в BazON реквизиты привязаны к кассе, а в amoCRM сделка не всегда соответствует кассе один-к-одному (один заказ может идти на разные склады); виджет позволяет переопределить реквизиты для конкретной кассы под нужный склад.
• Нет онлайн-касс, только физические — раздел будет пустой, чеки через виджет не пробиваются, остальные функции работают.

Подключение Точка-банка (СБП)

Что делает. Терминал Точка-банк СБП: счёт клиенту через СБП (ссылка https://qr.nspk.ru/... и QR), автоматическое получение оплаты по webhook, возврат из карточки сделки. Один JWT-ключ Точки может обслуживать несколько ЮЛ — для каждого создаётся свой терминал.

Как настроить.

1. Сгенерируйте JWT-ключ в ЛК Точки (вручную, виджет токен сам не получает): ЛК Точки → «Интеграции и API» → «Подключить» → «Сгенерировать ключ JWT». Заполните название, срок действия (берите максимальный — год), и обязательно отметьте все четыре права: ReadSBPData (чтение ЮЛ, ТСП, счетов), EditSBPData (регистрация СБП-QR), MakeAcquiringOperation (возвраты), ManageWebhookData (автопрописывание URL уведомлений). Подтвердите SMS. ЛК выдаст две строки: jwt_token и client_id (UUID) — скопируйте обе.
2. В виджете: Настройки интеграции → Эквайринг → «+ Добавить терминал» → «Точка-банк СБП». Мастер из 4 шагов: вставьте JWT и client_id; выберите клиента (customerCode); выберите ЮЛ; выберите ТСП и счёт зачисления. Затем заполните карточку: название (мастер предложит «Название ЮЛ · ТСП»), «Активен», склады BazON (где показывать терминал), кому разрешён возврат. Нажмите «Сохранить» — виджет сам пробросит Точке наш URL уведомлений.
3. Проверьте webhook: откройте терминал ещё раз, секция «Webhook URL для банка» — «Проброшен в банк» (можно тестировать) или «Не настроен в банке» (обычно в JWT не было ManageWebhookData — перевыпустите ключ и нажмите «Зарегистрировать в Точке»). Кнопка «Проверить статус» перечитывает состояние из ЛК.
4. Тестовый платёж на 1 рубль: в сделке вкладка «Платежи» → «Создать платёж» → 1 рубль → терминал «Точка-банк СБП» → «Создать». Откройте ссылку/QR на телефоне, оплатите. Через 1–3 секунды статус сменится на «Оплачен», в BazON появится оплата. Не меняется минуту — «Обновить» и проверьте webhook.

Возврат: в карточке оплаченного платежа кнопка «Вернуть» (только разрешённым менеджерам) → сумма (можно частично) и причина → капча-задача (одноразовая). Зачисление клиенту обычно занимает несколько минут.

Ограничения и частые вопросы.

• JWT истёк — в ЛК Точки перевыпустите ключ (меняются и jwt_token, и client_id — старый client_id перестаёт работать), в виджете откройте терминал → «Изменить реквизиты» → пройдите мастер заново. Webhook перерегистрируется сам.
• «Неверный JWT-токен или нет прав» — не отмечен один из обязательных consents, перевыпустите с полным набором.
• Auto-register webhook упал: 403 — нет ManageWebhookData; 502/5xx — Точка временно недоступна, попробуйте «Зарегистрировать в Точке» через 1–2 минуты.
• Клиент оплатил, статус не сменился — проверьте «Проброшен» в карточке терминала; откройте аудит-журнал платежа; «Обновить статус» дёрнет Точку напрямую без webhook.
• Несколько ЮЛ на один JWT — создайте отдельный терминал на каждое ЮЛ (JWT и client_id одни и те же, webhook один на client_id, маршрутизация по терминалам автоматическая).
• Безопасность: JWT и client_id шифруются AES-GCM, в логах только маска; webhook Точки подписан RSA и проверяется на каждом сообщении; возврат защищён ACL + капчей. Не передавайте JWT посторонним — его первые символы участвуют в подписи webhook.

Подключение Т-Банка (СБП QR)

Что делает. Терминал Т-Банка (бывш. Тинькофф; машинный код провайдера tinkoff_sbp, историч.): счёт по СБП, автоматическое получение оплаты, возврат из карточки. На один аккаунт можно подключить несколько терминалов Т-Банка (на разные склады или юрлица).

Как настроить.

1. Возьмите в ЛК Т-Банка (раздел интернет-эквайринга) два реквизита: Terminal Key (идентификатор терминала, виден в списке) и Пароль терминала (секретный пароль из настроек терминала — им подписываются запросы и проверяются уведомления). Нет терминала — его заводит бухгалтер/администратор при подключении интернет-эквайринга. Для сертификации Т-Банк выдаёт отдельный тестовый терминал со словом DEMO в идентификаторе.
2. В виджете: Настройки интеграции → Эквайринг → «+ Подключить терминал» → «Т-Банк (СБП QR)». Заполните: Terminal Key, Пароль терминала, название, «Активен», склады BazON (хотя бы один обязателен — иначе не сохранится), кому разрешён возврат.
3. Пройдите тестовую сертификацию Т-Банка (обычно 6–8 платежей на DEMO-терминале, прямо в форме до сохранения): введите реквизиты тестового терминала → кнопка «Протестировать подключение» → окно «Тестирование платежей» → «Сформировать тестовый платёж». Виджет создаст платёж и покажет карточную ссылку (в тесте оплата картой, СБП-QR появится в боевом), сумму, назначение, счётчик «Сформировано N из 8». В каждый платёж виджет сам кладёт чек (позиция «Тестовый товар») — без него банк не пропускает тест «Формирование чека». Оплатите ссылку тестовой картой Т-Банка, повторите 6–8 раз (каждый раз новая случайная сумма и назначение — требование банка). Затем в ЛК Т-Банка → «Тестирование платежей» → «Проверить». Не закрывайте форму подключения: данные тестового терминала нигде не сохраняются, иначе счётчик обнулится. После подтверждения сертификации создайте боевой терминал так же, с боевыми реквизитами.
4. Нажмите «Сохранить». Адрес уведомлений виджет подставляет в каждый счёт автоматически — отдельно прописывать в ЛК не нужно.

Выставление счёта и возврат — как у Точки (вкладка «Платежи», QR/ссылка, статус «Оплачен» за 1–3 секунды; возврат с капчей разрешённым менеджерам).

Ограничения и частые вопросы.

• «Неверные реквизиты» при сохранении — проверьте Terminal Key и Пароль без лишних пробелов (виджет делает быструю проверку через банк).
• Тестовый платёж не формируется — правильный ли Пароль терминала (не пароль от ЛК), именно DEMO-терминал, не закрывайте форму между нажатиями.
• Банк не принимает тест «Формирование чека» — виджет кладёт чек сам; если не принимает, сообщите точный текст ошибки (возможно, нужна другая СНО или ставка НДС в чеке).
• Оплатил, статус не сменился — откройте аудит-журнал платежа; «неверная подпись уведомления» означает несовпадение Пароля терминала с актуальным в ЛК; нажмите «Обновить».
• Несколько терминалов Т-Банка — создавайте отдельный на каждый случай, у каждого свой адрес уведомлений.
• Безопасность: Terminal Key и Пароль шифруются AES-GCM, в логах маска; каждое уведомление подписано вашим паролем терминала и проверяется; возврат защищён ACL + капчей. Пароль терминала посторонним не передавать.

Подключение ЮKassa (СБП QR)

Что делает. Магазин ЮKassa (машинный код yookassa_sbp): счёт по СБП, автоматическое получение оплаты, возврат из карточки. Можно подключить несколько магазинов (на разные юрлица) отдельными терминалами.

Как настроить.

1. Возьмите в ЛК ЮKassa два реквизита: shopId (идентификатор магазина, раздел Настройки → Магазин) и секретный ключ (API-ключ из Настройки → API-ключи, начинается с live_ или test_).
2. В виджете: Настройки интеграции → Эквайринг → «+ Подключить терминал» → «ЮKassa (СБП QR)». Заполните shopId, секретный ключ, название, «Активен», склады BazON (хотя бы один обязателен), кому разрешён возврат. Нажмите «Протестировать подключение» (виджет проверит реквизиты без создания платежа) → «Сохранить».
3. Пропишите адрес уведомлений в ЛК ЮKassa (важный отдельный шаг — ЮKassa не получает адрес автоматически): после сохранения виджет покажет адрес для уведомлений с кнопкой «Копировать». Скопируйте → в ЛК ЮKassa Настройки → Уведомления (HTTP-уведомления) вставьте адрес и включите события payment.succeeded и refund.succeeded → сохраните. Один адрес обслуживает все ваши магазины ЮKassa этого аккаунта и оба типа событий.

Выставление счёта и возврат — как у других банков.

Ограничения и частые вопросы.

• «Неверные реквизиты» — проверьте shopId и ключ без пробелов, ключ должен начинаться с live_/test_.
• Оплатил, статус не сменился — прописан ли адрес уведомлений в ЛК и включено ли payment.succeeded; найдите платёж в таблице, «Обновить».
• Несколько магазинов — отдельный терминал на каждый (свои shopId + ключ), адрес уведомлений общий, прописывается один раз.
• Возврат сделали напрямую в ЛК ЮKassa мимо виджета — платёж останется «Оплачен», в аудит-журнале появится «возврат сделан вне виджета — нужна ручная сверка» (деньги клиенту при этом возвращаются).
• Безопасность: shopId и ключ шифруются AES-GCM, ключ не логируется. ЮKassa не подписывает уведомления, поэтому на каждое виджет перезапрашивает статус напрямую у ЮKassa и доверяет только этому ответу — подделать оплату нельзя. Возврат защищён ACL + капчей.

Брендирование QR-кода

Что делает. Оформляет QR оплаты по СБП тремя независимыми элементами (каждый со своей галочкой/полем): логотип СБП в центре (QR обтекает его на белой подложке, сканируется по-прежнему); подпись сверху (любой текст, обычно реквизиты продавца, до 40 символов); номер заказа снизу (Заказ №…, автоматически из номера сделки). Можно включить всё, что-то одно или ничего. Настройка отдельная для каждого терминала, работает для всех банков.

Как настроить.

1. Откройте Настройки виджета → Интеграции → Эквайринг.
2. Создайте терминал или откройте существующий на редактирование.
3. В блоке «Что показывать на QR-коде»: отметьте «Логотип СБП в центре»; отметьте «Номер заказа снизу»; впишите текст в «Подпись сверху» (до 40 символов).
4. Сохраните терминал. Новые платежи терминала будут с этим оформлением, уже созданные подхватят его при следующей загрузке карточки.

Ограничения и частые вопросы.

• Ничего не отмечено и подпись пуста — обычный чистый QR.
• Логотип безопасен для сканирования; если сканер капризный — снимите галочку логотипа, подпись и номер останутся.
• Номер заказа берётся автоматически; нет номера — нижняя строка не рисуется даже с галочкой.
• Логотип общий (СБП), свой загрузить пока нельзя.
• Слишком длинная подпись аккуратно обрежется с «…».
• QR всегда чёрно-белый (лучше сканируется и печатается).

Договор-счёт

Что делает. Документ по сделке, который менеджер скачивает в PDF или PNG прямо из карточки и отдаёт покупателю. Внутри QR для оплаты, ваши реквизиты, по желанию подпись и печать. Два типа:

• Динамический — привязан к терминалу эквайринга, QR берётся из конкретного платежа (тот же, что видит покупатель). Кнопка «ДС» появляется на карточке платежа.
• Статический — отдельный шаблон с постоянной картинкой QR, которую вы загружаете один раз. Доступен из списка документов сделки.

Как настроить. Настройки → Настройки интеграции → Договор-счёт.

1. Нажмите «+ Шаблон».
2. Укажите название и тип (динамический или статический).
3. Для динамического выберите терминал эквайринга.
4. Заполните реквизиты продавца — заменяют блок «Продавец:» в документе (обязательно).
5. Нажмите «Сохранить» — станет доступна загрузка картинок.
6. По желанию загрузите подпись и печать (не загрузите — документ без них).
7. Для статического обязательно загрузите картинку QR и при желании ссылку под ним.

Менеджер: динамический — на карточке платежа кнопка «ДС», выбрать формат (PDF/PNG), скачать. Статический — открыть список документов сделки, выбрать договор-счёт, скачать. Файл генерируется на сервере и сразу скачивается, на сервере не хранится.

Ограничения и частые вопросы.

• Отправка договор-счёта покупателю по мессенджерам пока недоступна (в работе) — сейчас только скачивание.

Связанные разделы

• Работа со сделкой
• Автоматизация и воронки
• Аналитика и журнал — диагностика платежей