Getting Started

  • You should have a valid Yandex Delivery account. If you don’t have one, create it here: Learn how to use the service:
  • You should also have a running contract with Yandex Delivery. To check information about the running contract, open your personal account and go to Settings -> Contract execution. The empty section means you should conclude a contract.
  • Get a plugin. The plugin is paid. We can give it for free in exceptional cases if you are: an NPO, an integrator company, or a potential partner.

Purchasing a plugin

Pay for the order with a bank card or via PayPal. Example:

  • If you are a legal entity and want to pay for the order via bank transfer, contact the support team and add the plan of your choice in the message body.
  • When the payment is processed, the payment service will send you two confirmations on the email address listed in the order form. If you didn’t receive the confirmation of your payment, contact the support team. Please note that the right to use the plugin is limited by one year. The Freemius payment service will try to renew your license annually. To avoid recurring payments, disable auto-renewal in your Freemius account.
  • If you don’t renew the license for the next year, the plugin will be blocked by the end of the paid period.

Downloading a plugin

Open the email confirmation from Freemius. It has a Thanks for subscribing subject line.

There is also a link to download the plugin.

Open the link in the browser. Your browser will download the archive with the plugin automatically.


In WordPress Dashboard

  1. Navigate to Plugins.
  2. Click Add New.
  3. Click Upload Plugin.

Click Choose file and select the archive with the plugin.

Click Choose File.

Click Install.

Click Activate.


  • Open an FTP client (i.e. FileZilla).
  • Connect to your website’s FTP server. Configure an FTP connection to your website (if you haven’t done it before).
  • Navigate to the folder with your plugins. The destination path usually looks like this: Website folder -> Public_html (if exists) -> Wp-content-> Plugins.
  • Send the file with the plugin archive to the Plugins folder on your website. Right-click on the file you want to upload and click Upload.
  • Unzip the plugin archive in the Plugins folder.
  • Go to the WordPress Dashboard and navigate to Plugins. Search for the Yandex Delivery plugin and activate it.
  • Done. Once you complete the installation, you will be prompted to activate the plugin.

Via the hosting’s control panel

  • Go to your hosting’s control panel.
  • Open the file manager.
  • Navigate to your website folder.
  • Open the folder with your plugins. The destination path usually looks like this: Website folder -> Public_html (if exists) -> Wp-content-> Plugins.

Activate the plugin license

Find the license key in the confirmation email from Freemius (with the Thanks for subscribing subject line). Example:

  • In the WordPress Dashboard, navigate to Settings -> Yandex Delivery.
  • Add the license key to the input field and click Submit Key.

Preparing the plugin for work

Set up WooCommerce

Check the store settings in WooCommerce (the General tab). Use the screenshot below as an example of fields you may want to set up.

Add a Shipping Zone (WooCommerce -> Settings -> Shipping).

Add a shipping method.

Select Yandex.Delivery in the drop-down list.

An example of how the shipping settings could look like:

Set up the shipping method for Yandex.Delivery.

Get an API key from Yandex.Delivery

Register your application on Yandex.OAuth:

  • Go to the Create app page.
  • Add App name (it can be anything).
  • Select web services in Platforms. Fill in the Callback URL field. Click Set URL for development.
  • Select Yandex.Delivery in Accesses. Click Use Yandex.Delivery API for partners.
  • Click Create App at the bottom of the page.
  • Open the link with the following structure:<app’s ID>
  • On the new page, click Allow to see the token.
  • Check the Yandex.OAuth Help center to find more information about registering apps.

Find your company number

  • Go to the Yandex Delivery account. If you have several stores on Yandex Delivery, navigate to the one you would like to install our plugin at.
  • Click My Store at the top menu.
  • Copy the part of the company’s number from the drop-down list (see the screenshot):

Find the store identifier

  • Go to Settings on the left side menu.
  • Navigate to Settings -> Stores.
  • Select the current store. An example:
  • Attention, do not confuse the Identifier of the store with StoreID.

Find the warehouse ID

  • Open Settings on the left side menu.                   
  • Navigate to Settings -> Warehouses.
  • Select the current warehouse. An example:

Get the API key of the basket widget

  • Go to Yandex Developer Console.
  • Make sure to log in under your Yandex account with Admin access to the Yandex Delivery store.
  • Click Connect API. Select Yandex.Delivery Widgets and click Continue.
    • Accept Terms of service and click Submit. Fill in the key’s name and click Submit.
    • Open the widget. You will see the API key inside it. An example:

Save settings in the plugin

Copy and paste API Key, Company Number, Store ID, Warehouse ID, and Basket Widget API Key obtained in the previous steps.


You have finished the first step of the plugin setup. To complete the configuration, go to the 

second step

Frequently asked questions (F.A.Q)

Navigate to the Shipping tab and take a screenshot of the product features. An example:

Take a screenshot of WooCommerce Settings -> General.

Take a screenshot of the Shipping Zone settings.

Take a screenshot of Yandex.Delivery settings.

Send the screenshot via the feedback form. Describe in detail what you were trying to do and expected to get.

The plugin was not activated because it caused a fatal error: «The plugin requires Woocommerce«.

You should install and activate WooCommerce. It is a free plugin. You can find it in the WordPress repository.