Модуль интеграции с Ю.Касса

Разработчику

Модуль интеграции с Ю.Касса

 

Подключение модуля

Чтобы включить модуль Ю.Кассы, зайдите в настройки аккаунта (значок шестеренки), раздел Модули и нажмите бегунок справа от названия модуля.

Первоначально нам будут доступны две настройки:

Идентификатор магазина – сюда необходимо вставить shopId вашего магазина (только цифры).

Ключ  API – секретный ключ для отправки запросов в API, позволяет КБ совершать в ЮKassa любые операции. 

Чтобы найти идентификатор вашего магазина и ключ API, необходимо войти в личный кабинет Кассы – Интеграции – Ключи API.

Обратите внимание! Если в вашем магазине нет раздела Интеграции, значит ваш магазин подключен по протоколу HTTP (если он был подключен несколько лет назад), для перехода на протокол API обратитесь к вашему менеджеру Ю.Кассы.

Если вы ввели верные данные, вы увидите сообщение: Авторизация пройдена успешно. Можно приступать непосредственно к настройке модуля.

Нажимаем кнопку Добавить таблицу. Здесь необходимо выбрать таблицу, в которой вы будете выписывать счета (синхронизацию можно настроить с несколькими таблицами).

Далее производим настройки:

Сумма платежа – поле, в котором будет храниться сумма платежа.

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

Описание платежа – поле, в котором будет храниться описание платежа.

Оплаченная сумма – поле, в которое автоматически будет записана сумма оплаты, когда она будет совершена.

Дата платежа –  поле, в которое автоматически будет записана дата оплаты, когда она будет совершена.

Статус платежа –  поле, в которое будет записан статус платежа. Требуется выбрать поле типа список со статусами: "Новый", "Ожидает подтверждения", "Оплачен", "Отменен". Вы можете создать новое поле либо использовать существующее. Необходимо соотнести статусы для корректной работы модуля. 

Автоприем платежа (рекомендуется по умолчанию) – по умолчанию галочка уже проставлена. Это необходимо, чтобы каждый раз не посещать личный кабинет Ю.Кассы и подтверждать прием оплаченного покупателем платежа.

Автогенерация ссылок – данная опцией отвечает за выбор метода создания платежа. Если поставить галочку, счет в Ю.Кассе будет создаваться автоматически при создании счета в КБ. Если галочку снять, то для выписки счета в Ю.Кассе нужно будет нажать ДД Я.Касса (создать).

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

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

Выписка и проведение счетов

Выпишите счет привычным образом. Если вы поставили галочку Автогенерация ссылки, то в счете вы увидите ссылку на счет (это поле создается автоматически).

Если же вы не ставили галочку, нажмите ДД Я.Касса (создать). 

Сгенерированную ссылку можно отправить клиенту любым удобным способом – в рассылке, в скайпе, по смс или в любом менеджере. При переходе по ней клиент сразу попадает в окно оплаты.

После того как клиент оплатит ваш счет, статус платежа автоматически сменится на «Оплачен». Для удобства вы можете настроить на это поле напоминание, цветовое форматирование или информер.

В ЮKassa у платежа ограничено время на оплату. Если пользователь не подтвердит оплату до окончания этого срока, ЮKassa отменит платеж. Чтобы пользователь смог оплатить, вам нужно создать новый платеж.