Yandex.Chekout for MODX Revolution

Download the instructions in PDF format

Configuration manual

The module works with 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

  1. How to install the module
  2. How to enable payment acceptance via Yandex.Checkout
  3. How to set up payment acceptance to Yandex.Money wallet
  4. How to accept payments via Yandex.Billing

How to install the module

1. Download the archive containing the module.

2. Click Apps — Installer in website's dashboard. A page with the list of packages will open.

3. Click Download add-ons — Download the package.

4. Download the archive containing the module (Select package — Download).

5. Close the downloads window once its done. Find YandexMoney on the page with the list of packages, and click Install — Installation options — Install package.

6. Open the payment form chunk and enter [[!YandexMoney?&action=showMethods]] in the list of payment methods. It looks like this:

<select name="payment" style="width:200px;">
<option value="On receipt" [[!+fi.payment:FormItIsSelected=`On receipt`]]>On receipt</option>
[[!YandexMoney? &action=`showMethods` ]]
</select> 

7. Open the checkout page chunk and add YandexMoneyHook to the FormIt list of hooks, It looks like this:

[[!FormIt?
&hooks=`spam,shk_fihook,YandexMoneyHook,email,FormItAutoResponder,redirect`
&submitVar=`order`
&emailTpl=`shopOrderReport`
&fiarTpl=`shopOrderReport`
&emailSubject=`New order made in «[[++site_name]]» online store`
&fiarSubject=`You made a new order in the "[[++site_name]]" online store`
&emailTo=`[[++emailsender]]`
&redirectTo=`25`
&validate=`address:required,fullname:required,email:email:required,phone:required`
&errTpl=`<br /><span class="error«>[[+error]]</span>`
]] 

8. Create a successful payment page and a payment error page.

After that, you can set up payment acceptance using one of three methods:

  • via Yandex.Checkout,
  • via Yandex.Money,
  • or via Yandex.Billing.

How to enable payment acceptance via Yandex.Checkout

|||UNTRANSLATED_CONTENT_START|||Чтобы настроить прием платежей по этой инструкции, нужно Подключиться к Яндекс.Кассе и получить параметры shopId и Секретный ключ.|||UNTRANSLATED_CONTENT_END|||

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

1. Open the website's dashboard and select Yandex.Money in the left-hand menu (Elements tab in the Snippets section).

2. Select the Parameters tab and click Default settings are blocked: this button unlocks the module settings so you can configure them.

3. Fill out the module settings as in the table below.

Внимание. To edit any field, double-click on the value in the far right column.
account Don't change
fail_page_id Indicate the ID of the page to show the user in case of payment failure
method_ab Set Yes if the Alfa-Bank payment method is provided for in your Yandex.Checkout contract
method_cards Set Yes if the Bank cards payment method is provided for in your Yandex.Checkout contract
method_cash Set Yes if the Cash payment method is provided for in your Yandex.Checkout contract
method_qw Set Yes if the Qiwi payment method is provided for in your Yandex.Checkout contract
method_sb Set Yes if the Sberbank Online payment method is provided for in your Yandex.Checkout contract
method_wm Set Yes if the Webmoney payment method is provided for in your Yandex.Checkout contract
method_ym Set Yes if the Yandex.Money wallet payment method is provided for in your Yandex.Checkout contract
mode

Indicate Legal entity (payment method selection on the store's side) if you want all payment methods to be placed on your website

How it looks (example)

Indicate Legal entity (payment method selection on Yandex.Checkout's side) if you want all payment methods to be placed on Yandex.Checkout's side More in the interactive presentation

password Indicate the Secret key parameter in this field, you will need to issue and activate it in your Yandex.Checkout Merchant Profile
shopid Indicate the shopId parameter in this field, you can copy it from your Yandex.Checkout Merchant Profile
success_page_id Specify the ID of the page to show the user if the payment was successful
tax_id

If you fiscalize payments using the Yandex.Checkout solution, select your VAT rate on the right.

If you fiscalize payments independently (without the use of Yandex.Checkout), leave the field unchanged. More about the Yandex.Checkout's solution for Federal Law No. 54-FZ

ya_billing_id Don't change
ya_billing_purpose Don't change
ya_billing_status Don't change
ya_kassa_send_check Set Yes if you fiscalize using the Yandex.Checkout solution. More about the Yandex.Checkout's solution for Federal Law No. 54-FZ

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

How to set up payment acceptance to Yandex.Money wallet

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

  • Open the website's dashboard and select Yandex.Money in the left-hand menu (Elements tab in the Snippets section).
  • Select the Parameters tab and click Default settings are blocked: this button unlocks the module settings so you can configure them.

3. Fill out the module settings as in the table below.

Внимание. To edit any field, double-click on the value in the far right column.
account Indicate the number of the wallet to send money to
fail_page_id Don't change
method_ab Don't change
method_cards Set Yes if you want to accept payments from bank cards
method_cash Don't change
method_qw Don't change
method_sb Don't change
method_wm Don't change
method_ym Set Yes if you want to accept payments from Yandex.Money wallets
mode Indicate Individual
password Issue the Code word in the wallet settings and copy it here Issue code word
shopid Don't change
success_page_id Specify the ID of the page to show the user if the payment was successful
tax_id Don't change
ya_billing_id Don't change
ya_billing_purpose Don't change
ya_billing_status Don't change
ya_kassa_send_check Don't change

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

How to accept payments via Yandex.Billing

  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 the product or service field. |||UNTRANSLATED_CONTENT_START|||Поле Сумма заполнять не нужно, добавлять другие товары или дополнительные поля тоже не нужно — всё уже учтено в вашей CMS.|||UNTRANSLATED_CONTENT_END|||

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 website's dashboard and select Yandex.Money in the left-hand menu (Elements tab in the Snippets section).

2. Select the Parameters tab and click Default settings are blocked: this button unlocks the module settings so you can configure them.

3. Fill out the module settings as in the table below.

account Don't change
fail_page_id Don't change
method_ab Don't change
method_cards Don't change
method_cash Don't change
method_qw Don't change
method_sb Don't change
method_wm Don't change
method_ym Don't change
mode Set Yandex.Billing
password Don't change
shopid Don't change
success_page_id Don't change
tax_id Don't change
ya_billing_id Copy the ID parameter to this field from the Yandex.Billing email (sent after you created the form).
ya_billing_purpose Do not change, or indicate everything that will help distinguish the order paid made via Yandex.Billing. This parameter will be used in the payment order.
ya_billing_status Select the status to be assigned to an order after it's been 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.
ya_kassa_send_check Don't change

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

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.
  4. That's it, you can accept payments now.
Внимание. Important: 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.