Настройка онлайн-оплаты

7 мин
Продолжительность урока
Онлайн-оплата является наиболее удобным способом расчёта на сайте и в мобильном приложении. В настоящее время подключение онлайн-эквайринга возможно только со следующими банками или сервисами:

  • Альфа-банк
  • ЮКасса
  • CloudPayments

Юкасса — это платформа для приема онлайн-платежей, которая предоставляет возможность легко обрабатывать транзакции, обеспечивая безопасность и удобство для клиентов. Интеграция с Юкасса открывает перед бизнесом новые горизонты: автоматизация процессов, сокращение времени на обработку платежей и улучшение пользовательского опыта.

В этой статье мы подробно рассмотрим основные аспекты настройки интеграции с Юкасса, а также преимущества, которые она может принести вашему бизнесу.
Настройка интеграции с Юкасса
Основные особенности интеграции с Юкасса
1. Удобство настройки:
  • Интеграция с Юкасса не требует глубоких технических знаний. Платформа предлагает подробные инструкции и документацию, что позволяет быстро и легко настроить прием платежей.

2. Разнообразие платёжных методов:
  • Юкасса поддерживает множество способов оплаты, включая банковские карты, электронные кошельки и мобильные платежи. Это позволяет клиентам выбирать наиболее удобный для них метод.

3. Безопасность транзакций:
  • Платформа обеспечивает высокий уровень безопасности, используя современные технологии шифрования и защиты данных. Это создает доверие у клиентов и снижает риски мошенничества.

4. Аналитика и отчётность:
  • Юкасса предоставляет инструменты для анализа финансовых показателей, что помогает бизнесу лучше понимать свои продажи и оптимизировать процессы.
Автоматизация процессов:
  • Интеграция позволяет автоматизировать обработку платежей, что снижает вероятность ошибок и экономит время сотрудников.

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

Гибкость и масштабируемость:
  • Юкасса подходит как для малых, так и для крупных бизнесов, предоставляя возможность масштабирования по мере роста компании.
Как настроить ЮKassa?
Для этого необходимо заключить договор, перейдя по реферальной ссылке, это даст специальную скидку. Важно отметить, что скидка доступна только новым клиентам и только при переходе по ссылке.

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


После заключения договора новый тип онлайн-оплаты настраивается в разделе: Справочники > Подразделение > Настройки подразделения (значок карандаша) > Возможные типы оплаты (меню справа).


На странице «Возможные типы оплаты» необходимо установить галочку в пункте «Оплата онлайн». После этого появится поле «Онлайн банк», в котором следует выбрать ЮKassa.


Далее нужно ввести данные, полученные от ЮКассы, в соответствующие поля:

ЮKassa shop id (Идентификатор магазина):
  • Укажите идентификатор вашего магазина, предоставленный ЮКассой.

ЮKassa cекретный ключ:
  • Внесите секретный ключ для обеспечения безопасности транзакций.

Внизу страницы нажимаем кнопку Сохранить.

Эти данные необходимы для корректной работы системы и успешной обработки платежей через ЮКассу. Убедитесь, что все введенные данные верны, чтобы избежать ошибок при проведении транзакций.
Настройка личного кабинета Юкассы
Чтобы заказы поступали в систему Гуляш без задержек, необходимо обязательно настроить интеграцию и в личном кабинете ЮKassa. Если этот шаг не будет выполнен, заказы в Гуляш будут поступать только спустя несколько часов.

Настройка интеграции достаточно проста и не требует специальных знаний.

Для настройки HTTP-уведомлений на платформе ЮKassa, следуйте приведенным ниже шагам:
Начните с перехода на сайт ЮKassa. Введите свои учетные данные, чтобы войти в личный кабинет.

Переход в раздел Интеграция:
  • В левой части экрана вы увидите меню. Найдите раздел под названием «Интеграция» и кликните на него, чтобы открыть дополнительные параметры.

Выбор HTTP-уведомлений:
  • В открывшемся подменю выберите опцию «HTTP-уведомления». Это позволит вам настроить уведомления о статусах платежей.

Настройка URL для уведомлений:

Включение тумблеров:
  • Ниже вы найдете четыре тумблера, отвечающих за различные настройки уведомлений. Убедитесь, что все они находятся в положении «включено». Это позволит системе отправлять уведомления по всем необходимым событиям.

Сохранение изменений:
  • После выполнения всех вышеуказанных настроек, не забудьте нажать кнопку «Сохранить». Это зафиксирует ваши изменения и активирует настройки уведомлений.
