Yandex.Checkout for OpenCart 1.5

Configuration manual

The module supports three Yandex payment services.

Yandex.Checkout

Yandex.Checkout 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 Yandex.Checkout

Yandex.Money

Yandex.Money allows accepting payments on your website from bank cards and e-wallets. The funds will be credited to your Yandex.Money wallet, the contract is not required.

Create a wallet

Yandex.Billing

Yandex.Billing allows accepting payments on your website from bank cards and e-wallets.

This is a service for business: the funds are credited to the company's settlement account. The contract is not required, but you need to pay a fee of 3000 ₽ for using the form.

Learn more about Yandex.Billing

How to install the module

How to set up payment acceptance via Yandex.Checkout

How to set up payment acceptance via Yandex.Money

How to set up payment acceptance via Yandex.Billing

How to use deferred payments (preauthorization)

Setting up B2B payments

How to install the module

1. Download the archive containing the module.

2. Find the src folder in the archive and copy its contents to the root folder of the website on your server.

3. Select Extensions — Payment in the website's dashboard.

4. Find the line titled Yandex.Money and click Install.

Once the installation is complete, you can set up payment acceptance.

How to set up payment acceptance via Yandex.Checkout

To set up payment acceptance using this manual, you need to sign up for Yandex.Checkout and get the shopId and Secret key parameters.

  • shopId will appear in your Merchant Profile by itself when you sign up for the service,
  • Secret key is issued independently and requires activation in Merchant Profile.

Once you get both parameters, you can proceed with the configuration following this manual.

1. Open the module settings in the Opencart dashboard (Extensions — Payments — Edit in the line titled "Yandex.Money 2.0").

2. View the Yandex.Checkout tab and check the Enable payment acceptance via Yandex.Checkout box.

3. Fill out the shopId and Secret key fields: you can get both parameters in your Yandex.Checkout Merchant Profile.

4. Indicate the preferable scenario of selecting a payment method:

  • On Yandex.Checkout's side (you can view an example in Demo Store),
  • On the store's side.

The option of selecting the payment method on the store's side looks like this:

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 Yandex.Money. Set the default payment method in the drop-down list: it will be offered to customers every time they proceed to checkout.

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 "Yandex.Chekout" in the Payment service title field.

8. If you configured the transmission of receipts to the Tax service via Yandex.Checkout 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 previosuly indicate the VAT rate for,
  • the rates in your store have to be compared against the Yandex.Checkout rates.

Yandex.Checkout's guide for transmission of receipts in accordance with Federal Law No. 54-FZ

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 Yandex.Checkout.

11. Click Save in the upper right corner. That's it: you can test payment acceptance via Yandex.Checkout.

Yandex.Money offer program

If you enabled the Yandex.Money offer program, you can use the module to send the notifications about the promo code use to Yandex.Money.

You need to:

  1. Open the module settings in the Opencart dashboard (Extensions — Payments — Edit in the line titled "Yandex.Money 2.0").
  2. Select the Offer program tab and check the "Notify Yandex.Money of promo code use" box.
  3. Specify the parameters you received from the Yandex.Money manager during the sign up for the program: campaign number, username, and password.

That's it: if a customer uses a promo code for making a payment, you can confirm it in the order history via a special button. This confirmation will be sent to Yandex.Money.

You can send questions about the offer program to merchants@money.yandex.ru.

How to set up payment acceptance via Yandex.Money

To set up payment acceptance using this manual, you will need a Yandex.Money wallet number. Create a wallet

  1. Open the module settings in the Opencart dashboard (Extensions — Payments — Edit in the line titled "Yandex.Money 2.0").

  2. View the Yandex.Money tab and check the "Enable payment acceptance via Yandex.Checkout" 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 Yandex.Checkout.

  6. Save the settings. That's it, now you can test payment acceptance.

How to set up payment acceptance via Yandex.Billing

The configuration process consists of three steps:

  1. Get the payment form settings at the Yandex.Billing website.
  2. Indicate these settings in the website's dashboard.
  3. Pay the fee for using the form.

How to get the payment form settings

1. Fill out the form template at the Yandex.Billing website: indicate "Payment for order" in the Name of product or service field. You don't need to fill out the Amount field, add other products, or additional fields, as this information is already included in your CMS.

What the form template looks like

2. Click Next and fill out the company questionnaire on the next page.

You will need to indicate:

  • your company's legal name and INN (TIN),
  • account's banking details,
  • email address where you'd like to receive payment notifications,
  • URL of the website where you're going to accept payments via Yandex.Billing.
What the company questionnaire looks like

3. Click Create form. Banking details, URL, and other provided information will be sent for verification. It will take a couple of minutes.

4. If everything's in order, you will receive an email containing the form's parameters and banking details for paying the fee.

Body of the email

How to configure settings in the dashboard

1. Open the module settings in the Opencart dashboard (Extensions — Payments — Edit in the line titled "Yandex.Money 2.0").

2. View the Yandex.Billing tab and check the Enable payment acceptance box.

3. Yandex.Billing's identifier is the Form ID, copy it from the Yandex.Billing email (you received one after setting up the form).

4. In the Payment purpose field, indicate everything that will help distinguish the payment made via Yandex.Billing. This parameter will be included in the payment order.

5. In the Order status field, select the status that will be assigned to the order that was paid via Yandex.Billing. The status should indicate that the payment result is unknown: you can only find out whether the customer paid or not from the email notification.

6. Save the settings. All you need to do now is pay for the form, then you can start accepting payments.

The form on your website will look like this

How to pay for the form

  1. Open the email containing the form's code and the banking details for paying a fee.
  2. Pay 3,000 rubles using the banking details. Pay from the settlement account that you will use for accepting payments (otherwise, the fee will not be considered as paid).
  3. As soon as we receive the funds, we will activate the form and send you an email. The duration depends on your bank, but it shouldn't take more than 3 days.

That's it, you can accept payments now.

Внимание. One paid fee covers all the forms that you select for your company (we check by INN (TIN) indicated during the creation of the form). Limitations on quantity and amount of payments also apply to all forms at the same time.

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 Yandex.Money 2.0 payment method on the opened page and click the Edit button.

3. Check the box next to Enable deferred payments in the Yandex.Money 2.0 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 payments in Yandex.Checkout allow accepting online payments from legal entities.

1. After installing the Yandex.Checkout module, find "Yandex.Money 2.0: 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, Yandex.Checkout 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.