Подключение PayKeeper для приема платежей по ссылке

Возможности

Гибкое выставление счетов и удобная отправка ссылки на оплату: сохраняйте и выставляйте своим клиентам счета на оплату товаров и услуг картами Visa, MasterCard и МИР по электронной почте, в социальные сети, мессенджеры или в SMS.
Соответствие требованиям 54-ФЗ и передача данных корзины: при создании счета автоматически передаются все позиции из корзины — товары или услуги, их количество и реквизиты налогообложения. Это помогает соблюдать требования законодательства и избавляет от лишних ручных действий при фискализации. Все проходит корректно и прозрачно — как для бизнеса, так и для клиента.
Проведение и контроль оплаты прямо в визите: после успешной оплаты по выставленному счету система автоматически фиксирует платеж. Вам не нужно вручную проверять поступления или обновлять статусы — все происходит в реальном времени.
Модуль работает на базе API-возможностей платежной платформы PayKeeper — это открывает доступ к истории операций, статусам платежей и подробной аналитике. Личный кабинет позволяет контролировать полную картину по каждому платежу.
Упрощенный путь клиента к оплате: благодаря автоматизированной логике, от выставления счета до подтверждения оплаты, — процесс приема платежей становится максимально простым. Клиенту достаточно перейти по ссылке и оплатить счет в пару кликов. Это сокращает число незавершенных платежей и делает взаимодействие с вашим сервисом комфортным и предсказуемым.

Условия работы:

Подключение с крупнейшими банками РФ: «ВТБ», «Газпромбанк», «Альфа-Банк», «Райффайзенбанк», «Точка Банк», «Банк Санкт-Петербург», «Банк Русский Стандарт», «Промсвязьбанк» и другими.
Комиссия интернет-эквайринга: от 0,55% до 1,95% (рассчитывается индивидуально в зависимости от вида деятельности и условий банка) без абонентской платы.
Актуальные ставки комисии по СБП: от 0,4% до 0,7% в зависимости от вида деятельности.
Доступна фискализация согласно 54-ФЗ. Для фискализации от PayKeeper необходимо подключить облачную кассу PayKeeper Касса с фискальным накопителем на 15 или 36 месяцев. В отличие от облачных касс других платежных систем, в этом случае оплачивается аренда облачной кассы на выбранный срок, но при этом нет комиссии за каждую операцию фискализации.
Подключение доступно для юридических лиц и ИП. Сервис недоступен для самозанятых (из-за ограничений банков).

Важно

Интеграция YCLIENTS и PayKeeper работает только для приема платежей по ссылке через СБП.

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

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

Подключение

1. Перейдите на сайт PayKeeper по ссылке и оставьте заявку на подключение. Менеджер PayKeeper перезвонит вам и расскажет про детали подключения.

Срок подключения зависит от сроков согласования эквайринга от банка.

2. После одобрения заявки авторизуйтесь в выданном вам личном кабинете PayKeeper. Данные для авторизации придут на ваш email.

3. Перейдите в раздел «Настройки».

4. Перейдите на вкладку «Получение информации о платежах» и настройте поля:

Способ получения уведомления о платежах — выберите «POST-оповещения».
URL, на который будут отправляться POST-запросы — эту ссылку необходимо будет указать после подключения интеграции в YCLIENTS.
Ссылка имеет вид https://yclients.paykeeper.ru/api/result/xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx, где вместо xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx у вас будет свое значение. После подключения интеграции снова вернитесь к этой настройке.
Секретное слово — для генерации секретного слова нажмите кнопку «Сгенерировать». Это слово потребуется указать при настройке интеграции в YCLIENTS.

Нажмите «Сохранить» для применения изменений.

5. Перейдите на вкладку «Получение информации о платежах» и настройте поля:

