YooMoney API
Old versions of the API
Help
Sign up for YooMoney
YooMoney for PrestaShop
 
Installing the module
  1. Download the archive containing the plugin
  2. Open the website's dashboard. In the left-hand menu, click Impovements, then Modules and Module Manager. Click Upload module in the upper right corner.
  3. Select the archive (or just drag it to the upload zone) and click Upload this module. Wait for the notification of success.
  4. Find YooMoney Prestashop in the List of modules (lower on the same page). If there's a lot of modules, type "YooMoney" in the search bar.
  5. Click Install button next to the name of the module. A pop-up window will appear asking if you really want to install a module untested by PrestaShop. Select Proceed to installation.
  6. Wait for the "Module has been installed successfully" message. That's it — now you can set it up.
YooMoney
Accept payments to settlement account and conduct refunds (by contract, for legal entities and private entrepreneurs).
Подключение магазина к модулю
Для последних версий модуля (начиная с 2.5.0)
  1. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять, нажмите Сменить магазин.
  2. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  3. Разрешите выдать доступ к ЮKassa.
  4. Выберите магазин, который хотите подключить к модулю.
  5. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину. Если вышла ошибка, начните заново.
  6. Если после смены или подключения магазина перестали приходить уведомления об изменении статуса платежа — проблема может быть в адресе для уведомлений. Измените адрес уведомлений на нужный и сохраните настройки. Если не получилось, свяжитесь с техподдержкой.
Для более поздних версий модуля (2.4.0 и старше)
  1. Для подключения магазина к модулю вам нужны параметры:
    • shopId will appear in your Merchant Profile by itself when you sign up for the service,
    • cекретный ключ — нужно выпустить в личном кабинете ЮKassa в разделе Интеграция → Ключи API → Секретный ключ.
  2. Fill out the shopId and Secret key fields.
  3. Нажмите «Сохранить конфигурацию».
Настройка приёма платежей через ЮKassa
  1. В графе Включить приём платежей через ЮKassa поставьте «Да».
  2. Indicate the preferable scenario of selecting a payment method:
    • On YooMoney's side,
    • On the store's side.
  3. If you selected the payment scenario to be played out on YooMoney's side and your contract with YooMoney includes loans and installment plans as the payment method, you can add the Installments button by ticking the box.
    If you selected the payment scenario to be played out on the store's side, check the boxes corresponding to payment methods indicated in your contract with YooMoney.
  4. If you configured the transmission of receipts to the Tax service via YooMoney partner services (in accordance with Federal Law No. 54-FZ), enable the transmission of receipt data, then indicate the VAT rate to be specified in the receipt.
    • The default rate will be indicated in the receipt for the products that you didn't previously indicate the VAT rate for,
    • The rates in your store have to be compared against the YooMoney rates.
  5. Select the status to be assigned to an order after it's been paid via YooMoney. Set the minimum order amount if necessary.
  6. Click Save at the bottom of the page. That's it: you can test payment acceptance on the website.
How to make refunds
Once you set up payment acceptance via YooMoney, you will be able to make full refunds for successful payments.
Если используете PrestaShop 1.6.х
  1. In the left-side menu, click Orders to open the page with the list of orders.
  2. Find the needed order and click its corresponding Refunds button.
  3. In the opened Refunds tab, specify the products you'd like to return and the reason behind the refund (the customer will see this message).
  4. Click Refund. If everything is done correctly, you will see the Payment successfully refunded message.
Если используете PrestaShop 1.7.х
  1. В меню слева нажмите Заказы.
  2. Найдите нужный заказ и перейдите в его карточку.
  3. В верхней части карточки заказа нажмите кнопку Возвраты.
  4. Откроется вкладка Возврат: укажите причину возврата — её увидит клиент.
  5. Нажмите Сделать возврат. Если всё в порядке, появится сообщение «Платёж успешно возвращён».
Если используете PrestaShop 8.х
  1. В меню слева нажмите Заказы.
  2. Найдите нужный заказ и перейдите в его карточку.
  3. Пролистайте страницу до раздела Возвраты.
  4. Нажмите Сделать возврат. Если всё в порядке, появится сообщение «Платёж успешно возвращён».
Как делать подтверждение или отмену отложенного платежа
  1. В меню слева нажмите Заказы.
  2. Найдите нужный заказ и перейдите в его карточку.
  3. Найдите блок Отложенная оплата.
  4. Нажмите Подтвердить или Отменить.
YooMoney
Accept payments to YooMoney wallet (without a contract, for everyone).
How to set up payment acceptance
Using this module, you can accept payments into your YooMoney wallet without a contract.
  1. Click Impovements, then Modules and Module Manager in the website's dashboard. Find YooMoney for Prestashop in the list of modules, and click the Configure button on the right side.
  2. View the YooMoney tab and set the Enable payment acceptance via YooMoney field to "Yes".
  3. In the Wallet number field, indicate the number of the YooMoney wallet that you'd like to accept payments to.
  4. Get the Code word in the YooMoney notification settings
  5. Link for the Redirect URL field is the same as the RedirectURL in module's settings: just copy and paste it.
    Logo is not required but it helps users to recognize your service.
    Be sure to check the Use app authentication box.
    When you're finished filling out the fields on the registration page, click Confirm. The website will generate ID and Code word: copy and paste them into the module's settings.
  6. Set the minimum order amount if necessary. You can also specify the status of the order after the payment. Click Save at the bottom of the page. That's it, now you can test payment acceptance.
“Credit purchases” by SberBank
В этот способ оплаты входит кредит и рассрочка. Если покупатель платит в рассрочку, в модуле может отображаться неверная сумма покупки (верная будет в личном кабинете ЮKassa). На покупателя это никак не повлияет — он всегда оплатит верную сумму.