ЮKassa
Модуль - Платежный шлюз
v1.0.0
Бесплатно
Описание модуля
Рекомендуемая версия FirstWork: 1.0.x
Модуль ЮKassa позволяет вашей платформе работать с деньгами. Он дает два основных инструмента.

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

После успешной оплаты баланс увеличивается автоматически.

2. Выплаты пользователям
Пользователь создает запрос на вывод. Финансовый модератор проверяет его и подтверждает выплату.

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

Если при подтверждении выплаты появляется ошибка, система покажет сообщение от ЮKassa. Это означает, что в настройках ЮKassa что то указано неправильно. Чаще всего проблема в неверных данных для выплат или в том, что выплаты не подключены в личном кабинете ЮKassa.
Информация
Инструмент позволяет подключить финансовые операции через ЮKassa и использовать их на платформе. Он обеспечивает два основных процесса: пополнение баланса и отправку средств пользователям. При оплате баланс увеличивается автоматически, а при выводе средств запрос сначала проходит проверку модератором, после чего деньги отправляются на карту. Если во время подтверждения выплаты появляется ошибка, система покажет сообщение от ЮKassa — это обычно связано с неправильными параметрами или отсутствием подключённой функции выплат в личном кабинете сервиса.

Для работы решения нужны данные из панели ЮKassa. Для приёма платежей используются идентификатор магазина и секретный ключ. Для отправки средств требуются отдельные параметры — идентификатор и ключ для выплат. Если раздел, связанный с выплатами, отсутствует, значит эта возможность ещё не активирована, и необходимо подать заявку в ЮKassa.

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

Когда все данные собраны, их нужно внести в административной части сайта. В разделе, отвечающем за платёжные системы, выбирается ЮKassa, после чего в соответствующие поля вставляются параметры для приёма платежей и для выплат. После сохранения модуль становится активным.

В настройках ЮKassa также требуется указать два адреса: один для уведомлений о статусе платежей, второй — для возврата пользователя после оплаты.

Обычно они выглядят так:
https://домен/payment/yookassa/callback
https://домен/payment/yookassa/return

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

Для проверки выплат достаточно создать тестовый запрос и подтвердить его от имени финансового модератора. Если всё настроено корректно, средства будут отправлены на карту.

Если вывод средств не проходит, это означает, что ЮKassa отклонила запрос. Причиной могут быть неверные параметры для выплат, отсутствие подключённой функции отправки средств, ошибки в данных карты или некорректный формат передаваемой информации. В таких ситуациях стоит перепроверить настройки в личном кабинете ЮKassa.