Пробовать бесплатно
0

Интеграция с Точка Банком

Интернет-эквайринг Точка Банка позволяет принимать оплату заказов банковской картой или через СБП. При оформлении заказа покупатель переходит по платёжной ссылке банка, оплачивает и возвращается в магазин, а Addshop сам проверяет оплату у банка и отмечает заказ как оплаченный.

Вы можете создать интернет магазин за 1 вечер. Просто выберите готовый шаблон интернет магазина и установите его. Останется только наполнить его своими товарами.

В статье — что получить в интернет-банке Точки, как заполнить настройки в Addshop, как создать способ оплаты, настроить чеки, проверить подключение и решить типичные проблемы.

Что понадобится

  • Расчётный счёт в Точке с подключённым интернет-эквайрингом. Условия и комиссию сообщает банк.
  • JWT-токен API с доступом к интернет-эквайрингу. Его выпускают в интернет-банке Точки.
  • Код клиента — 9 цифр. Его показывает интернет-банк.
  • Идентификатор торговой точки — 15 цифр. Нужен, только если торговых точек несколько.
  • Для чеков 54-ФЗ — онлайн-касса партнёра Точки или облачная касса АТОЛ Онлайн (подробнее в разделе «Чеки 54-ФЗ»).

Шаг 1. Подготовка в интернет-банке Точки

  1. Войдите в интернет-банк Точки и откройте раздел «Интеграции и API».
  2. Выпустите JWT-токен с доступом к интернет-эквайрингу. Скопируйте его сразу и сохраните в надёжном месте — токен длинный, его удобно вставлять, а не перепечатывать.
  3. Найдите код клиента (9 цифр). Если у вас несколько торговых точек эквайринга, найдите идентификатор нужной точки (15 цифр).
  4. Настройте уведомления об оплате (вебхук acquiringInternetPayment) на адрес https://ваш-домен/tochka-handler/. Вместо «ваш-домен» подставьте адрес вашего магазина. Точный адрес показан на странице настроек Точки в Addshop.

Если не получается найти нужный раздел или настроить вебхук, обратитесь в поддержку Точки или к вашему менеджеру — расскажите, что нужен токен для интернет-эквайринга и вебхук на указанный адрес.

Шаг 2. Настройка в Addshop

Откройте админку, перейдите в «Остальные настройки» → «Интеграции» и в блоке «Платежные системы» нажмите на логотип Точки. Или откройте по ссылке: настройки Точки.

Принимать оплату

Главный переключатель. Включить его можно, только если сохранены JWT-токен и код клиента, иначе появится сообщение «Для приёма оплаты укажите JWT-токен API и код клиента».

JWT-токен API

Токен из раздела «Интеграции и API». После сохранения он скрыт, в поле видна подсказка «сохранён — оставьте пустым, чтобы не менять». Пустое поле при сохранении оставляет прежний токен. Если вы перевыпустили токен в банке, впишите новый.

Код клиента

9 цифр из интернет-банка. Все символы, кроме цифр, Addshop отбросит сам. Если цифр не 9, появится ошибка «Код клиента Точки — 9 цифр».

Идентификатор торговой точки

Необязательное поле. Заполните, если у вас несколько торговых точек эквайринга и оплата должна идти на определённую. Должно быть ровно 15 цифр, иначе появится ошибка «Идентификатор торговой точки — 15 цифр».

Передавать чек

Если включить, вместе с платежом в банк передаётся состав заказа для чека 54-ФЗ. Нужно, только если чеки пробивает онлайн-касса партнёра Точки. Подробнее — ниже.

Нажмите «Сохранить». Появится надпись «Изменения успешно внесены», у логотипа Точки в списке интеграций — зелёная галочка.

Тестового режима у этой интеграции нет: все платежи настоящие. Как проверить подключение — в разделе «Как проверить».

Шаг 3. Способ оплаты

  1. Откройте раздел «Оплата» в верхнем меню админки.
  2. Нажмите «Добавить».
  3. В поле «Название» напишите, например, «Картой или через СБП».
  4. В поле «Описание» можно пояснить: «После оформления заказа вы перейдёте на страницу оплаты Точка Банка».
  5. В поле «Система оплаты» выберите Точка.
  6. При необходимости укажите «Наценка %» — процент, который добавится к сумме заказа.
  7. В блоке «Связь со способами доставки» отметьте доставки, при которых доступна онлайн-оплата.
  8. Сохраните способ оплаты.

Чеки 54-ФЗ

Вариант 1. Касса партнёра Точки

Включите «Передавать чек». Тогда в банк уходит платёж с чеком: каждый товар с ценой за единицу и количеством, доставка и наценка — как услуги. Сумма строк чека равна сумме заказа.

  • Ставка НДС, способ и предмет расчёта — из карточки товара, а если там не заданы — из «Настроек платежей» магазина (поля «Налог», «Метод платежа», «Объект платежа»).
  • Система налогообложения — из поля «Система налогообложения» в «Настройках платежей».
  • Ставки НДС 22 % и 22/122 Точка принимает.
  • Для чека нужен e-mail покупателя. Если включено «Передавать чек», а покупатель не указал e-mail при оформлении, заказ в банк не передаётся. Поэтому при включённом чеке сделайте поле e-mail в форме заказа обязательным.