Пропускать служебные страницы PayKeeper — если поставить галочку, то указанные страницы ниже будут показываться, минуя служебные страницы.
URL страницы, на которую клиент переходит при успешном завершении оплаты — укажите ссылку https://yclients.paykeeper.ru/success, либо любую другую страницу по вашему желанию.
URL страницы, на которую клиент переходит при неудаче в процессе оплаты — укажите ссылку https://yclients.paykeeper.ru/fail, либо любую другую страницу по вашему желанию.

Нажмите «Сохранить» для применения изменений.

Настройка личного кабинета PayKeeper завершена, теперь можно перейти к настройке интеграции в YCLIENTS.

Настройка интеграции

1. Перейдите в раздел «Интеграции > Прием платежей» и выберите приложение «PayKeeper».

2. На открывшейся странице нажмите кнопку «Подключить».

3. Подтвердите предоставление приложению «PayKeeper» доступа к вашему филиалу, для этого нажмите «Продолжить». Если в вашей сети несколько филиалов, до этого шага также выберите филиалы, где хотите подключить приложение, и нажмите «Далее».

4. После подтверждения откроется форма регистрации, которую необходимо заполнить.

Адрес личного кабинета PayKeeper — укажите URL личного кабинета PayKeeper, который вы получили на вашу почту после регистрации. Адрес кабинета необходимо указать в формате: https://example.server.paykeeper.ru, где вместо example — название вашего кабинета. Указать необходимо именно вашу ссылку, данная ссылка указана для примера.
Секретное слово PayKeeper. Укажите секретное слово из личного кабинета PayKeeper, которое ранее было сгенерировано в разделе «Настройки» → «Получение информации о платежах».
Имя пользователя PayKeeper — укажите логин пользователя, которого можно создать специально для этого в личном кабинете PayKeeper в разделе «Настройки» → «Доступ к панели администратора». Можно также использовать данные уже созданного пользователя.
Пароль PayKeeper — укажите пароль созданного выше пользователя PayKeeper.

Имя пользователя YCLIENTS — укажите логин (номер телефона или почта), через который вы авторизуетесь в YCLIENTS.
Пароль YCLIENTS — укажите пароль указанного выше пользователя YCLIENTS.

Нажмите кнопку «Сохранить».

5. После успешного подключения на экране отобразится ссылка для POST-уведомлений об успешной оплате (ее мы уже упоминали ранее в блоке подключения в п. 4).

Скопируйте ссылку и вернитесь в личный кабинет PayKeeper в раздел «Настройки» → «Получение информации о платежах».

В поле «URL, на который будут отправляться POST-запросы» вставьте скопированную из YCLIENTS ссылку и нажмите «Сохранить».

6. После сохранения URL для уведомления в личном кабинете PayKeeper вернитесь в приложение «PayKeeper» в YCLIENTS на вкладку «Настройки». Обновите страницу, если отображается URL, после появятся настройки работы интеграции:

Выберите, при каком статусе записи создавать счет — эта опция позволяет выбрать, при каком статусе визита будет автоматически создаваться счет на оплату в личном кабинете PayKeeper: «Ожидание клиента», «Клиент пришел», «Клиент не пришел», «Клиент подтвердил».
Передавать корзину — если включено, то приложение будет передавать состав заказа в личный кабинет PayKeeper для чека.
Отправлять уведомления YCLIENTS — если включено, то приложение через YCLIENTS будет автоматически отправлять ссылку на оплату по email и SMS, если у клиента указана почта и телефон. При этом данные каналы отправки сообщений должны быть подключены в YCLIENTS.
Отправлять уведомления PayKeeper — если включено, то приложение через PayKeeper будет автоматически отправлять ссылку на оплату по email, если у клиента указана почта.

Остальные поля можно не заполнять, они нужны только для изменения регистрационных данных.

7. Нажмите кнопку «Сохранить настройки» для применения изменений.
Готово, интеграция полностью настроена!

Работа с PayKeeper в YCLIENTS

