Loyalty program price

In the price list, enter the loyalty program price and the period for which it is valid. The loyalty program price will be displayed on Yandex.Market along with the standard price:

You may enter a loyalty program price in the price list if the program meets the following conditions:

  • Program participants are given a specified discount (for example, 5% or RUB 1000 on a discount card) or are offered a special (“club”) price on a product.

  • The program price must be automatically applied in the cart. The customer must pay that designated price for the product: the difference from the regular price cannot be credited to the customer in the form of bonus points, cashback, and so on.

  • At the time of purchase, the user must be registered in the loyalty program or be in possession of a long-term card (discount card, club card, etc.). If a discount or special price is given to a user once after a one-time action (for example, after subscription to a newsletter), it isn't considered a loyalty program.

  • The store's website includes a section with a program description and the program's terms of participation.

If the product has several loyalty program prices (for example, with different discounts for different levels of cards), specify in the price list the loyalty program price that is available to participants immediately after registration in the program. For example, if a store has discount cards with 5% and 10% discounts, enter prices with the 5% discount.

Attention. Specific offers may only participate in one promo or loyalty program. If an offer is included in multiple promos or loyalty programs, one will be selected for it at random.
  1. Example
  2. Attributes and elements
  3. Change in price during the period of the program.

Example

Special price from August 10, 2020 through January 1, 2021 (the store is located in Yekaterinburg, the time zone is UTC+5):

<promos>
    <promo id="kartochka" type="bonus card">
        <start-date>2020-08-10 09:00:00+0500</start-date>
        <end-date>2021-01-01 22:00:00+0500</end-date>
        <description>Скидка для владельцев карт лояльности</description>
        <url>http://best.seller.ru/loyalty</url>
        <purchase>
            <product offer-id="77">
                <discount-price currency="RUR">300</discount-price>
            </product>
            <product offer-id="88">
                <discount-price currency="RUR">501</discount-price>
            </product>
        </purchase>
    </promo>
</promos>
View element descriptions in the markup
<promos>
   <promo id="program ID" type="bonus card">
      <start-date>programs start date</start-date>
      <end-date>program end date</end-date>
      <description>summary</description>
      <url>program on the store's site</url>
      <purchase>
          <product offer-id="offer ID participating in the program">
              <discount-price currency="currency">discount price</discount-price>
          </product>
          <!-- other products participating in the program -->
      </purchase>
   </promo>
</promos>

Attributes and elements

Element/attribute Description Required
Attribute id

Loyalty program ID. Can't match the IDs of promotions and other programs. It may contain only numbers and Latin letters. The maximum length of id is 20 characters.

Required
Attribute type

Type of promo — bonus card.

Required
start-date

end-date

Date and time of the beginning and end of the period for which the loyalty program price is valid.

Permissible formats:
  • YYYY-MM-DD — Date: year, month, day (time zone of the region where the store is located).
  • YYYY-MM-DD hh:mm / YYYY-MM-DDThh:mm — Date and time (time zone of the region where the store is located).
  • YYYY-MM-DD hh:mm:ss / YYYY-MM-DDThh:mm:ss — Date and time with seconds (time zone of the region where the store is located).
  • YYYY-MM-DD hh:mmZ / YYYY-MM-DDThh:mmZ — Date and time (Z — time zone, for example, +0300).
  • YYYY-MM-DD hh:mm:ssZ / YYYY-MM-DDThh:mm:ssZ — Date and time with seconds (Z — time zone, for example, +0300).
Examples
  • 2018-09-01
  • 2018-09-01 09:00
  • 2018-09-01 09:00:01
  • 2018-09-01 09:00+0500
  • 2018-09-01 09:00:01+0500

The minimum duration of the price is 2 days: data on promotions is updated on Yandex.Market every 4 hours, and a price that is valid for a short period may not be displayed in time.

Required

description

Short description of the program in Russian. Maximum of 500 characters. You can use XHTML markup, but only as a CDATA block of character data.

Optional
url

Link to the program description and the program's terms of participation on the store's website. The maximum link length is 512 characters. Cyrillic links are permitted. The URL must conform to the RFC 3986 standard.

Required
purchase

Information about products participating in the loyalty program.

Required

Elements in purchase
product

Products participating in the loyalty program. Specify their IDs in the offer-id attribute.

Attention. Categories may not participate in the loyalty program (only individual items may participate).

Each product element corresponds to a single item. A purchase element may contain multiple product elements.

Required
discount-price

Discounted price for the loyalty program. This price must be lower than the standard price of the product. Specify the currency in the currency attribute.

Required

Change in price during the period of the program.

If during the period of the loyalty program you enter a price into the price element and that price is equal to or lower than the special price in the discount-price element, the special price will no longer be displayed for the offer. Instead, Yandex.Market will begin to display the price from the price element.