YooMoney API
Old versions of the API
Help
Sign up for YooMoney
Setting up payment acceptance in Drupal 7
Using this manual, you can set up payment acceptance for your website at Drupal via one of the YooMoney services.
YooMoney: accept payments to settlement account, onboarding via a contract. Suitable for legal entities and private entrepreneurs.
YooMoney: accept payments to YooMoney wallet. No contract required, suitable for individual sellers.
 
Installing the module
  1. Download the archive (zip, 1,5 Mb).
  2. Copy the contents of the archive to the /sites/all/modules folder on your server.
  3. Select "Modules" in the dashboard, then find "YooMoney" in the opened list.
  4. In the "YooMoney" section, check the boxes for YooMoneyCore, YooMoney Ubercart Api and YooMoney Commerce Api.
  5. Click "Save the settings" and wait for the "Settings saved" message. That's it: the module has been installed and activated.
How to switch to Russian
  1. Select Configuration in the website's dashboard. Find the "Region and language" section and click "Translate interface".
  2. View the "Import" tab at the "Translate interface" page and upload the .PO file from the archive containing the module.
  3. Click "Import", and the module's interface will be translated into Russian.
Setting up payment acceptance via YooMoney
Свяжите ваш сайт на Drupal с личным кабинетом ЮKassa
  1. Если магазин к модулю ещё не подключен, нажмите на Подключить магазин.
    Если магазин подключен и вы хотите его поменять или переподключить, нажмите Сменить магазин.
  2. Откроется всплывающее окно. Если не открылось, возможно, браузер его заблокировал — разрешите открывать всплывающие окна на этом сайте.
  3. Разрешите выдать доступ к ЮKassa.
  4. Выберите магазин, который хотите подключить к модулю.
  5. Введите код из смс → всплывающее окно закроется и появятся данные по подключенному магазину.
    Если вышла ошибка, перезагрузите страницу и войдите в ЮKassa ещё раз.
Setting up payment acceptance
  1. Select Configuration — YooMoney Core (YooMoney module settings) in the website's dashboard.
  2. Select YooMoney on the left 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. Set the default payment method below: it will be offered to customers every time they proceed to checkout.
  6. If you use the YooMoney solution for 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.
  7. If you want to use deferred payments (preauthorization), enable it here.
  8. "Success page text" will be shown to the customer after they pay for their order. Enter "Paid" or other similar message.
  9. "Error page text" will be shown to the customer if something goes wrong: for example, if they don't have enough money on their card. Explain that there was an error and help them solve it (for example, as in the screenshot below).
  10. Click "Save the settings". That's it: you can test payment acceptance now.
How to capture and cancel payments
If preauthorization is enabled, 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.
Navigate to Reports — YooMoney transactions in the dashboard to open the list orders.
If the order has the Waiting for capture status (waiting_for_capture), you can view, edit, capture, or cancel it. Find the required order. In the Actions column, click Capture to capture the payment or Cancel to cancel it. Results are displayed in a pop-up window immediately after you click the button.
Editing an order
You can edit the contents of the order before capturing the payment: remove items or change their quantity. Select the required order and click Edit in the Actions column to open the order card contacting the list of items.
Quantity of items in the order can be changed in the Quantity column.
To remove an item, check its box in the Remove column and click Add line item, then save the changes.
If you partially capture the payment, the remaining part is returned to the buyer.
Setting up payment acceptance to a YooMoney wallet
Using this module, you can accept payments from bank cards and YooMoney wallets. The settlements will be made to your YooMoney wallet.
  1. Select Configuration — System — YooMoney Core (YooMoney module settings) in the website's dashboard.
  2. Select YooMoney on the left, check the Enable payment acceptance to the YooMoney wallet box and enter the number of the wallet that you'd like to accept payments to.
  3. Copy the "Link for HTTP notifications" to the YooMoney wallet's notification settings. Check the "Send notifications" box and click "Save" at the bottom of the page (in the notification settings at the YooMoney website). Return to the module configuration.
  4. Indicate your store's name in the "Payment commentary" field.
  5. "Success page text" will be shown to the customer after they pay for their order. Enter "Paid" or other similar message.
  6. "Error page text" will be shown to the customer if something goes wrong: for example, if they don't have enough money on their card. Explain that there was an error and help them solve it (for example, as in the screenshot below).
  7. Click "Save the settings". That's it: you can test payment acceptance now.