Следуя этим шагам, вы сможете успешно настроить уведомления о платежах в ЮKassa для вашей компании, что обеспечит своевременное получение информации о статусах транзакций.

Важно! Необходимо отключать фискализацию (регистрация платежей и печать чеков, чтобы налоговые органы могли видеть доходы предпринимателей) на стороне ЮКассы.
Если мы не отключим фискализации, то проведение онлайн-платежей невозможно - система будет блокировать операции и выводить сообщение об ошибке.

Настройка интеграции со Сбербанком
На текущий момент Сбер подключает новых клиентов только на Юkassa. Это важное условие, которое необходимо учитывать при интеграции и настройке услуг!


Подготовка к настройкам:

Актуализация пользовательского соглашения:
  • Обновите текст пользовательского соглашения на вашем сайте, чтобы он соответствовал требованиям вашей компании.
Создание лендинга:
  • Разработайте лендинг на сайте с перечислением возможных типов оплат и реквизитами вашей компании.
Запрос боевых учетных данных:
  • Свяжитесь с менеджером Сбербанка для получения боевых логина и пароля для интеграции. Если получите тестовые данные, сообщите, что вам нужен доступ к боевой среде.
Доступ к личному кабинету:
После получения данных, перейдите по ссылке из письма на личный кабинет и войдите под логином -operator. Не забудьте сменить пароль.


Настройка Гуляша:

Интеграция по API
  • Вводим логин (Сбербанк Мерчант) и пароль от API в систему Гуляш.
ApplePay:
  • Данные по ApplePay не заполняем..


Затем в личном кабинете Сбербанка выполните следующие действия:

Перейдите в раздел Настройки. Найдите вкладку call уведомления и настройте её следующим образом:

  • Убедитесь, что в строке "Продавец" данные встали автоматически
  • Поставьте галочку на "Включить callback-уведомления".
  • В поле Ссылки введите ссылку в формате:
https://Адрес вашей системы в Гуляше/api/cart/paymentResult
Например: https://sushkof.goulash.tech/api/cart/paymentResult

  • Остальные параметры настройте в соответствии со скриншотом.
После этого нажимаем Сохранить.
Частые ошибки

Если вы сталкиваетесь с ошибкой, это может означать следующее:


1. Ошибка при входе: Если возникает ошибка, это указывает на то, что у учетной записи `-operator` не сменили пароль. Убедитесь, что вы обновили пароль после первого входа в личный кабинет.



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


Также при интеграции с Юкассой могут возникнуть определенные сложности, особенно если ваш сайт не использует CMS (систему управления контентом), такую как WordPress с плагином WooCommerce. В данной инструкции мы рассмотрим, как правильно настроить онлайн-кассу в личном кабинете Юкассы, учитывая особенности вашей системы Гуляш.


Шаг 1: Понимание работы онлайн-кассы
Онлайн-касса в настройках Юкассы работает только в том случае, если ваш сайт изначально основан на CMS, где уже настроена касса. Если вы используете собственную систему учета, например, с интеграцией WebKassa, настройка онлайн-кассы в Юкассе может быть избыточной.


Шаг 2: Проверка текущих настроек

Подключение WebKassa:
  • Убедитесь, что у вас уже настроена WebKassa в вашей системе учета. Это позволит вам отправлять электронные чеки клиентам.
Хранение фискальных данных:
  • Проверьте, что фискальные данные для чеков хранятся в вашей базе данных. Это необходимо для корректной печати и отправки чеков.


Шаг 3: Удаление настройки онлайн-кассы в ЛК Юкассы

Если вы используете WebKassa и у вас уже реализована печать чеков, то вам не нужно настраивать онлайн-кассу в Юкассе. Для этого выполните следующие действия:
  1. Войдите в личный кабинет Юкассы.
  2. Перейдите в раздел настроек.
  3. Найдите раздел «Онлайн-касса».
  4. Убедитесь, что настройки онлайн-кассы отключены. Если они включены, отключите их.

Заключение
После выполнения этих шагов ваша система будет корректно работать с WebKassa, и клиенты будут получать электронные чеки без необходимости настраивать онлайн-кассу в Юкассе. Если у вас возникнут дополнительные вопросы, обратитесь в техническую поддержку Юкассы для получения помощи.
Настройка интеграции с Альфа-банком
Перед началом интеграции с необходимо указать на сайте адрес и номер телефона.