1. Клиент записывается онлайн или через администратора. Запись может быть создана любым способом — в журнале записи в веб-версии YCLIENTS, в мобильном приложении YCLIENTS, онлайн через виджет онлайн-записи, YPLACES, брендированное приложение или другую интеграцию.

Запись также может быть, как индивидуальной, так и на групповое событие.

После создания записи платежное приложение PayKeeper начинает отслеживать изменение ее статуса.

2. После установки статуса записи («Ожидание», «Пришел», «Не пришел», «Подтвердил»), который был настроен в разделе «Интеграции > Прием платежей» в приложении «PayKeeper», в личном кабинете PayKeeper будет автоматически сгенерирован счет.

Например, если в настройках приложения выбран статус «Клиент подтвердил запись», то счет на оплату будет создан после смены статуса записи на «Подтвердил».

3. Если в настройках приложения «PayKeeper» в разделе «Интеграции > Прием платежей» включена опция «Отправлять уведомления PayKeeper», то ссылка на оплату этого счета будет автоматически отправлена по email, указанному клиенту в записи (если в карточке клиента указан email).

Если будет включена опция «Отправлять уведомления YCLIENTS», то ссылка на оплату этого счета будет автоматически отправлена на email и SMS, но при условии, что в YCLIENTS настроен канал «SMS» и подключен SMS-агрегатор или чат-бот.

4. Ссылку на оплату также можно скопировать вручную в окне записи в разделе «Ссылка на оплату». Скопированную ссылку можно отправить вручную любым удобным способом: по SMS, в мессенджеры, соцсети или на почту.

Также в этом же разделе ссылку на оплату администратор может создать самостоятельно через кнопку «Создать счет», если счет еще не был создан автоматически (например, если статус визита еще не изменен).

Важно

Раздел «Ссылка на оплату» доступен только в новой версии окна записи в веб-версии программы.
В мобильном приложении YCLIENTS вручную скопировать или создать ссылку этим способом не получится. Также в окне группового события раздел «Ссылка на оплату» недоступен, перейти к отдельной записи события можно через раздел «Обзор > Записи», в таком случае раздел «Ссылка на оплату» отобразится.

Если после создания записи в разделе окна записи «Ссылка на оплату» появляется ошибка «Запись еще не создана. Обновите страницу!» — необходимо немного подождать или обновить страницу.

5. Клиент переходит по ссылке на оплату счета и производит оплату.

6. Платежное приложение PayKeeper автоматически добавляет успешно совершенную оплату в запись. Все счета и платежи также будут отражены в личном кабинете PayKeeper.

Возврат средств

1. Возврат средств клиенту производится через личный кабинет сервиса PayKeeper в разделе «Платежи». Для возврата нажмите на нужную транзакцию и нажмите на «Полный или частичный возврат платежа».

2. Выберите, какой возврат произвести — полный или частичный. Если частичный, то укажите сумму.

3. Нажмите «Вернуть платеж» и подтвердите возврат через кнопку «Подтвержить платеж».

Важно

Отмена платежа — необратимая операция. Указанная сумма будет возвращена плательщику.

4. Статус возврата можно отслеживать в разделе «Платежи» в колонке «Статус», а также в самой транзакции на вкладке «Возврат». Как только банк одобрит возврат, статус платежа сразу изменится. При этом средства вернутся клиенту не моментально, сроки также зависят от работы банка, обычно возврат осуществляется в течение нескольких дней.

Важно

После возврата средств через PayKeeper в YCLIENTS оплата визита не будет удалена автоматически. Чтобы удалить отмененную оплату, обратитесь в техническую поддержку YCLIENTS.

Контакты

Все контакты для обращения в техническую поддержку PayKeeper доступны по ссылке: https://paykeeper.ru/technical-support/

Предыдущая статья Подключение bePaid для приема онлайн-предоплаты в виджете (Беларусь)

Следующая статья Настройки онлайн-платежей в YCLIENTS

Была ли статья полезна?