YooMoney API
Old versions of the API
Sign up for YooMoney
YooMoney for OpenCart 1.5
Configuration manual
The module supports several payment servcies of YooMoney.
YooMoney allows accepting payments on the website. All popular methods are available: bank cards, e-wallets, cash, online banking, direct carrier billing, and others.
This is a service for business: it requires a contract, and the funds are credited to the company's settlement account.
Sing up for YooMoney
YooMoney allows accepting payments on your website from bank cards and e-wallets. The funds will be credited to your YooMoney wallet, the contract is not required.
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. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять или переподключить, нажмите Сменить магазин.
  2. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  3. Разрешите выдать доступ к ЮKassa.
  4. Выберите магазин, который хотите подключить к модулю.
  5. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину.
    Если вышла ошибка, перезагрузите страницу и войдите в Ю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.
  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.
How to set up payment acceptance via YooMoney
To set up payment acceptance using this manual, you will need a YooMoney wallet number. Create a wallet
  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. Indicate the number of the wallet to transfer payments to.
  4. Check the boxes next to the payment acceptance methods that you need.
  5. 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.
  6. Save the settings. That's it, now you can test payment acceptance.
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.
  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.