Docs

YooMoney API
Old versions of the API
Help
Sign in
Sign up for YooMoney
YooMoney API
YooKassa API
Old versions of the API
Help
Sign in | Sign up for YooMoney
Русский
YooMoney for OpenCart 1.5
How to install the module
  1. Установите модуль vQmod по инструкции
  2. Download the archive containing the module
  3. Find the src folder in the archive and copy its contents to the root folder of the website on your server.
  4. Select Extensions — Payment in the website's dashboard.
  5. Find the line titled YooMoney and click Install.
  6. Перейдите по адресу и дождитесь сообщения об успехе. Если сообщение не появилось, начните сначала.
Как связать сайт на OpenCart с личным кабинетом ЮKassa
  1. Подключите ЮKassa
  2. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять или переподключить, нажмите Сменить магазин.
  3. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  4. Разрешите выдать доступ к ЮKassa.
  5. Выберите магазин, который хотите подключить к модулю.
  6. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину.
    Если вышла ошибка, перезагрузите страницу и войдите в ЮKassa ещё раз.
How to set up payment acceptance via YooMoney
  1. Open the module settings in the Opencart dashboard (Extensions — Payments — Edit in the line titled "YooMoney").
  2. View the YooMoney tab and check the Enable payment acceptance via YooMoney box.
  3. Fill out the shopId and Secret key fields: you can get both parameters in your YooMoney Merchant Profile.
  4. Indicate the preferable scenario of selecting a payment method:
    • On YooMoney's side,
    • On the store's side.
  5. 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.
  6. In the drop-down lists, indicate the pages that your customers will see on:
    • successful payment,
    • payment error.
    If there are no corresponding pages, they need to be created.
  7. Indicate "YooMoney" in the Payment service title field.
  8. 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.
    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.
    Помощь ЮKassa: отправка чеков по 54-ФЗ
  9. Configure the Payment method attribute and Payment subject attribute so the fiscal documents will meet FFD 1.05 requirements.
    Payment method attribute is the category of the method you use to accept payment (installments, prepayment, full settlement, etc).
    Payment subject attribute is the category of goods and services that you sell (product, service, gaming bids, etc).
    Module settings are configured to default values: they are provided for all products that do not have these values set separately. If you need to set values separately, do so in the product description.
    Second receipt
    Once you set up everything for 54-FZ, you can proceed to the second receipt. Check the box so that the module forms a closing receipt. The second receipt will appear if the order has items with full prepayment, and if this order has moved to the selected status. For example, "Paid".
    The second receipt will be recorded in the order history.
  10. View the "Additional information for the administrator" section at the bottom of the page. Find Order status after the payment and select the status that will be assigned to the order if it was paid via YooMoney.
  11. Click Save in the upper right corner. That's it: you can test payment acceptance via YooMoney.
“Credit purchases” by SberBank
This payment method includes loans and installment plans. If the customer uses an installment plan, the module may display an incorrect payment amount (the correct amount will be shown in the YooMoney Merchant Profile). This won't affect the customer in any way: they will always pay the correct amount.
Ниже объясняем подробнее, почему так происходит — в двух разных случаях.
Если в заказе не применяется одновременно налог и доставка
Когда вы получите уведомление от ЮKassa о том, что статус платежа изменился на «Успешно» — модуль пересчитает общую сумму заказа и стоимость каждой позиции в заказе, чтобы они соответствовали значениям в чеке в личном кабинете ЮKassa.
Заказ для покупателя перед оплатой:
Заказ в модуле до перерасчёта:
Чек в личном кабинете ЮKassa после оплаты:
Заказ в модуле после пересчёта. В истории указана скидка:
Если применяется и налог, и доставка
В заказе пересчитается только итоговая сумма заказа. Так происходит потому, что OpenCart показывает налоги отдельно от товаров, а в чеке в личном кабинете ЮKassa цены отображаются вместе с налогами. Также может возникнуть неточность, когда данные для чека отправляются из модуля: доставка указывается без налогов, затем ЮKassa формирует чек по этим данным, а модуль отображает в админке другую стоимость.
Заказ для покупателя перед оплатой:
Заказ в модуле до пересчёта:
Чек в личном кабинете ЮKassa после оплаты:
Заказ в модуле после пересчёта:
How to use deferred payments (preauthorization)
If you have enabled deferred payments, bank card payments will be made in two steps:
  1. When the customer places an order on the website, the bank blocks the required amount on their card.
  2. The store captures the payment or returns the money to the customer.
In this case, if the order is canceled or the product is out of stock, the store can easily refund the money. No commission is charged for this refund.
How to enable deferred payments (preauthorisation)
  1. View Extensions — Payment.
  2. Find the YooMoney payment method on the opened page and click the Edit button.
  3. Check the box next to Enable deferred payments in the YooMoney module settings to enable the feature.
    After that, orders will have new statuses: "Awaiting capture" and "Cancelled". You will need to configure the statuses in a form that appears after you enable deferred payments.
    Don't forget to save the settings afterwards.
How to capture or cancel a payment
  1. View the page containing the list of orders: Sales — Orders.
    then find an order waiting for capture. It will have a Capture button. Click it to proceed to the payment capture or cancellation form.
  2. This form displays basic information about a payment. Click one of the buttons, Capture payment or Cancel payment, to process the payment.
    You will see the results immediately after clicking the button.
Setting up B2B payments
B2B-платежи в ЮKassa позволяют принимать на сайте оплату от юридических лиц.
  1. After installing the YooMoney module, find "YooMoney: Sberbank Business Online" in the list of payment modules. Click Install.
  2. To use B2B payments via Sberbank Business Online, enable this option in the module settings:
  3. After each payment made via B2B payments, YooMoney generates a payment order containing the purpose of the payment. If necessary, you can edit the template.

    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.

  4. Specify the default tax rate: it will be sent to Sberbank Business Online if a different rate is not specified in the product description.
  5. Compare the VAT rates in your store against the rates that will be sent to Sberbank Business Online.
  6. 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.
© 2024, "YooMoney", NBCO LLC