Instructions for WooCommerce
С помощью плагина удобно включить и настроить прием онлайн-платежей через ЮKassa.
- Принимать платежи у себя сайте, без перенаправления на сайт ЮKassa
- Возвращать платежи
- Сохранять платежные данные, чтобы покупатели не вводили их при каждом заказе
- «Замораживать» деньги на карте и в кошельке покупателя — для предоплаты
- Получать платежи на банковский счет компании
Способы приема платежей:
- Банковские карты — Visa, Mastercard, Maestro, «Мир»
- SberPay
- YooMoney
- Наличные через терминалы
- Баланс мобильного — МТС, Мегафон, Билайн, Tele2
Если не получилось скачать плагин по ссылке, найдите плагин «ЮKassa для WooCommerce» в панели управления сайтом: Плагины → Добавить новый
Click WooCommerce — YooMoney settings in the website's dashboard.
Вкладка «Авторизация»
Если у вас новая версия модуля (начиная с 2.3.0)
- Если магазин ещё не подключен, нажмите на Подключить магазин.
Если магазин подключен и вы хотите его поменять, нажмите Сменить магазин.
- Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
- Разрешите выдать доступ к ЮKassa.
- Выберите магазин, который хотите подключить.
- Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину. Если вышла ошибка, просто закройте её — страница перезагрузится и можно будет начать заново.
Если у вас более поздняя версия модуля (2.2.5 и старше)
- Подключите ЮKassa
- Для подключения магазина вам нужны параметры:
- shopId will appear in your Merchant Profile by itself when you sign up for the service,
- cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
- Заполните поля shopID и Секретный ключ.
- Нажмите «Сохранить и продолжить».
Вкладка «Способы оплаты»
Выбор способа оплаты на стороне ЮKassa
В этом случае покупатель увидит все способы оплаты, которые вы подключили в ЮKassa. При оплате он перенаправится на страницу ЮKassa, где выберет способ оплаты и введет платежные данные.
В этом случае пользователь выбирает способ оплаты на вашей стороне и потом перенаправляется на страницу ЮKassa, чтобы ввести платежные данные. Вы можете выбрать, какие способы оплаты показывать.
«Заплатить по частям»
Это сервис для продажи в кредит на вашем сайте. Подробнее — в разделе «Кредитование».
«Отложенные платежи»
Если включить Отложенные платежи — все платежи с карт и кошелька будут проходить в 2 этапа. Сначала сумма замораживается на карте покупателя или в кошельке ЮMoney, а после вашего подтверждения списывается (или возвращается клиенту, если вы не подтвердили списание). Если вы отменяете такой платеж, то комиссия не списывается. Это удобно, когда перед оформлением заказа нужно, например, проверить наличие товара.
Подробнее — в разделе «Использование отложенной оплаты».
B2B payments
Опция B2B-платежи позволяет быстро принимать онлайн-платежи от юридических лиц через Сбербанк Бизнес Онлайн. Для этого нужно, чтобы у покупателя был счет в Сбербанке. Если включить опцию, в способах платежа появится пункт Сбербанк Бизнес Онлайн.
Подробнее — в разделе «Использование B2B-платежей».
Вкладка «Доп.функции»
В поле с описанием платежа отображается текст, который покупатель увидит на странице оплаты. Вы можете изменить это поле или оставить как есть. Список возможных значений для подстановки — в документации WooCommerce.
Укажите страницы, которые увидят ваши покупатели при успешной оплате или ошибке. Если подходящих страниц нет, их нужно создать.
Вкладка «54-ФЗ»
Если вы работаете с онлайн-кассой от одного из партнёров ЮKassa — включите отправку данных в ЮKassa.
Затем настройте данные для чеков:
- «Ставка НДС по умолчанию» будет в чеке у товаров, для которых вы не указывали НДС раньше.
- Ставки, которые уже есть в вашем магазине, нужно сопоставить со ставками в ЮKassa.
- Предмет и способ расчета — признаки, которые нужно передавать в чеках. Настройте значения для ваших товаров.
Что такое «Предмет и способ расчета»
Чтобы фискальные документы соответствовали ФФД 1.05, настройте Предмет расчета и Способ расчета.
Предмет расчета — это категория товаров и услуг, которые вы продаете (товар, услуга, ставка в игре и т.д.)
Способ расчета — это категория способа, которым вы принимаете оплату (оплата в кредит, предоплата, полный расчет и т.д.)
Значения этих параметров берутся из атрибутов товара «Признак предмета расчета» и «Признак способа расчета».
Для товаров, у которых значения этих атрибутов не заданы, подставляются значения из блока «Предмет расчета и способ расчета (ФФД 1.05)».
Если потребуется, значения можно задать отдельно для каждого товара (в карточке товара).
Что такое «Второй чек»
Нужно формировать два чека, если клиент вносит предоплату и только потом получает товар или услугу. Первый чек — когда деньги поступают вам на счет, второй — при отгрузке товаров или выполнении услуг. В первом чеке в «признаке способа расчета» передается «полная предоплата». Во втором — указывается «полный расчет».
Когда вы настроили все в блоке 54-ФЗ, можно перейти ко второму чеку. Если включить эту опцию, модуль будет формировать второй (закрывающий) чек. Это произойдет автоматически, если в заказе есть позиции с полной предоплатой, и этот заказ перешел в выбранный статус. Например, «завершен».
В истории заказа появится запись об отправке второго чека.
Вкладка «Настройка уведомлений»
Скопируйте ссылку и вставьте в настройки личного кабинета ЮKassa. После этого вы сможете отслеживать состояние платежей.
Если этого не сделать, вы будете принимать платежи, но статусы заказов в ЮKassa меняться не будут.
Включение способов оплаты в WooCommerce
По умолчанию у вас будут включены базовые способы оплаты, которые доступны в WooCommerce: банковские карты, ЮMoney, SberPay и наличные через терминалы. Чтобы включить или отключить некоторые способы, нажмите «WooCommerce — Настройки — Платежи».
Прокрутите страницу вниз и выключите ненужные способы оплаты. Здесь же можно поменять порядок их отображения на странице оплаты: просто перетаскивайте их в таблице.
Использование виджета
Если в самом начале настройки вы установили «Выбор способа оплаты на стороне магазина», то можете включить виджет ЮKassa. Он позволяет принимать платежи прямо на вашем сайте — без отправки покупателя на страницу ЮKassa. В виджете можно принимать платежи банковской картой, кошельком ЮMoney и через SberPay.
Чтобы использовать виджет, зайдите в «WooCommerce — Настройки — Платежи» и выберете метод оплаты «Платежный виджет ЮKassa».
Если включена отложенная оплата, платеж банковской картой (или кошельком ЮMoney) проходит в два этапа:
- При оформлении заказа нужная сумма блокируется на карте или в кошельке покупателя.
- Магазин подтверждает платеж (и списывает деньги) или возвращает деньги клиенту.
В таком случае, если заказ отменится, или товара не будет в наличии, можно легко вернуть деньги. Комиссии за такой возврат нет.
Как включить отложенную оплату
Перейдите в «WooCommerce — Настройки ЮKassa — вкладка «Способы оплаты». В блоке «Отложенные платежи» нажмите «Вкл.», затем «Сохранить и продолжить».
Когда включите опцию, все заказы, оплаченные картой или кошельком, по умолчанию переходят в статус «На удержании» («on-hold») и остаются в нем до подтверждения/отмены платежа или до истечения срока удержания. В истории заказа при поступлении платежа появляется запись: «Поступил новый платеж. Он ожидает подтверждения до {дата и время}, после чего автоматически отменится».
Как подтвердить платеж
- Через список заказов. Перейдите в «WooCommerce — Заказы». У заказов, которые ожидают обработки, в колонке «Статус» есть кнопка «Обработка». Нажмите ее, чтобы подтвердить платеж. Статус платежа сразу поменяется, результат запишется в историю заказа: «Вы подтвердили платеж в ЮKassa». Когда от ЮKassa придет уведомление о платеже, появится еще одна запись: «Номер транзакции в ЮKassa: «id». Сумма: «сумма>».
- Через карточку заказа. Перейдите в карточку заказа, в выпадающем меню «Статус» выберите статус «Обработка» («Processing») и нажмите кнопку «Обновить».
Перед подтверждением платежа вы можете отредактировать содержимое заказа: удалить позиции или изменить их количество. Когда вы подтверждаете платеж частично, оставшаяся часть денег возвращается покупателю.
Как отменить платеж
Зайдите в карточку заказа, в выпадающем меню «Статус» выберите «Отменен» («Canceled») и нажмите кнопку «Обновить». Результат запишется в историю заказа. Если отменить не получилось — попробуйте еще раз.
Customers can save the details of bank cards and wallets in the personal dashboard on your website. When making the next payment, they can select a saved payment method without entering the information again.
Activating the feature:
- Contact your YooMoney manager and tell them you want to enable this option.
- Wait for the manager's response and enable the option in the module settings. Click WooCommerce — Settings — Payments tab in the website's dashboard.
- Select Bank cards or YooMoney wallet in the list of payment methods and check the Save the payment method box.
How the customers will use this feature:
- To save a card or wallet, the buyer must be registered on the website.
- There are 2 ways to save data: enter it in the personal dashboard, or remember it during payment.
- During the next payment, the website will offer to use a new card, select one of the saved ones, or save the payment method.
- The customer can delete saved cards and wallets in the personal dashboard.
B2B-платежи в ЮKassa позволяют принимать онлайн-платежи от юридических лиц. Для этого нужно, чтобы у покупателя был счет в Сбербанк Бизнес Онлайн.
- To use B2B payments via Sberbank Business Online, enable this option in the module settings.
- After each B2B payment, YooMoney generates a payment order containing the purpose of the payment. If necessary, you can edit the template.
- Specify the default tax rate: it will be sent to Sberbank Business Online if a different rate is not specified in the product description.
Payments via Sberbank Business Online have a restriction: one order can only include products with the same VAT rate. If the customer adds to cart items with different rates, we will show them a message notifying these items can't be paid with a single receipt. - Compare the VAT rates in your store against the rates that will be sent to Sberbank Business Online.
- Don't forget to save the changes.When a payment is made via Sberbank Business Online, the payer information is recorded in the order history.
«Заплатить по частям» — сервис ЮKassa для продаж в кредит и рассрочку на вашем сайте. Покупатели будут платить по частям, а вы получите всю сумму сразу.
Как включить кредитование на сайте
Если выбор способа оплаты на стороне магазина
- Напишите менеджеру в ЮKassa, что хотите продавать в кредит. Обсудите условия и выберите тариф кредита или рассрочки.
- Поставьте галочку «Заплатить по частям» в блоке «Способы оплаты» в настройках WooCommerce.
Подключите опцию с помощью менеджера ЮKassa — в модуле все включится автоматически.
Чтобы рассказать покупателям о кредите, добавьте отдельную кнопку в карточку товара и на страницу оформления заказа. Для этого отметьте нужные опции в блоке «Способы оплаты» в настройках плагина ЮKassa.
В этот способ оплаты входит кредит и рассрочка. Если покупатель платит в рассрочку, в модуле может отображаться неверная сумма покупки (верная будет в личном кабинете ЮKassa). На покупателя это никак не повлияет — он всегда оплатит верную сумму.
Чтобы суммы не расходились, вы можете настроить модуль по инструкции ниже.
Почему сумма в модуле отображается неправильно
Это значит, что вы настроили один или несколько параметров так:
- Для одной из налоговых ставок указано значение Сложение.
- В налоге указано, что он действует на доставку, но для самой доставки не выбран статус налога Налогооблагаемый.
- На товар или доставку действует больше одного налога.
Как настроить модуль, чтобы сумма отображалась правильно
- В панели управления сайтом перейдите в раздел WooCommerce → Настройки → Основные. Поставьте галочку напротив Включить налоговые ставки и расчёты.
- Зайдите в раздел WooCommerce → Настройки → Налог. Настройте, как будут применяться налоги.
- Откройте раздел WooCommerce → Настройки ЮKassa. Настройте модуль ЮKassa для WooCommerce в зависимости от ваших параметров:
- Если указаны свои налоговые ставки — перейдите в раздел Чеки → Сопоставьте ставки. Затем напротив каждой ставки укажите правильную.
- Если налоговые ставки не указаны вообще — перейдите в раздел Чеки → Ставка НДС по умолчанию. Затем настройте модуль в соответствии с налоговой политикой.
- В разделе WooCommerce → Настройки → Налог создайте налоги, которые вам нужны.
- Для каждого товара укажите статус налога Налогооблагаемый и налоговый класс Стандарт. Ставки Reduced Rate и Zero Rate работают как обычные налоги — они различаются в дальнейших выгрузках отчётности, но на суммы не влияют.
- Если вы указали, что налог действует и на доставку — перейдите в раздел WooCommerce → Настройки → Доставка. Затем укажите статус налога Налогооблагаемый.
- Готово, теперь сумма покупки в модуле и в личном кабинете ЮKassa должна совпадать.
Если нужно сделать возврат
Сделать полноценный возврат из модуля не получится. Если сделать возврат из личного кабинета ЮKassa, статус в модуле также автоматически не изменится.
Чтобы после возврата из личного кабинета ЮKassa сумма покупки в модуле отображалась правильно, оформите возврат вручную — нажмите на кнопку Refund и укажите сумму возврата.
Важно: если в модуле изменить статус на Refunded, то скидка посчитается дважды и суммы будут разные.
Если отменить платёж в статусе «На удержании» (on-hold)
Сумма покупки в модуле не пересчитается — и всегда будет отличаться от суммы в личном кабинете ЮKassa.
Вы можете подключить платежи по подписке (рекуррентные платежи): заданная сумма будет списываться с банковской карты или кошелька ЮMoney вашего клиента с определённой периодичностью, например, 1-го числа каждого месяца. Для этого установите плагин WooCommerce Subscriptions; ЮKassa поддерживает работу с ним. Подробнее о платежах по подписке на сайте ЮKassa
О том, как создать и настроить подписку, можно прочитать в руководстве от разработчиков WooCommerce Subscriptions (текст на английском языке).
Важно: не забудьте добавить на свой сайт инструкцию по отмене подписки. Моменты, которые нужно учесть, описаны в документации WooCommerce Subscription (текст на английском языке).