Подключение осуществляется только через менеджера Альфа-банка -
Федорова Наталья, по номеру +7 905 806 77 05 или +7 922 11 54 776, e-mail: nfedorova4@alfabank.ru
  • Турбо
    Важно! Обязательно укажите, что вы представляете Гуляш, подтвердите с ней условия и уточните последующие шаги. Если вы сначала обратитесь к другому менеджеру, а затем к Наталье, согласовать льготные условия не удастся. Для получения индивидуальных условий необходимо обязательно сначала обращаться к Наталье.
Важно! Если подключение не будет осуществлено через Наталью, могут возникнуть проблемы интеграции с Гуляшом. Важно, чтобы со стороны Альфа-банка было подключение на шлюз РБС1.
После регистрации на почту будет отправлено письмо со ссылкой для входа в личный кабинет. (В начале придет доступ к тестовой среде. Все настройки производим из письма с доступом к продуктовой среде)

1. Необходимо открыть личный кабинет Альфа-банка (https://pay.alfabank.ru/lk/login). Ссылка на доступ так же будет в письме от Альфа-банка "Реквизиты для подключения к продуктивной среде".

2. Затем нужно изменить пароли для -operator и -api и записать пароли. Рекомендуется использовать одинаковые пароли.

3. В Системе учета необходимо указать реквизиты для логина -api (логин для Альфа-банк мерчант и пароль для Альфа-банк).

Важно: не перепутайте их с полями для оплаты по QR!

Также обратите внимание: даже если данные для онлайн-оплаты и оплаты по QR совпадают, их необходимо заполнить отдельно в обоих разделах.

4. Необходимо отправить письмо на адрес acquiring@alfabank.ru с темой “Подключение уведомлений Callback”.

В письме нужно указать:

  • Логин (api);

  • Типы заказов - успешные

  • Тип callback уведомлений - здесь выбор зависит от наличия оплаты по СБП:
– Если к Альфа-Банку подключена только онлайн-оплата выбирайте статические, а также укажите URL, на который будут приходить уведомления:
в формате - https://Адрес вашей системы в Гуляше/api/cart/paymentResult.
Пример: https://sushkof.goulash.tech/api/cart/paymentResult.

– Если подключены СБП и онлайн-оплата (эквайринг) выбирайте динамические, URL указывать не нужно.


Готово!
Важно! В настройках платежной страницы в личном кабинете Альфа-Банка отключите альтернативные способы оплаты, чтобы осталась только оплата по банковской карте. Через альтернативные способы оплаты заказ может не отобразиться в Гуляше!
Настройка интеграции с CloudPayments
1
Оставьте заявку на сайте https://cloudpayments.ru/
2
Дождитесь ответа менеджера и сообщите ему что подключение требуется для работы в системе Goulash.Tech
3
Получите логин и пароль
4
Пропишите вебхуки в личном кабинете CloudPayments
Перейдите по пути:

Сайты → выберите сайт → Уведомления

Заполните блоки по примеру на скриншоте, изменив только поддомен на название вашего бренда.
  • Check: https://ВАШЕНАЗВАНИЕ.goulash.tech/api/cart/paymentResultCloud/type/check
  • Pay: https://ВАШЕНАЗВАНИЕ.goulash.tech/api/cart/paymentResultCloud/type/pay
  • Fail: https://ВАШЕНАЗВАНИЕ.goulash.tech/api/cart/paymentResultCloud/type/fail
  • Refund: https://ВАШЕНАЗВАНИЕ.goulash.tech/api/cart/paymentResultCloud/type/refund
Нажмите Сохранить уведомления.
5
Введите данные в систему
В разделе Возможные типы оплаты в нужном вам подразделении выберите CloudPayments в поле Онлайн-банк.
Далее ведите данные для тестового входа в соответствующие поля.
Также вы можете подключить платежный виджет для мобильного приложения.
Преимущества и возможности виджета:

  • Поддержка работы через VPN, что обеспечивает стабильность и доступность оплаты.
  • Гибкая настройка внешнего вида и параметров под особенности вашей компании.
  • Доступность различных способов оплаты: не только оплата по QR-коду или банковской картой, но и СБП, СберПэй, Т-Пэй и другие сервисы.
  • Возможность самостоятельно задавать порядок отображения способов оплаты внутри виджета (например, приоритет СберПэй или оплата картой).

Управление всеми настройками виджета выполняется напрямую через личный кабинет CloudPayments.
Понравился материал?