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)

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 previously 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. 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.

10. 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.

To enable the ofer program, 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.