Вариант 2. АТОЛ Онлайн

Если касса у вас в АТОЛ Онлайн, выключите «Передавать чек» в настройках Точки, а в настройках АТОЛ Онлайн отметьте Точку среди способов оплаты. Иначе чек пробьётся дважды. Подробно — в статье Чеки 54-ФЗ через АТОЛ Онлайн. Общие сведения — в статье Как настроить онлайн-чеки 54-ФЗ.

Как проверить

  1. Создайте в каталоге недорогой тестовый товар или используйте самый дешёвый товар.
  2. Откройте витрину в другом браузере или в режиме инкогнито, оформите заказ с созданным способом оплаты. Если включён чек — обязательно укажите e-mail.
  3. Вы перейдёте на страницу оплаты Точки. Оплатите картой или через СБП.
  4. После оплаты вы вернётесь на страницу «Заказ оформлен». В этот момент Addshop запрашивает у банка состояние платежа.
  5. Откройте заказ в админке — у него должна стоять отметка «Оплачен».
  6. Чтобы проверить уведомления, сделайте ещё одну оплату и закройте вкладку сразу после оплаты, не возвращаясь в магазин. Если заказ всё равно отметился — вебхук работает.
  7. Верните тестовые платежи через интернет-банк Точки.

Как это работает после подключения

  • Оформление. Покупатель выбирает способ оплаты, связанный с Точкой, и нажимает «Оформить заказ». Addshop сохраняет заказ, создаёт в банке платёжную ссылку на итоговую сумму (товары со скидкой, доставка и наценка) с оплатой картой и через СБП и отправляет по ней покупателя.
  • Если банк не принял платёж. Покупатель видит сообщение «Не удалось перейти к оплате в Точке. Заказ сохранён, магазин свяжется с вами».
  • Подтверждение оплаты. Addshop не доверяет содержимому уведомления. При возвращении покупателя и по вебхуку банка магазин сам запрашивает операцию в Точке и ставит отметку «Оплачен», только если банк подтвердил оплату, операция создана для этого заказа и сумма совпадает с суммой заказа.
  • Если банк временно не ответил на проверку, Addshop отвечает на вебхук ошибкой, и Точка повторит уведомление.
  • Оплата не прошла. Покупатель попадает на страницу «Оплата не прошла», заказ остаётся неоплаченным.
  • Если магазин заблокирован за неоплату тарифа, адрес /tochka-handler/ продолжает работать.

Частые проблемы и решения

Покупатель оплатил, а заказ не отмечен «Оплачен»

Если покупатель не вернулся в магазин после оплаты, отметку ставит только вебхук. Проверьте, что уведомление acquiringInternetPayment настроено на https://ваш-домен/tochka-handler/ и что в Addshop включено «Принимать оплату» и сохранён действующий токен.

Сумма заказа изменилась после оформления

Если вы изменили заказ после того, как покупатель перешёл к оплате, оплаченная сумма не совпадёт с новой суммой заказа и отметка не поставится. Сверьте платёж в интернет-банке и поставьте отметку «Оплачен» вручную.

Покупатель видит «Не удалось перейти к оплате в Точке»

Частые причины: токен просрочен, отозван или выпущен без доступа к интернет-эквайрингу, неверный код клиента или идентификатор торговой точки, включён чек, но покупатель не указал e-mail. Проверьте данные и, если чек включён, сделайте e-mail обязательным в форме заказа.

Ошибка «Код клиента Точки — 9 цифр» или «Идентификатор торговой точки — 15 цифр»

В поле вписано неверное количество цифр. Скопируйте значение из интернет-банка заново. Идентификатор торговой точки можно оставить пустым, если точка одна.

Перестали проходить оплаты после перевыпуска токена

Старый токен перестал действовать. Впишите новый токен в поле «JWT-токен API» и сохраните.

Чек пробился дважды

Одновременно включены «Передавать чек» в Точке и отправка чеков через АТОЛ Онлайн для Точки. Оставьте что-то одно.

Вопросы и ответы

Какими способами покупатель может оплатить?

Addshop предлагает банку два способа: карта и СБП. Какие из них увидит покупатель, зависит от условий вашего эквайринга в Точке.

Сколько стоит подключение?

Addshop не берёт отдельной платы за интеграцию. Комиссию за эквайринг устанавливает банк.

Есть ли тестовый режим?

Нет, все платежи настоящие. Проверяйте подключение оплатой на небольшую сумму и возвращайте её через интернет-банк.

Зачем идентификатор торговой точки?

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

Что делать при смене домена?

Обновите адрес вебхука в Точке на https://новый-домен/tochka-handler/.