Подключение ЮMoney (кошелёк)

Кошелёк ЮMoney — это персональный счёт физлица или самозанятого, а не мерчант-аккаунт: принимать деньги на него в 1С-Битрикс проще всего через форму приёма платежей (quickpay) и HTTP-уведомления с проверкой секретного слова. Разберём, чем кошелёк отличается от ЮKassa, как собрать форму, поймать уведомление об оплате и не забыть про ограничения кошелька и 54-ФЗ.

Кошелёк ЮMoney и ЮKassa: в чём разница

В экосистеме ЮMoney легко перепутать два разных продукта. ЮKassa — это платёжный сервис для бизнеса: под него нужен договор от ИП или юрлица, в кабинете выдаются shopId и секретный ключ, доступен полноценный API, возвраты и фискализация. Кошелёк ЮMoney — это личный счёт человека (номер начинается на 4100), и приём платежей на него устроен принципиально проще: через готовую форму перевода и уведомления.

• Кошелёк подойдёт, если вы физлицо или самозанятый, обороты небольшие, а сложный API и автоматические возвраты не нужны;
• ЮKassa нужна, если у вас ИП/ООО, важны чеки по 54-ФЗ «из коробки», СБП, рассрочка и статусы платежей по API.

Подготовка кошелька и его статус

Перед интеграцией разберитесь со статусом кошелька. У ЮMoney есть уровни идентификации — анонимный, именной и идентифицированный, — и от них зависят лимиты на входящие переводы и остаток на счёте. Для приёма оплаты от покупателей анонимного кошелька почти всегда недостаточно: упрётесь в ограничения по сумме операций и балансу.

Что нужно подготовить:

• Номер кошелька — 16 цифр вида 4100XXXXXXXXXXX, это реквизит получателя в форме;
• Повышенный статус (именной или идентифицированный) — чтобы поднять лимиты;
• Доступ в раздел настроек уведомлений ЮMoney, где задаётся URL уведомлений и секретное слово для проверки подписи.

Форма для приёма платежей (quickpay)

Основной инструмент приёма на кошелёк — форма quickpay. Это HTML-форма, которая отправляет покупателя на страницу оплаты ЮMoney с уже подставленными реквизитами получателя и суммой. Ключевые поля формы:

Самое важное поле для магазина — label. Именно по нему вы свяжете входящий платёж с конкретным заказом Битрикс, когда придёт уведомление. Передавайте туда идентификатор заказа (например, его ID или номер), а не произвольный текст.

Как оформить это в 1С-Битрикс

Платёжная система настраивается в разделе Магазин → Настройки → Платёжные системы. Обратите внимание: штатный обработчик ЮMoney в модуле sale ориентирован на ЮKassa (бизнес-протокол с shopId), а не на приём переводов на кошелёк. Поэтому под кошелёк используют один из двух путей:

1. Обработчик «Свой вариант оплаты» с шаблоном формы. Создаёте платёжную систему, а в её шаблоне выводите форму quickpay, подставляя receiver, sum из заказа и label с номером заказа;
2. Собственный (пользовательский) обработчик в /bitrix/php_interface/include/sale_payment/ или в каталоге обработчиков paysystem — если нужна аккуратная логика формирования формы и приёма уведомлений.

В настройках платёжной системы значения удобно привязать к данным заказа: сумму — «Из заказа», номер заказа в label — из свойства заказа, номер кошелька — фиксированным «Значением». Тип плательщика обычно ограничивают «Физическим лицом».

HTTP-уведомления и секретное слово

Как и в любой redirect-схеме, факт оплаты нельзя определять по возврату покупателя — вкладку могли закрыть. Достоверный источник — HTTP-уведомление, которое ЮMoney отправляет POST-запросом на указанный вами URL после зачисления перевода.

В настройках уведомлений ЮMoney задаётся:

• URL для уведомлений — публичный адрес вашего скрипта-приёмника на сайте;
• Секретное слово (notification_secret) — строка, участвующая в расчёте подписи.

В теле уведомления приходят поля notification_type, operation_id, amount, currency, datetime, sender, codepro, label и контрольный sha1_hash. Приёмник обязан пересчитать SHA-1 от склейки значимых полей и секретного слова и сверить с присланным sha1_hash. Только при совпадении подписи, верной сумме и известном label заказ помечается оплаченным.

54-ФЗ, чеки и ограничения

Ключевое отличие кошелька от ЮKassa — фискализация не выполняется автоматически. Форма quickpay просто зачисляет перевод, но чек по 54-ФЗ она не пробьёт. Если вы обязаны выдавать чеки покупателям-физлицам, кассу придётся подключать отдельно и связывать с моментом оплаты вручную или через сторонний сервис.

Что ещё стоит учитывать:

• Лимиты кошелька — потолок на входящие суммы и на остаток счёта зависит от статуса идентификации;
• Комиссия — при оплате картой (AC) и выводе средств удерживается процент; закладывайте его в экономику;
• Возвраты — автоматического возврата, как в ЮKassa API, здесь нет; возврат делается вручную из кабинета;
• Ассортимент способов оплаты — кошелёк даёт карту и баланс ЮMoney, но не полный набор методов бизнес-кассы.

Проверка и типичные ошибки

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

1. Оформите заказ и перейдите к оплате — убедитесь, что форма открывает страницу ЮMoney с верной суммой и получателем;
2. Проведите оплату и вернитесь на successURL;
3. Проверьте, что пришло HTTP-уведомление, подпись sha1_hash сошлась, а заказ по label автоматически стал «Оплачен»;
4. Просмотрите журнал в Магазин → Настройки → Журнал и историю операций в кабинете ЮMoney.

Чаще всего ломается именно приём уведомления:

• Не сходится подпись — неверное секретное слово или порядок полей при расчёте SHA-1;
• Заказ не находится — в label ушёл не тот идентификатор;
• Уведомление не приходит — URL недоступен снаружи или отвечает ошибкой.

Итог

Приём на кошелёк ЮMoney в 1С-Битрикс держится на трёх вещах: кошелёк с повышенным статусом и его номером 4100…, форма quickpay с меткой label для связи с заказом и HTTP-уведомления с проверкой sha1_hash по секретному слову. Помните про отсутствие автоматической фискализации и лимиты кошелька — это решение для лёгких сценариев, а не для полноценного товарного магазина.

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