components:
  examples:
    200-admin-daily-chain:
      summary: Пример ежедневной награды
      value:
        date_end: '2025-04-25T18:16:00+05:00'
        date_start: '2023-04-15T18:16:00+05:00'
        description:
          en: Daily reward short description
        id: 3
        is_enabled: true
        is_recurrent: false
        name:
          en: Daily reward
          ru: Ежедневная награда
        number_of_steps: 3
        order: 1
        steps:
          - items:
              - description:
                  en: Allows to see the stars
                  ru: Позволяет увидеть звезды
                image_url: https://picture.bundle-picture.png
                item_id: 9010
                name:
                  en: Telescope
                  ru: Телескоп
                quantity: 1
                sku: telescope
                type: virtual_good
              - description:
                  en: Heal 10% of your health
                  ru: Лечит 10% здоровья
                image_url: https://picture.bundle-picture.png
                item_id: 9012
                name:
                  en: Healing potion
                  ru: Зелье лечения
                quantity: 2
                sku: health_potion
                type: virtual_good
            step_id: 7
            step_number: 1
          - items:
              - description:
                  en: Allows to see the stars
                  ru: Позволяет увидеть звезды
                image_url: https://picture.bundle-picture.png
                item_id: 9010
                name:
                  en: Telescope
                  ru: Телескоп
                quantity: 5
                sku: telescope
                type: virtual_good
            step_id: 6
            step_number: 2
          - items:
              - description:
                  en: Allows to see the stars
                  ru: Позволяет увидеть звезды
                image_url: https://picture.bundle-picture.png
                item_id: 9010
                name:
                  en: Telescope
                  ru: Телескоп
                quantity: 2
                sku: telescope
                type: virtual_good
            step_id: 5
            step_number: 3
        type: calendar_hard
    200-admin-daily-chain-list:
      summary: Пример списка ежедневных наград
      value:
        has_more: false
        items:
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description:
              en: Daily reward short description
            id: 1
            is_enabled: false
            is_recurrent: true
            name:
              en: Daily reward
              ru: Ежедневная награда
            number_of_steps: 10
            order: 1
            type: calendar_hard
          - date_end: '2025-04-28T15:00:00+08:00'
            date_start: '2025-04-15T00:00:00+08:00'
            description:
              en: Monthly daily reward short description
            id: 2
            is_enabled: false
            is_recurrent: true
            name:
              en: Monthly daily reward
              ru: Ежедневные награды в цепочке на месяц
            number_of_steps: 13
            order: 2
            type: calendar_hard
          - date_end: '2025-05-31T18:16:00+05:00'
            date_start: '2023-05-01T18:16:00+05:00'
            description:
              en: Login reward short description
            id: 3
            is_enabled: true
            is_recurrent: true
            name:
              en: Login reward
            number_of_steps: 7
            order: 3
            type: rolling_skippable
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description:
              en: Daily reward short description
            id: 4
            is_enabled: true
            is_recurrent: true
            name:
              en: Daily reward
              ru: Ежедневная награда
            number_of_steps: 10
            order: 4
            type: calendar_hard
          - date_end: '2025-11-30T10:00:00+05:00'
            date_start: '2025-11-01T10:00:00+05:00'
            description:
              en: Unskippable login reward short description
            id: 5
            is_enabled: true
            is_recurrent: true
            name:
              en: Unskippable login reward
            number_of_steps: 7
            order: 3
            type: rolling_unskippable
        total_items_count: 3
    200-admin-offer-chain:
      summary: Пример цепочки предложений
      value:
        attribute_conditions:
          - attribute: race
            can_be_missing: false
            operator: eq
            type: string
            value: elf
          - attribute: level
            can_be_missing: false
            operator: ge
            type: number
            value: '10'
          - attribute: 10_level_up_date
            can_be_missing: false
            operator: le
            type: date
            value: '2026-01-01T00:00:00'
        date_end: '2025-04-25T18:16:00+05:00'
        date_start: '2023-04-15T18:16:00+05:00'
        description:
          de: >-
            Personalisierte Angebotskette mit Benutzerattributbedingungen - für
            Elfen der Stufe 10 und höher, die Stufe 10 spätestens am 2026-01-01
            00:00:00 erreicht haben, einschließlich
          en: >-
            Personalized offer chain with user attribute conditions - for level
            10 and above elves who reached level 10 no later than 2026-01-01
            00:00:00, inclusive
          fr: >-
            Chaîne d'offres personnalisée avec des conditions d'attribut
            utilisateur - pour les elfes de niveau 10 et plus qui ont atteint le
            niveau 10 au plus tard le 2026-01-01 00:00:00, inclus
          it: >-
            Catena di offerte personalizzata con condizioni di attributo utente
            - per elfi di livello 10 e superiore che hanno raggiunto il livello
            10 non più tardi del 2026-01-01 00:00:00, inclusi
          ru: >-
            Персонализированная цепочка предложений - для эльфов 10 уровня и
            выше, достигших 10 уровня не позднее 2026-01-01 00:00:00
            включительно
        id: 3
        is_always_visible: false
        is_enabled: true
        name:
          de: Angebotskette
          en: Offer chain
          fr: Chaîne d'offres
          it: Catena di offerte
          ru: Цепочка
        order: 1
        recurrent_schedule: null
        steps:
          - is_free: false
            items:
              - description:
                  de: Ermöglicht das Betrachten der Sterne
                  en: Allows to see the stars
                  fr: Permet de voir les étoiles
                  it: Permette di vedere le stelle
                  ru: Позволяет увидеть звезды
                image_url: https://cdn.picture.vg.sku-telescope.png
                item_id: 9010
                name:
                  de: Teleskop
                  en: Telescope
                  fr: Télescope
                  it: Telescopio
                  ru: Телескоп
                order: 1
                quantity: 1
                sku: telescope
                type: virtual_good
              - description:
                  de: Heilt 10% deiner Gesundheit
                  en: Heal 10% of your health
                  fr: Soigne 10% de votre santé
                  it: Cura il 10% della tua salute
                  ru: Лечит 10% здоровья
                image_url: https://cdn.picture/vg-sku-health_potion.png
                item_id: 9012
                name:
                  de: Heiltrank
                  en: Healing potion
                  fr: Potion de soin
                  it: Pozione curativa
                  ru: Зелье лечения
                order: 0
                quantity: 2
                sku: health_potion
                type: virtual_good
            step_id: 7
            step_number: 1
          - is_free: false
            items:
              - description:
                  de: Ermöglicht das Betrachten der Sterne
                  en: Allows to see the stars
                  fr: Permet de voir les étoiles
                  it: Permette di vedere le stelle
                  ru: Позволяет увидеть звезды
                image_url: https://cdn.picture/vg-sku-telescope.png
                item_id: 9010
                name:
                  de: Teleskop
                  en: Telescope
                  fr: Télescope
                  it: Telescopio
                  ru: Телескоп
                order: 0
                quantity: 5
                sku: telescope
                type: virtual_good
            step_id: 6
            step_number: 2
          - is_free: true
            items:
              - description:
                  de: Ermöglicht das Betrachten der Sterne
                  en: Allows to see the stars
                  fr: Permet de voir les étoiles
                  it: Permette di vedere le stelle
                  ru: Позволяет увидеть звезды
                image_url: https://cdn.picture/vg-sku-telescope.png
                item_id: 9010
                name:
                  de: Teleskop
                  en: Telescope
                  fr: Télescope
                  it: Telescopio
                  ru: Телескоп
                order: 0
                quantity: 2
                sku: telescope
                type: virtual_good
            step_id: 5
            step_number: 3
    200-admin-offer-chain-list:
      summary: Пример списка цепочек предложений
      value:
        has_more: false
        items:
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description:
              de: >-
                Standard-personalisierte Angebotskette für Benutzer, die die
                Bedingungen anderer personalisierter Ketten nicht erfüllen
              en: >-
                Default personalized offer chain for users that do not meet the
                conditions of other personalized chains
              fr: >-
                Chaîne d'offres personnalisée par défaut pour les utilisateurs
                qui ne répondent pas aux conditions des autres chaînes
                personnalisées
              it: >-
                Catena di offerte personalizzata predefinita per gli utenti che
                non soddisfano le condizioni di altre catene personalizzate
              ru: >-
                Персонализированная цепочка по умолчанию для пользователей, не
                подходящих под условия других персонализированных цепочек
            id: 1
            is_always_visible: false
            is_enabled: true
            name:
              de: Neue personalisierte Standard-Angebotskette
              en: New personalized default offer chain
              fr: Nouvelle chaîne d'offres personnalisée par défaut
              it: Nuova catena di offerte personalizzata predefinita
              ru: Новая персонализированная цепочка предложений по умолчанию
            order: 1
            recurrent_schedule: null
          - attribute_conditions:
              - attribute: race
                can_be_missing: false
                operator: eq
                type: string
                value: elf
              - attribute: level
                can_be_missing: false
                operator: ge
                type: number
                value: '10'
              - attribute: 10_level_up_date
                can_be_missing: false
                operator: le
                type: date
                value: '2026-01-01T00:00:00'
            date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description:
              de: >-
                Personalisierte Angebotskette mit Benutzerattributbedingungen -
                für Elfen der Stufe 10 und höher, die Stufe 10 spätestens am
                2026-01-01 00:00:00 erreicht haben, einschließlich
              en: >-
                Personalized offer chain with user attribute conditions - for
                level 10 and above elves who reached level 10 no later than
                2026-01-01 00:00:00, inclusive
              fr: >-
                Chaîne d'offres personnalisée avec des conditions d'attribut
                utilisateur - pour les elfes de niveau 10 et plus qui ont
                atteint le niveau 10 au plus tard le 2026-01-01 00:00:00, inclus
              it: >-
                Catena di offerte personalizzata con condizioni di attributo
                utente - per elfi di livello 10 e superiore che hanno raggiunto
                il livello 10 non più tardi del 2026-01-01 00:00:00, inclusi
              ru: >-
                Персонализированная цепочка предложений с условиями по атрибутам
                пользователя - для эльфов уровня 10 и выше, достигших 10 уровня
                не позднее 2026-01-01 00:00:00 включительно
            id: 2
            is_always_visible: false
            is_enabled: true
            name:
              de: Neue personalisierte Angebotskette
              en: New personalized offer chain
              fr: Nouvelle chaîne d'offres personnalisée
              it: Nuova catena di offerte personalizzata
              ru: Новая персонализированная цепочка предложений
            order: 2
            recurrent_schedule: null
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description:
              de: >-
                Angebotskette, die sich wöchentlich mittwochs um 07:00 Uhr GMT+3
                zurücksetzt
              en: Offer chain that resets weekly on Wednesdays at 07:00 GMT+3
              fr: >-
                Chaîne d'offres qui se réinitialise chaque semaine le mercredi à
                07h00 GMT+3
              it: >-
                Catena di offerte che si resetta settimanalmente il mercoledì
                alle 07:00 GMT+3
              ru: >-
                Цепочка предложений, которая сбрасывается еженедельно по средам
                в 07:00 GMT+3
            id: 4
            is_always_visible: true
            is_enabled: false
            name:
              de: Wöchentliche Angebotskette
              en: Weekly offer chain
              fr: Chaîne d'offres hebdomadaire
              it: Catena di offerte settimanale
              ru: Еженедельная цепочка предложений
            order: 3
            recurrent_schedule:
              day_of_week: 3
              displayable_reset_next_date: '2018-12-05T07:00:00+03:00'
              displayable_reset_start_date: '2018-12-05T07:00:00+03:00'
              interval_type: weekly
              reset_next_date: 1543982400
              time: 07:00:00+03:00
          - date_end: '2025-08-28T15:00:00+08:00'
            date_start: '2025-04-15T00:00:00+08:00'
            description:
              de: >-
                Angebotskette, die sich monatlich am 28. um 15:00 Uhr GMT+8
                zurücksetzt
              en: Offer chain that resets monthly on the 28th at 15:00 GMT+8
              fr: >-
                Chaîne d'offres qui se réinitialise mensuellement le 28 à 15h00
                GMT+8
              it: >-
                Catena di offerte che si resetta mensilmente il 28 alle 15:00
                GMT+8
              ru: >-
                Цепочка предложений, которая сбрасывается ежемесячно 28-го числа
                в 15:00 GMT+8
            id: 5
            is_always_visible: true
            is_enabled: true
            name:
              de: Monatliche Angebotskette
              en: Monthly offer chain
              fr: Chaîne d'offres mensuelle
              it: Catena di offerte mensile
              ru: Ежемесячная цепочка предложений
            order: 4
            recurrent_schedule:
              day_of_month: 28
              displayable_reset_next_date: '2025-05-28T15:00:00+08:00'
              displayable_reset_start_date: '2025-05-28T15:00:00+08:00'
              interval_type: monthly
              reset_next_date: 1748415600
              time: 15:00:00+08:00
    200-clan-reward-chain:
      summary: Пример клановой цепочки наград
      value:
        clan_type: guild
        description:
          en: Clan reward chain description.
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
        is_enabled: true
        long_description:
          en: Clan reward chain long description.
        name:
          en: Clan reward chain
        order: 1
        periods:
          - date_from: '2020-04-15T18:16:00+05:00'
            date_until: '2021-04-15T18:16:00+05:00'
        popup_header:
          en: How to unlock rewards
        popup_image_url: >-
          https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
        popup_instruction:
          en: >-
            You must be a clan member in order to get clan rewards. You join a
            clan when a clan member invites you to the clan, and you accept the
            invite. You can also create your own clan.
        recurrent_schedule:
          day_of_week: 2
          displayable_reset_next_date: '2023-03-07T11:00:00+08:00'
          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
          interval_type: weekly
          reset_next_date: 1677553200
          time: 11:00:00+08:00
        reward_chain_id: 1
        steps:
          - image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            name:
              en: First step of the reward chain
            price:
              amount: 10
            reward:
              - quantity: 5
                sku: com.xsolla.item_1
              - quantity: 1
                sku: com.xsolla.item_2
            step_id: 1
          - image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            name:
              en: Second step of the reward chain
            price:
              amount: 15
            reward:
              - quantity: 5
                sku: com.xsolla.item_3
              - quantity: 1
                sku: com.xsolla.item_4
            step_id: 2
        value_point:
          description:
            en: Value points for clan reward system.
          image_url: >-
            https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
          is_clan: true
          is_enabled: true
          long_description:
            en: >-
              Value points given to clans to get new rewards in a certain reward
              chain.
          media_list: []
          name:
            en: Clan Reward VP 1
          order: 1
          sku: com.xsolla.clan_value_point_1
    200-client-daily-chain:
      summary: Пример ежедневной награды пользователя
      value:
        date_end: '2025-04-03T18:16:00+05:00'
        date_start: '2025-04-01T18:16:00+05:00'
        description: Active daily reward description
        id: 101
        name: Active daily reward
        order: 1
        steps:
          - items:
              - bundle_type: standard
                content:
                  - description: Virtual good one
                    image_url: https://picture.virtual-good-picture.png
                    is_free: false
                    item_id: 1
                    name: virtual_good_one
                    quantity: 1
                    sku: d0df11c5-f7c4-4907-9ae1-7dd40cecab05
                    type: virtual_good
                  - description: Gold Coins
                    image_url: https://picture.gold_coins.png
                    is_free: false
                    item_id: 2
                    name: Gold Coins
                    quantity: 100
                    sku: coins
                    type: virtual_currency
                description: Many stuff
                image_url: https://picture.bundle-with-many-stuff.png
                is_free: false
                item_id: 10001
                name: Bundle with awesome stuff!
                quantity: 1
                sku: bundle_with_items
                type: bundle
            status: blocked
            step_number: 1
            unlocked_date: 1711978560
          - items:
              - description: Heal 10% of your health
                image_url: https://picture.bundle-picture.png
                is_free: false
                item_id: 9012
                name: Healing potion
                quantity: 1
                sku: health_potion
                type: virtual_good
            status: claimed
            step_number: 2
            unlocked_date: 1712064960
          - items:
              - description: Heal 10% of your health
                image_url: https://picture.bundle-picture.png
                is_free: false
                item_id: 9012
                name: Healing potion
                quantity: 2
                sku: health_potion
                type: virtual_good
            status: claimable
            step_number: 3
            unlocked_date: 1712151360
          - items:
              - description: store_item_0_lost_telescope_2_short_description
                image_url: https://picture.bundle-picture.png
                is_free: false
                item_id: 9011
                name: Free item
                quantity: 1
                sku: free_item
                type: virtual_good
            status: claim_in_future
            step_number: 4
            unlocked_date: 1712237760
        type: calendar_hard
    200-client-daily-chain-list:
      summary: Пример списка ежедневных наград пользователя
      value:
        has_more: false
        items:
          - date_end: '2025-04-03T18:16:00+05:00'
            date_start: '2025-04-01T18:16:00+05:00'
            description: null
            id: 101
            name: Active daily reward
            order: 1
            steps:
              - items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    quantity: 1
                    sku: health_potion
                    type: virtual_good
                status: claimed
                step_number: 1
                unlocked_date: 1711978560
              - items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    quantity: 2
                    sku: health_potion
                    type: virtual_good
                status: claimable
                step_number: 2
                unlocked_date: 1712064960
              - items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    quantity: 1
                    sku: free_item
                    type: virtual_good
                status: claim_in_future
                step_number: 3
                unlocked_date: 1712151360
            type: calendar_hard
          - date_end: '2025-05-03T18:16:00+05:00'
            date_start: '2025-05-01T18:16:00+05:00'
            description: null
            id: 102
            name: Active daily reward 2
            order: 1
            steps:
              - items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    quantity: 3
                    sku: free_item
                    type: virtual_good
                status: claimable
                step_number: 1
                unlocked_date: 1714560960
              - items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    quantity: 3
                    sku: health_potion
                    type: virtual_good
                status: claim_in_future
                step_number: 2
                unlocked_date: 1714647360
            type: calendar_hard
          - date_end: '2025-04-03T18:16:00+05:00'
            date_start: '2025-04-01T18:16:00+05:00'
            description: null
            id: 103
            name: Active daily reward 3
            order: 1
            steps:
              - items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    quantity: 3
                    sku: free_item
                    type: virtual_good
                status: claimable
                step_number: 1
                unlocked_date: 1711978560
              - items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    quantity: 3
                    sku: health_potion
                    type: virtual_good
                status: blocked
                step_number: 2
                unlocked_date: 1712064960
              - items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    quantity: 3
                    sku: health_potion
                    type: virtual_good
                status: blocked
                step_number: 3
                unlocked_date: 1712151360
            type: calendar_hard
          - date_end: '2025-04-28T10:00:00+05:00'
            date_start: '2025-04-01T10:00:00+05:00'
            description: null
            id: 104
            name: Active daily rolling reward
            order: 1
            steps:
              - items:
                  - description: Item one description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 1001
                    name: Item One
                    quantity: 1
                    sku: item_one
                    type: virtual_good
                status: claimed
                step_number: 1
                unlocked_date: -1
              - items:
                  - description: Item two description
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 1002
                    name: Item Two
                    quantity: 1
                    sku: item_two
                    type: virtual_good
                status: claimable
                step_number: 2
                unlocked_date: 1712064960
              - items:
                  - description: Item three description
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 1003
                    name: Item Three
                    quantity: 1
                    sku: item_three
                    type: virtual_good
                status: claim_in_future
                step_number: 3
                unlocked_date: 1712151360
            type: rolling_skippable
        total_items_count: 3
    200-client-get-reward-chains-list:
      value:
        has_more: false
        items:
          - clan_type: null
            date_end: '2023-04-25T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description: Big weekly quest
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            long_description: >-
              You can get a lot of additional items just by shopping during the
              week
            name: Weekly quest
            order: 1
            popup_header: null
            popup_image_url: null
            popup_instruction: null
            recurrent_schedule:
              interval_type: weekly
              reset_next_date: 1746057600
            reward_chain_id: 10
            steps:
              - image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_claimed: true
                name: Level 1
                price:
                  amount: 100
                reward:
                  - description: Super box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Super box
                    quantity: 1
                    sku: com.xsolla.box_1
                    type: bundle
                  - description: Mega box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Mega box
                    quantity: 1
                    sku: com.xsolla.box_2
                    type: bundle
                step_id: 1
              - image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_claimed: false
                name: Level 2
                price:
                  amount: 200
                reward:
                  - description: Super box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Super box
                    quantity: 2
                    sku: com.xsolla.box_1
                    type: bundle
                  - description: Mega box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Mega box
                    quantity: 2
                    sku: com.xsolla.box_2
                    type: bundle
                step_id: 2
            top_contributors: []
            value_point:
              amount: 130
              description: null
              image_url: >-
                https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
              long_description: null
              name: Value point
              sku: com.xsolla.value_point_1
          - clan_type: guild
            date_end: '2023-10-15T18:16:00+05:00'
            date_start: '2023-04-15T18:16:00+05:00'
            description: Major weekly clan quest.
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            long_description: >-
              You and your clan members can get additional items for shopping
              during a certain month.
            name: Weekly clan quest
            order: 2
            popup_header:
              en: How to unlock rewards
            popup_image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            popup_instruction:
              en: >-
                You should be a clan member to get clan rewards. You join a clan
                when a clan member invited you to the clan, and you accepted the
                invite. You can create your own clan.
            recurrent_schedule:
              interval_type: monthly
              reset_next_date: 1746057600
            reward_chain_id: 12
            steps:
              - image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_claimed: true
                name: Level 1
                price:
                  amount: 100
                reward:
                  - description: Super box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Super box
                    quantity: 1
                    sku: com.xsolla.box_1
                    type: bundle
                  - description: Mega box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Mega box
                    quantity: 1
                    sku: com.xsolla.box_2
                    type: bundle
                step_id: 1
              - image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_claimed: false
                name: Level 2
                price:
                  amount: 200
                reward:
                  - description: Super box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Super box
                    quantity: 2
                    sku: com.xsolla.box_1
                    type: bundle
                  - description: Mega box with items
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    name: Mega box
                    quantity: 2
                    sku: com.xsolla.box_2
                    type: bundle
                step_id: 2
            top_contributors:
              - contributed_amount: 100
                name: Rabbit
              - contributed_amount: 80
                name: Rocket
              - contributed_amount: 40
                name: Rain
            value_point:
              amount: 80
              description: Value points for clan reward system.
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
              long_description: >-
                Value points given to clans to get new rewards in a reward
                chain.
              name: Clan Reward VP 1
              sku: com.xsolla.clan_value_point_1
        total_items_count: 1
    200-client-get-user-clan-reward-chain-balance:
      summary: Пример клановой цепочки наград
      value:
        amount: 80
        description: Value points for clan reward system.
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
        is_clan: true
        long_description: Value points given to clans to get new rewards in a reward chain.
        name: Clan Reward VP 1
        sku: com.xsolla.clan_value_point_1
    200-client-get-user-reward-chain-balance:
      summary: Пример цепочки наград
      value:
        amount: 130
        description: null
        image_url: >-
          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
        is_clan: false
        long_description: null
        name: Value point
        sku: com.xsolla.value_point_1
    200-client-offer-chain:
      summary: Пример цепочки предложений для текущего пользователя
      value:
        date_end: '2025-04-25T18:16:00+05:00'
        date_start: '2010-04-15T18:16:00+05:00'
        description: null
        id: 4
        name: Offer chain with bundles
        next_step_number: 1
        order: 1
        recurrent_schedule: null
        steps:
          - is_claimed: false
            is_free: false
            items:
              - bundle_type: standard
                content:
                  - description: >-
                      virtual_good_short_description_d0df11c5-f7c4-4907-9ae1-7dd40cecab05
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png
                    is_free: false
                    item_id: 1
                    name: Virtual Good Bundle
                    quantity: 1
                    sku: d0df11c5-f7c4-4907-9ae1-7dd40cecab05
                    type: virtual_good
                  - description: Big Rocket - short description
                    image_url: https://picture.bigrocket.png
                    is_free: false
                    item_id: 7009
                    name: Big Rocket
                    quantity: 1
                    sku: vg-in-bundle-big-rocket
                    type: virtual_good
                  - description: Gold Coins - short description
                    image_url: https://picture.gold_coins.png
                    is_free: true
                    item_id: 7010
                    name: Gold Coins
                    quantity: 100
                    sku: vc-in-bundle-gold-coins
                    type: virtual_currency
                  - description: Some Game - short description
                    image_url: https://picture.some_game.png
                    is_free: true
                    item_id: 7011
                    name: Some Game
                    quantity: 1
                    sku: digital-content-drm-in-bundle-awesome-game
                    type: virtual_good
                  - bundle_type: standard
                    content:
                      - description: Gold Coins - short description
                        image_url: https://picture.gold_coins.png
                        is_free: true
                        item_id: 7010
                        name: Gold Coins
                        quantity: 1
                        sku: vc-in-bundle-gold-coins
                        type: virtual_currency
                    description: Bundle - short description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 7012
                    name: Some Bundle in Bundle
                    quantity: 1
                    sku: bundle-in-bundle-another-bundle
                    type: bundle
                  - description: Lootbox in bundle - short description
                    image_url: https://picture.lootbox-picture.png
                    is_free: true
                    item_id: 7013
                    name: Some Lootbox
                    quantity: 1
                    sku: lootbox-in-bundle-awesome-game
                    type: lootbox
                description: Many stuff
                image_url: https://picture.bundle-with-many-stuff.png
                is_free: false
                item_id: 7008
                name: Bundle with many awesome stuff!
                order: 0
                quantity: 5
                sku: bundle_with_many_items
                type: bundle
            step_number: 1
            step_price:
              amount: 499.95
              currency: USD
            step_vp_rewards: null
          - is_claimed: false
            is_free: true
            items:
              - bundle_type: standard
                content: []
                description: 'No'
                image_url: https://picture.bundle-no-items.png
                is_free: true
                item_id: 7007
                name: Empty bundle
                order: 0
                quantity: 10
                sku: bundle-empty
                type: bundle
            step_number: 2
            step_price: null
            step_vp_rewards: null
    200-client-offer-chain-list:
      summary: Пример списка цепочек предложений для текущего пользователя
      value:
        has_more: false
        items:
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2018-04-15T18:16:00+05:00'
            description: null
            id: 101
            name: Active offer chain
            next_step_number: 1
            order: 1
            recurrent_schedule: null
            steps:
              - is_claimed: false
                is_free: false
                items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    order: 0
                    quantity: 1
                    sku: health_potion
                    type: virtual_good
                step_number: 1
                step_price:
                  amount: 99.99
                  currency: USD
                step_vp_rewards:
                  - amount: 15
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png
                    is_clan: true
                    item_id: 6039
                    name: store_item_0_test_value_point_name
                    sku: test_value_point_39
              - is_claimed: false
                is_free: false
                items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    order: 0
                    quantity: 2
                    sku: health_potion
                    type: virtual_good
                step_number: 2
                step_price:
                  amount: 199.98
                  currency: USD
                step_vp_rewards:
                  - amount: 30
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png
                    is_clan: true
                    item_id: 6039
                    name: store_item_0_test_value_point_name
                    sku: test_value_point_39
              - is_claimed: false
                is_free: true
                items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    order: 0
                    quantity: 1
                    sku: free_item
                    type: virtual_good
                step_number: 3
                step_price: null
                step_vp_rewards: null
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2018-04-15T18:16:00+05:00'
            description: null
            id: 102
            name: Active offer chain 2
            next_step_number: 1
            order: 1
            recurrent_schedule: null
            steps:
              - is_claimed: false
                is_free: true
                items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    order: 0
                    quantity: 3
                    sku: free_item
                    type: virtual_good
                step_number: 1
                step_price: null
                step_vp_rewards: null
              - is_claimed: false
                is_free: true
                items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    order: 0
                    quantity: 3
                    sku: health_potion
                    type: virtual_good
                step_number: 2
                step_price: null
                step_vp_rewards:
                  - amount: 45
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png
                    is_clan: true
                    item_id: 6039
                    name: store_item_0_test_value_point_name
                    sku: test_value_point_39
              - is_claimed: false
                is_free: true
                items: []
                step_number: 3
                step_price: null
                step_vp_rewards: null
          - date_end: '2025-04-25T18:16:00+05:00'
            date_start: '2018-04-15T18:16:00+05:00'
            description: null
            id: 103
            name: Active offer chain 3
            next_step_number: 1
            order: 1
            recurrent_schedule: null
            steps:
              - is_claimed: false
                is_free: true
                items:
                  - description: store_item_0_lost_telescope_2_short_description
                    image_url: https://picture.bundle-picture.png
                    is_free: true
                    item_id: 9011
                    name: Free item
                    order: 0
                    quantity: 3
                    sku: free_item
                    type: virtual_good
                step_number: 1
                step_price: null
                step_vp_rewards: null
              - is_claimed: false
                is_free: false
                items:
                  - description: Heal 10% of your health
                    image_url: https://picture.bundle-picture.png
                    is_free: false
                    item_id: 9012
                    name: Healing potion
                    order: 0
                    quantity: 3
                    sku: health_potion
                    type: virtual_good
                step_number: 2
                step_price:
                  amount: 299.97
                  currency: USD
                step_vp_rewards:
                  - amount: 45
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/female/accessory/female_crossnecklace_2_silver-01.png
                    is_clan: true
                    item_id: 6039
                    name: store_item_0_test_value_point_name
                    sku: test_value_point_39
              - is_claimed: false
                is_free: true
                items: []
                step_number: 3
                step_price: null
                step_vp_rewards: null
        total_items_count: 3
    200-client-update-user-clan:
      value:
        reward:
          - bundle_type: standard
            description: Super box with items
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
            name: Super box
            quantity: 1
            sku: com.xsolla.box_1
            type: bundle
          - description: Mega potion
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
            name: Mega potion
            quantity: 1
            sku: com.xsolla.potion_1
            type: virtual_good
    200-reward-chain:
      summary: Пример цепочки наград
      value:
        attribute_conditions:
          - attribute: race
            can_be_missing: false
            operator: eq
            type: string
            value: ork
        description:
          en: Reward chain description
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
        is_always_visible: true
        is_enabled: true
        is_reset_after_end: true
        long_description:
          en: Reward chain long description
        name:
          en: Reward chain
        order: 1
        periods:
          - date_from: '2026-01-01T01:00:00+05:00'
            date_until: '2026-01-31T23:59:59+05:00'
          - date_from: '2026-02-01T01:00:00+05:00'
            date_until: '2026-02-28T23:59:59+05:00'
        recurrent_schedule:
          day_of_week: 2
          displayable_reset_next_date: '2026-01-06T01:00:00+05:00'
          displayable_reset_start_date: '2026-01-01T01:00:00+05:00'
          interval_type: weekly
          reset_next_date: 1767643200
          time: 01:00:00+05:00
        reward_chain_id: 1
        steps:
          - image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            name:
              en: First step of the reward chain
            price:
              amount: 10
            reward:
              - quantity: 5
                sku: com.xsolla.item_1
              - quantity: 1
                sku: com.xsolla.item_2
            step_id: 1
          - image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            name:
              en: Second step of the reward chain
            price:
              amount: 15
            reward:
              - quantity: 5
                sku: com.xsolla.item_3
              - quantity: 1
                sku: com.xsolla.item_4
            step_id: 2
        value_point:
          description:
            en: Value points for reward system.
          image_url: >-
            https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
          is_clan: false
          is_enabled: true
          long_description:
            en: Value points given to users to get new rewards in a reward chain.
          media_list: []
          name:
            en: Reward VP 1
          order: 1
          sku: com.xsolla.reward_vp_1
          type: value_point
    200-reward-chain-list:
      value:
        has_more: true
        items:
          - attribute_conditions:
              - attribute: race
                can_be_missing: false
                operator: eq
                type: string
                value: ork
            description:
              en: Reward chain description
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            is_always_visible: true
            is_enabled: true
            is_reset_after_end: true
            long_description:
              en: Reward chain long description
            name:
              en: Reward chain
            order: 1
            periods:
              - date_from: '2026-01-01T01:00:00+05:00'
                date_until: '2026-01-31T23:59:59+05:00'
              - date_from: '2026-02-01T01:00:00+05:00'
                date_until: '2026-02-28T23:59:59+05:00'
            recurrent_schedule: null
            reward_chain_id: 1
            value_point:
              description: Value points for standard reward system.
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
              is_clan: false
              is_enabled: true
              long_description: >-
                Value points given to users to get new rewards in a reward
                chain.
              media_list: []
              name:
                en: Reward VP 1
              order: 1
              sku: com.xsolla.reward_vp_1
              type: value_point
          - clan_type: guild
            description:
              en: Clan reward chain description.
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            is_enabled: true
            long_description:
              en: Clan reward chain long description.
            name:
              en: Clan reward chain
            order: 1
            periods:
              - date_from: '2026-01-01T01:00:00+05:00'
                date_until: '2026-01-31T23:59:59+05:00'
              - date_from: '2026-02-01T01:00:00+05:00'
                date_until: '2026-02-28T23:59:59+05:00'
            popup_header:
              en: How to unlock rewards
            popup_image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            popup_instruction:
              en: >-
                You must be a clan member in order to get clan rewards. You join
                a clan when a clan member invites you to the clan, and you
                accept the invite. You can also create your own clan.
            recurrent_schedule:
              day_of_month: null
              day_of_week: 2
              displayable_reset_next_date: '2026-01-06T01:00:00+05:00'
              displayable_reset_start_date: '2026-01-01T01:00:00+05:00'
              interval_type: weekly
              reset_next_date: 1767643200
              time: 01:00:00+05:00
            reward_chain_id: 2
            value_point:
              description: Value points for clan reward system.
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
              is_clan: true
              is_enabled: true
              long_description: >-
                Value points given to clans to get new rewards in a reward
                chain.
              media_list: []
              name:
                en: Clan Reward VP 1
              order: 1
              sku: com.xsolla.clan_value_point_1
    200-value-points-reward-chain_admin_get-value-point:
      value:
        can_delete: false
        description:
          en: Points for reward system
        image_url: >-
          https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
        is_clan: false
        is_enabled: true
        long_description:
          en: Points given to users to get new rewards in a reward chain.
        media_list: []
        name:
          en: Reward VP 1
        order: 1
        sku: com.xsolla.reward_vp_1
        type: value_point
    200-value-points-reward-chain_admin_get-value-point-list:
      value:
        items:
          - description:
              en: Points for reward system
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            is_clan: false
            is_enabled: true
            long_description:
              en: Points given to users to get new rewards in a reward chain.
            media_list: []
            name:
              en: Reward VP 1
            order: 1
            sku: com.xsolla.reward_vp_1
            type: value_point
          - description:
              en: Value points for reward system.
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            is_clan: false
            is_enabled: false
            long_description:
              en: >-
                Value points given to users to get new rewards in a reward
                chain.
            media_list: []
            name:
              en: Reward VP 2
            order: 2
            sku: com.xsolla.reward_vp_2
            type: value_point
          - description:
              en: Value points for clan reward system.
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            is_clan: true
            is_enabled: true
            long_description:
              en: >-
                Value points given to clans to get new rewards in a reward
                chain.
            media_list: []
            name:
              en: Clan Reward VP 1
            order: 3
            sku: com.xsolla.clan_value_point_1
    200-value-points-rewards-list:
      value:
        items:
          - amount: 100
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            item_id: 14232
            name:
              en: Booster
            sku: com.xsolla.booster_1
          - amount: 200
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
            item_id: 14232
            name:
              en: Mega Booster
            sku: com.xsolla.booster_mega
    401-complex-auth-header-not-found:
      value:
        errorCode: 1501
        errorMessage: '[0401-1501]: Authorization failed: Authorization header not sent'
        statusCode: 401
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    401-complex-auth-incorrect-credentials:
      value:
        errorCode: 1013
        errorMessage: '[0401-1013]: Token not found.'
        statusCode: 401
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-attribute-not-found:
      value:
        errorCode: 9901
        errorMessage: '[0401-9901]: Attribute not found.'
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-attribute-value-not-found:
      value:
        errorCode: 9906
        errorMessage: '[0401-9906]: Attribute value not found.'
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-coupon-not-found:
      value:
        errorCode: 9802
        errorMessage: '[0401-9802]: Coupon not found'
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-daily-chain-not-found:
      description: Daily reward was not found.
      summary: Ежедневная награда не найдена
      value:
        errorCode: 6201
        errorMessage: '[0401-6201]: Chain not found'
        errorMessageExtended:
          chain_id: 4
          project_id: 0
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-daily-chain-step-not-found:
      description: Daily reward step was not found.
      summary: Уровень ежедневной награды не найден
      value:
        errorCode: 6304
        errorMessage: '[0401-6304]: Daily Chain Step not found'
        errorMessageExtended:
          chain_id: 100
          step_number: 1
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-game-code-not-found:
      value:
        errorCode: 4603
        errorMessage: '[0401-4603]: Game code not found.'
        statusCode: 404
        transactionId: transaction id
    404-item-by-sku-not-found:
      value:
        errorCode: 4001
        errorMessage: '[0401-4001]: Item with sku = ''item_sku'' not found'
        statusCode: 404
        transactionId: transaction id
    404-offer-chain-not-found:
      description: Offer chain step was not found.
      summary: Цепочка не найдена
      value:
        errorCode: 6201
        errorMessage: '[0401-6201]: Chain not found'
        errorMessageExtended:
          chain_id: 4
          project_id: 0
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-offer-chain-step-not-found:
      description: Offer chain step was not found.
      summary: Уровень цепочки не найден
      value:
        errorCode: 6304
        errorMessage: '[0401-6304]: Offer Chain Step not found'
        errorMessageExtended:
          chain_id: 100
          step_number: 1
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    404-promotion-by-id-not-found:
      value:
        errorCode: 1101
        errorMessage: '[0401-1101]: Promotion not found'
        statusCode: 404
        transactionId: transaction id
    404-user-not-found:
      value:
        errorCode: 5008
        errorMessage: '[0401-5008]: Could not find User'
        statusCode: 404
        transactionId: transaction id
    422-activate-deactivate-promotion:
      value:
        errorCode: 9505
        errorMessage: '[0401-9505]: Error was occurred while promotion was being updated'
        statusCode: 422
        transactionId: da145238620011eb8e24fe6913ff226a
    422-admin-daily-chain-error-activated:
      description: Active daily reward have to be deactivated before being updated.
      summary: Активная ежедневная награда не может быть обновлена
      value:
        errorCode: 6209
        errorMessage: >-
          [0401-6209]: Active chain cannot be updated. Please deactivate it
          first
        errorMessageExtended:
          chain_id: 2
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-chain-id-mismatch:
      description: Daily reward ID specified in the body does not match the URL.
      summary: ID ежедневной награды не подходит
      value:
        errorCode: 6205
        errorMessage: >-
          [0401-6205]: Chain ID mismatch. Please, check the chain ID in your
          request body and URL
        errorMessageExtended:
          body_chain_id: 2
          project_id: 0
          url_chain_id: 1
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-duplicate-step-ids:
      description: >-
        Please, ensure that daily reward step IDs are unique in the request
        body.
      summary: ID уровней ежедневной награды дублируются
      value:
        errorCode: 6207
        errorMessage: '[0401-6207]: Duplicate chain step IDs detected in the request body'
        errorMessageExtended:
          chain_id: 3
          chain_step_id_list:
            - 8
            - 9
            - 10
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-incorrect-items:
      description: >-
        Specified items are not allowed, disabled or not found. Only enabled
        items of following types are allowed: virtual item, bundle, virtual
        currency package.
      summary: Некорректные товары для уровня цепочки
      value:
        errorCode: 6211
        errorMessage: '[0401-6211]: Chain steps items are not allowed or not found'
        errorMessageExtended:
          invalid_items:
            disabled:
              - vg_disabled_item_1
              - vg_disabled_item_2
              - vc_disabled_1
            invalid_item_type:
              allowed_item_type_list:
                - virtual_good
                - bundle
              sku_map:
                gk_steam_enabled_shown_in_store_1: game_key
                unit_enabled_shown_in_store_1: unit
                vc_disabled_1: virtual_currency
                vc_enabled_shown_in_store_1: virtual_currency
            not_found:
              - vg_deleted_item_1
              - vg_deleted_item_2
              - not_existing_sku_404_1
              - not_existing_sku_404_2
          project_id: 0
        statusCode: 422
        transactionId: x-x-xX-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-incorrect-period:
      description: Please ensure start date is earlier than end date.
      summary: Некорректный период действия ежедневной награды
      value:
        errorCode: 6204
        errorMessage: >-
          [0401-6204]: Period of a chain is invalid. Please, check the dates in
          your request
        errorMessageExtended:
          chain_id: 1
          invalid_periods:
            - end: '2023-04-15T18:16:00+05:00'
              start: '2025-04-25T18:16:00+05:00'
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-incorrect-steps-order:
      description: >-
        Daily reward steps numbers sequence is incorrect. Correct step numbers
        should be sequential without any gaps or duplicates.
      summary: Некорректный порядок уровней в цепочке
      value:
        errorCode: 6210
        errorMessage: '[0401-6210]: Chain step numbers are invalid'
        errorMessageExtended:
          incorrect_step_numbers:
            duplicates:
              - 2
              - 7
            missing:
              - 3
              - 4
              - 5
              - 6
            out_of_range:
              - 7
              - 8
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-invalid-chain-step-ids:
      description: >-
        Some of step IDs was not found. Please, double check if specified daily
        reward step IDs actually exist.
      summary: ID уровней ежедневной награды не найдены
      value:
        errorCode: 6206
        errorMessage: '[0401-6206]: Chain step IDs not found'
        errorMessageExtended:
          chain_id: 1
          chain_step_id_list:
            - 404000
          project_id: 0
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-invalid-dates:
      description: Please, ensure dates format is valid.
      summary: Недопустимый формат даты
      value:
        errorCode: 6204
        errorMessage: >-
          [0401-6204]: Period of a chain is invalid. Please, check the dates in
          your request
        errorMessageExtended:
          chain_id: 1
          invalid_format_dates:
            date_end: '2025-04-25 19:16:00Z'
            date_start: '2023-04-15 17:16:00Z'
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-item-limit-exceeded:
      description: >-
        Daily reward step item count exceeds the allowed limit for some steps.
        Currently only 1 item per step is allowed.
      summary: Превышен лимит количества товаров
      value:
        errorCode: 6208
        errorMessage: >-
          [0401-6208]: Chain step item count exceeds the allowed limit for some
          steps
        errorMessageExtended:
          max_items: 1
          project_id: 0
          steps_exceeded_limits:
            - items_count: 2
              step_number: 1
            - items_count: 3
              step_number: 4
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-daily-chain-error-too-many-steps:
      description: >-
        Daily reward steps max amount limit of 30 items is exceeded. Try
        specifying less steps.
      summary: Слишком много уровней
      value:
        errorCode: 6203
        errorMessage: '[0401-6203]: Chain step count exceeds the allowed limit'
        errorMessageExtended:
          max_steps: 30
          project_id: 0
          step_count: 31
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-activated:
      description: >-
        Active offer chain has to be deactivated before being updated. To do
        this, use the <a
        href="/ru/api/shop-builder/operation/admin-toggle-offer-chain">Toggle
        offer chain</a> call.
      summary: Активную цепочку предложений нельзя обновить
      value:
        errorCode: 6209
        errorMessage: >-
          [0401-6209]: Active chain cannot be updated. Please deactivate it
          first
        errorMessageExtended:
          chain_id: 2
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-chain-id-mismatch:
      description: Offer chain ID in the request body does not match the ID in the URL.
      summary: Несовпадение ID цепочки
      value:
        errorCode: 6205
        errorMessage: >-
          [0401-6205]: Chain ID mismatch. Please, check the chain ID in your
          request body and URL
        errorMessageExtended:
          body_chain_id: 2
          project_id: 0
          url_chain_id: 1
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-duplicate-step-ids:
      description: Chain step IDs must be unique in the request body.
      summary: Повторяющиеся ID уровней цепочки
      value:
        errorCode: 6207
        errorMessage: '[0401-6207]: Duplicate chain step IDs detected in the request body'
        errorMessageExtended:
          chain_id: 3
          chain_step_id_list:
            - 8
            - 9
            - 10
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-incorrect-items:
      description: >-
        Specified items are either unavailable, or not found. Only enabled items
        of the following types are supported: virtual items, bundles, and
        virtual currency packages.
      summary: Некорректные товары для уровня цепочки
      value:
        errorCode: 6211
        errorMessage: '[0401-6211]: Chain steps items are not allowed or not found'
        errorMessageExtended:
          invalid_items:
            disabled:
              - vg_disabled_item_1
              - vg_disabled_item_2
              - vc_disabled_1
            invalid_item_type:
              allowed_item_type_list:
                - virtual_good
                - bundle
              sku_map:
                gk_steam_enabled_shown_in_store_1: game_key
                unit_enabled_shown_in_store_1: unit
                vc_disabled_1: virtual_currency
                vc_enabled_shown_in_store_1: virtual_currency
            not_found:
              - vg_deleted_item_1
              - vg_deleted_item_2
              - not_existing_sku_404_1
              - not_existing_sku_404_2
          project_id: 0
        statusCode: 422
        transactionId: x-x-xX-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-incorrect-period:
      description: The start date must be earlier than the end date.
      summary: Некорректный период действия цепочки предложений
      value:
        errorCode: 6204
        errorMessage: >-
          [0401-6204]: Period of a chain is invalid. Please, check the dates in
          your request
        errorMessageExtended:
          chain_id: 1
          invalid_periods:
            - end: '2023-04-15T18:16:00+05:00'
              start: '2025-04-25T18:16:00+05:00'
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-incorrect-steps-order:
      description: >-
        The sequence of offer chain step numbers is incorrect. Step numbers must
        be sequential, without gaps or duplicates.
      summary: Некорректный порядок уровней в цепочке
      value:
        errorCode: 6210
        errorMessage: '[0401-6210]: Chain step numbers are invalid'
        errorMessageExtended:
          incorrect_step_numbers:
            duplicates:
              - 2
              - 7
            missing:
              - 3
              - 4
              - 5
              - 6
            out_of_range:
              - 7
              - 8
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-invalid-chain-step-ids:
      description: >-
        Some of the step IDs were not found. Double-check that the specified
        chain step IDs exist. To do this, use the <a
        href="/api/shop-builder/operation/order-user-offer-chain-step-reward#tag/offer-chain-admin/operation/admin-get-offer-chain">Get
        offer chain</a> call.
      summary: ID уровней цепочки не найдены
      value:
        errorCode: 6206
        errorMessage: '[0401-6206]: Chain step IDs not found'
        errorMessageExtended:
          chain_id: 1
          chain_step_id_list:
            - 404000
          project_id: 0
        statusCode: 404
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-invalid-dates:
      description: >-
        The date format must be valid. Use <a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a> format.
      summary: Недопустимый формат даты
      value:
        errorCode: 6204
        errorMessage: >-
          [0401-6204]: Period of a chain is invalid. Please, check the dates in
          your request
        errorMessageExtended:
          chain_id: 1
          invalid_format_dates:
            date_end: '2025-04-25 19:16:00Z'
            date_start: '2023-04-15 17:16:00Z'
          project_id: 0
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-item-limit-exceeded:
      description: >-
        The number of items in one or more offer chain steps exceeds the allowed
        limit. Currently, only one item per step is allowed.
      summary: Превышен лимит количества товаров
      value:
        errorCode: 6208
        errorMessage: >-
          [0401-6208]: Chain step item count exceeds the allowed limit for some
          steps
        errorMessageExtended:
          max_items: 1
          project_id: 0
          steps_exceeded_limits:
            - items_count: 2
              step_number: 1
            - items_count: 3
              step_number: 4
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-admin-offer-chain-error-too-many-steps:
      description: >-
        The number of offer chain steps exceeds the allowed limit of 30. Try
        specifying fewer steps.
      summary: Слишком много уровней
      value:
        errorCode: 6203
        errorMessage: '[0401-6203]: Chain step count exceeds the allowed limit'
        errorMessageExtended:
          max_steps: 30
          project_id: 0
          step_count: 31
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-custom-attributes-size-exceeded:
      value:
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity'
        errorMessageExtended:
          - message: JSON can’t exceed 500 characters.
            property: custom_attributes
        statusCode: 422
        transactionId: da145238620011eb8e24fe6913ff226a
    422-daily-chain-claim-error-invalid-step:
      description: >-
        Ensure the user has not previously claimed the reward and that the
        correct step in the daily reward is selected for claiming.
      summary: Невозможно получить награду за уровень ежедневной награды
      value:
        errorCode: 6405
        errorMessage: '[0401-6405]: This step is not available to be claimed by the user.'
        errorMessageExtended:
          chain_id: 1
          step_number: 1
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-drm-is-not-drm-free:
      value:
        errorCode: 5103
        errorMessage: '[0401-5103]: Selected drm is not drmfree.'
        statusCode: 422
        transactionId: transaction id
    422-external-id-duplicate:
      value:
        errorCode: 9907
        errorMessage: '[0401-9907]: The attribute value already exists.'
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-external-id-invalid:
      value:
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. Does not match the regex pattern
          ^[a-zA-Z0-9-_]+$
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-external-id-required:
      value:
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. The property `external_id` is
          required
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-item-out-of-range-available-user-limit:
      value:
        errorCode: 4510
        errorMessage: '[0401-4510]: Available item limit is out of range.'
        statusCode: 422
        transactionId: transaction id
    422-item-without-user-limit:
      value:
        errorCode: 4508
        errorMessage: '[0401-4508]: Item does not have configured user limits.'
        statusCode: 422
        transactionId: transaction id
    422-numbers-of-attribute-values-per-item-exceeded:
      value:
        errorCode: 9909
        errorMessage: >-
          [0401-9909]: The number of attribute values you specified for the item
          exceeds the required limit. Try to specify fewer attribute values.
        statusCode: 422
        transactionId: da145238620011eb8e24fe6913ff226a
    422-numbers-of-attributes-per-item-exceeded:
      value:
        errorCode: 9908
        errorMessage: >-
          [0401-9908]: The number of attributes you specified for the item
          exceeds the required limit. Try to specify fewer attributes.
        statusCode: 422
        transactionId: da145238620011eb8e24fe6913ff226a
    422-offer-chain-claim-error-invalid-step:
      description: >-
        The user must claim all previous steps, and the request must use a valid
        call – <a
        href="/api/shop-builder/operation/order-user-offer-chain-step-reward">Create
        order for paid offer chain step</a>, <a
        href="/api/shop-builder/operation/claim-user-offer-chain-step-reward">Claim
        free offer chain step</a> for free ones.


        This error is returned if one or more of the following conditions are
        not met:<ul><li>The offer chain exists, is enabled, and not
        deleted.</li><li>The target step exists, is enabled, and marked as
        free.</li><li>The step has not already been claimed by the user. In case
        of a recurring chain, this check is based on the user progress of the
        current iteration.</li><li>All previous steps in the chain (by step
        number) have been claimed or purchased. In case of a recurring chain,
        this check also considers the user progress of the current
        iteration.</li></ul>
      summary: Невозможно получить награду на уровне
      value:
        errorCode: 6306
        errorMessage: '[0401-6306]: This step is not valid to claim by user.'
        errorMessageExtended:
          chain_id: 1
          step_number: 1
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-promotion-out-of-range-available-user-limit:
      value:
        errorCode: 4511
        errorMessage: '[0401-4511]: Available promotion limit is out of range.'
        statusCode: 422
        transactionId: transaction id
    422-promotion-without-user-limit:
      value:
        errorCode: 4509
        errorMessage: '[0401-4509]: Promotion does not have configured user limits.'
        statusCode: 422
        transactionId: transaction id
    422-property-sku-is-required:
      value:
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity. The property `sku` is required'
        statusCode: 422
        transactionId: da145238620011eb8e24fe6913ff226a
    422-user-already-has-entitlement:
      value:
        errorCode: 5101
        errorMessage: '[0401-5101]: User already has entitlement.'
        statusCode: 422
        transactionId: transaction id
    422-user_external_id_invalid:
      value:
        errorCode: 1102
        errorMessage: '[0401-1102]: Unprocessable Entity'
        errorMessageExtended:
          - message: Must be at least 1 characters long
            property: user_external_id
          - message: Does not match the regex pattern ^\S+$
            property: user_external_id
        statusCode: 404
        transactionId: transaction id
    422-value-invalid:
      value:
        errorCode: 9901
        errorMessage: '[0401-1102]: Unprocessable Entity. The property `value` is required'
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-value-limit-exceeded:
      value:
        errorCode: 9908
        errorMessage: >-
          [0401-9908]: You reached the maximum number of values for the
          attribute.
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    422-value-properties-required:
      value:
        errorCode: 9901
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. Array value found, but an object is
          required
        statusCode: 422
        transactionId: x-x-x-x-transactionId-mock-x-x-x
    Bundles_200-get-bundle:
      value:
        attributes: []
        bundle_type: standard
        can_be_bought: true
        content:
          - attributes: []
            description: Big Rocket - short description.
            groups: []
            image_url: >-
              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
            is_free: false
            limits:
              per_user:
                available: 3
                limit_exceeded_visibility: show
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1746057600
                total: 5
            name: Big Rocket
            price:
              amount: '10.99'
              amount_without_discount: '10.99'
              currency: USD
            quantity: 100
            sku: com.xsolla.big_rocket_1
            type: virtual_currency
            virtual_prices: []
        custom_attributes:
          attr: value
          purchased: 0
        description: pricePoint_44056_1.
        groups: []
        image_url: null
        is_free: false
        item_id: 610316
        limits:
          per_user:
            available: 3
            limit_exceeded_visibility: show
            recurrent_schedule:
              interval_type: weekly
              reset_next_date: 1746057600
            total: 5
        long_description: null
        media_list: []
        name: kg_10.00_bundle
        order: 999
        periods:
          - date_from: '2020-08-11T10:00:00+03:00'
            date_until: '2020-08-11T20:00:00+03:00'
        price:
          amount: '9.99'
          amount_without_discount: '9.99'
          currency: USD
        promotions: []
        sku: com.xsolla.kg_1
        total_content_price:
          amount: '10.99'
          amount_without_discount: '10.99'
          currency: USD
        type: bundle
        virtual_prices: []
        vp_rewards:
          - amount: 130
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
            item_id: 175232
            name: Value point
            sku: com.xsolla.value_point_1
          - amount: 50
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
            is_clan: true
            item_id: 186321
            name: Clan Reward VP 1
            sku: com.xsolla.clan_value_point_1
    Bundles_200-get-bundle-list:
      value:
        has_more: true
        items:
          - attributes:
              - external_id: genre
                name: Genre
                values:
                  - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
                    value: Casual
                  - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
                    value: Strategy
                  - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
                    value: Mobile
            bundle_type: standard
            can_be_bought: true
            content:
              - attributes:
                  - external_id: size
                    name: Size
                    values:
                      - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                        value: Large
                description: Big Rocket - short description.
                groups: []
                image_url: >-
                  https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                is_free: false
                limits:
                  per_user:
                    available: 3
                    limit_exceeded_visibility: show
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1746057600
                    total: 5
                name: Big Rocket
                price:
                  amount: '10.99'
                  amount_without_discount: '10.99'
                  currency: USD
                quantity: 100
                sku: com.xsolla.big_rocket_1
                type: virtual_currency
                virtual_item_type: non_consumable
                virtual_prices: []
            custom_attributes:
              attr: value
              purchased: 0
            description: pricePoint_44056_1
            groups:
              - external_id: exclusive
                item_order_in_group: 1
                name: Exclusive
            image_url: null
            is_free: false
            item_id: 61031
            limits:
              per_user:
                available: 3
                limit_exceeded_visibility: show
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1746057600
                total: 5
            long_description: null
            media_list: []
            name: kg_10.00_bundle
            order: 999
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            price:
              amount: '9.99'
              amount_without_discount: '9.99'
              currency: USD
            promotions: []
            sku: com.xsolla.kg_1
            total_content_price:
              amount: '10.99'
              amount_without_discount: '10.99'
              currency: USD
            type: bundle
            virtual_prices: []
            vp_rewards:
              - amount: 130
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                item_id: 175232
                name: Value point
                sku: com.xsolla.value_point_1
              - amount: 50
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                is_clan: true
                item_id: 186321
                name: Clan Reward VP 1
                sku: com.xsolla.clan_value_point_1
    Promotions_200-admin-coupons:
      value:
        active_promotions_count: 2
        inactive_promotions_count: 0
        items:
          - bonus:
              - quantity: 1
                sku: com.xsolla.elven_sword_1
              - quantity: 2
                sku: com.xsolla.elven_shield_1
              - quantity: 2
                sku: com.xsolla.elven_gloves_1
            external_id: coupon_44056_1
            is_enabled: true
            name:
              de-DE: Neujahrsbonus
              en-US: New Year Bonus
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: '2020-04-25T18:16:00+05:00'
              - date_from: '2020-05-15T18:16:00+05:00'
                date_until: '2020-05-25T18:16:00+05:00'
            redeem_code_limit: 1
            redeem_total_limit: null
            redeem_user_limit: null
            total_limit_state: null
          - bonus:
              - quantity: 100
                sku: com.xsolla.diamonds_1
            external_id: summer2021
            is_enabled: true
            name:
              de-DE: Gutscheintitel
              en-US: Coupon name
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: '2020-04-25T18:16:00+05:00'
            redeem_code_limit: 1
            redeem_total_limit: 100
            redeem_user_limit: null
            total_limit_state:
              available: 50
              reserved: 10
              used: 40
        total_promotions_count: 2
    Promotions_200-admin-promocodes:
      value:
        active_promotions_count: 2
        inactive_promotions_count: 0
        items:
          - bonus:
              - quantity: 1
                sku: com.xsolla.elven_sword_1
              - quantity: 2
                sku: com.xsolla.elven_shield_1
              - quantity: 2
                sku: com.xsolla.elven_gloves_1
            discount: null
            discounted_items: null
            external_id: promocode_100_crystals
            is_enabled: true
            name:
              de-DE: Neujahrsbonus
              en-US: New Year Bonus
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: '2020-04-25T18:16:00+05:00'
            redeem_code_limit: 1
            redeem_total_limit: null
            redeem_user_limit: null
            total_limit_state: null
          - bonus:
              - quantity: 100
                sku: com.xsolla.diamonds_1
            discount:
              percent: '10.99'
            discounted_items:
              - discount:
                  percent: '10.00'
                sku: com.xsolla.elven_sword_1
            excluded_promotions:
              - 23
              - 45
            external_id: summer2021
            is_enabled: true
            name:
              de-DE: Gutscheintitel
              en-US: Coupon name
            price_conditions:
              - operator: ge
                value: '10.0000'
              - operator: le
                value: '50.0000'
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: '2020-04-25T18:16:00+05:00'
            redeem_code_limit: null
            redeem_total_limit: 100
            redeem_user_limit: null
            total_limit_state:
              available: 50
              reserved: 10
              used: 40
        total_promotions_count: 2
    Promotions_200-admin-promotions:
      value:
        active_promotions_count: 3
        inactive_promotions_count: 2
        promotions:
          - bonus:
              - item:
                  bundle_type: virtual_currency_package
                  content: []
                  description: null
                  image_url: null
                  name:
                    en: Diamonds pack
                    ru: Пак кристаллов
                  sku: com.xsolla.diamonds_pack_1
                  type: bundle
                quantity: 1
            condition:
              - item:
                  description: null
                  image_url: null
                  name:
                    en: VG name
                    ru: Название VG
                  sku: com.xsolla.virtual_good_bonus_2
                  type: virtual_good
            discount: null
            id: 1
            is_enabled: true
            name:
              en: promotion_1
            promotion_periods:
              - date_from: '2020-01-01T00:00:00+03:00'
                date_until: null
            type: item_bonus
          - bonus: []
            condition:
              - item:
                  description: null
                  image_url: null
                  name:
                    en: VG name
                    ru: Название VG
                  sku: com.xsolla.virtual_good_bonus_2
                  type: virtual_good
            discount:
              percent: '10.99'
            id: 2
            is_enabled: false
            name:
              en: promotion_2
            promotion_periods:
              - date_from: '2020-01-01T00:00:00+03:00'
                date_until: '2030-01-01T00:00:00+03:00'
            type: item_discount
          - bonus:
              - item:
                  description: null
                  image_url: null
                  name:
                    en: VG name
                    ru: Название VG
                  sku: com.xsolla.virtual_good_bonus_2
                  type: virtual_good
                quantity: 2
            condition:
              - item:
                  external_id: coupon_2
                  is_enabled: true
                  name:
                    en: Coupon name
                    ru: Название купона
                  redeem_code_limit: 1
                  redeem_total_limit: null
                  redeem_user_limit: null
            discount: null
            id: 3
            is_enabled: true
            name:
              en: promotion_3
            promotion_periods:
              - date_from: '2020-01-01T00:00:00+03:00'
                date_until: '2030-01-01T00:00:00+03:00'
            type: coupon_bonus
          - bonus:
              - item:
                  description: null
                  image_url: null
                  name:
                    en: VG name
                    ru: Название VG
                  sku: com.xsolla.virtual_good_bonus_2
                  type: virtual_good
                quantity: 2
            condition:
              - item:
                  external_id: coupon_3
                  is_enabled: true
                  name:
                    en: Coupon name
                    ru: Название купона
                  redeem_code_limit: 1
                  redeem_total_limit: null
                  redeem_user_limit: null
            discount:
              percent: '12.99'
            id: 4
            is_enabled: false
            name:
              en: promotion_4
            promotion_periods:
              - date_from: '2018-01-01T00:00:00+03:00'
                date_until: '2031-01-01T00:00:00+03:00'
            type: promocode_bonus_discount
          - bonus:
              - item:
                  description: null
                  image_url: null
                  name:
                    en: VG name
                    ru: Название VG
                  sku: com.xsolla.virtual_good_bonus_4
                  type: virtual_good
                quantity: 1
            condition: null
            discount: null
            id: 5
            is_enabled: true
            name:
              en: promotion_5
            promotion_periods:
              - date_from: '2020-01-01T00:00:00+03:00'
                date_until: null
            type: cart_bonus
        total_promotions_count: 5
    Promotions_200-admin-unique-catalog-offers:
      value:
        active_promotions_count: 2
        inactive_promotions_count: 0
        items:
          - external_id: new_year_bonus
            is_enabled: true
            items:
              - booster
              - booster_mega
            name:
              de-DE: Neujahrsbonus
              en-US: New Year Bonus
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: '2020-04-25T18:16:00+05:00'
              - date_from: '2020-05-15T18:16:00+05:00'
                date_until: '2020-05-25T18:16:00+05:00'
            redeem_code_limit: 1
            redeem_total_limit: null
            redeem_user_limit: 1
            total_limit_state: null
          - external_id: secret_store
            is_enabled: true
            items:
              - helmet
              - armor
              - sword
            name:
              en-US: Secret store
              ru-RU: Тайный магазин
            promotion_periods:
              - date_from: '2020-04-15T18:16:00+05:00'
                date_until: null
            redeem_code_limit: 1
            redeem_total_limit: 100
            redeem_user_limit: 1
            total_limit_state:
              available: 50
              reserved: 10
              used: 40
        total_promotions_count: 2
    Promotions_200-coupon-code-list:
      value:
        codes:
          - code: CODE001
          - code: CODE002
          - code: CODE003
          - code: CODE004
          - code: CODE005
        total_count: 5
    Promotions_200-get-coupon-rewards:
      value:
        bonus:
          - item:
              description: Game description
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name:
                en: Game name
              sku: com.xsolla.game_1
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam_key_01
                  is_free: false
                  name: Game name
                  sku: com.xsolla.game_key_01
                  type: game_key
                - drm_name: Origin
                  drm_sku: origin_key_02
                  name: Game name
                  sku: game_key_02
                  type: game_key
            quantity: 1
          - item:
              description: Game description
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name:
                en: Game name
              sku: com.xsolla.game_2
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam_key_01
                  name: Game name
                  sku: com.xsolla.game_key_01
                  type: game_key
            quantity: 2
        discount:
          percent: '10.00'
        is_selectable: true
    Promotions_200-get-promocode-rewards:
      value:
        bonus:
          - item:
              description: Game description
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name: Game name
              sku: com.xsolla.game_1
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam_key_01
                  is_free: false
                  name: Game name
                  sku: com.xsolla.game_key_01
                  type: game_key
                - drm_name: Origin
                  drm_sku: origin_key_02
                  name: Game name
                  sku: com.xsolla.game_key_02
                  type: game_key
            quantity: 1
          - item:
              description: Game description
              image_url: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              name: Game name
              sku: com.xsolla.game_2
              type: unit
              unit_items:
                - drm_name: Steam
                  drm_sku: steam_key_01
                  name: Game name
                  sku: com.xsolla.game_key_01
                  type: game_key
            quantity: 2
        discount:
          percent: '10.00'
        discounted_items:
          - discount:
              percent: '10.00'
            sku: com.xsolla.elven_sword_1
        is_selectable: true
    Promotions_422-invalid-coupon:
      value:
        errorCode: 1102
        errorMessage: >-
          [0401-1102]: Unprocessable Entity. The property `external_id` is
          required
        statusCode: 422
    code-limit:
      value:
        has_more: false
        items:
          - code: WINTER2023
            per_code:
              available: 7
              reserved: 1
              total: 10
              used: 2
          - code: SUMMER2023
            per_code:
              available: 0
              reserved: 2
              total: 5
              used: 3
        promotion_id: 1
        total_items_count: 2
  parameters:
    additional_fields-entitlement-query-param:
      description: >-
        Список дополнительных полей. Эти поля будут в ответе, если вы отправите
        их в своем запросе. Доступные поля: `attributes`.
      in: query
      name: additional_fields[]
      required: false
      schema:
        items:
          type: string
        type: array
    additional_fields-query-param:
      description: >-
        Список дополнительных полей. Эти поля будут указаны в ответе, если вы
        отправите их в своем запросе.
      in: query
      name: additional_fields[]
      required: false
      schema:
        items:
          enum:
            - media_list
            - order
            - long_description
            - custom_attributes
            - item_order_in_group
          type: string
        type: array
    cart_id-path-param:
      description: ID корзины.
      in: path
      name: cart_id
      required: true
      schema:
        example: custom_id
        type: string
    code-path-param:
      description: Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
      in: path
      name: code
      required: true
      schema:
        example: WINTER2021
        maxLength: 128
        minLength: 1
        type: string
    codes-query-param:
      description: >-
        Уникальные коды, чувствительные к регистру. Содержат только буквы и
        цифры.
      in: query
      name: codes[]
      schema:
        items:
          maxLength: 128
          minLength: 1
          type: string
        type: array
    country-query-param:
      description: >-
        Двухбуквенное обозначение страны в верхнем регистре согласно стандарту
        [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
        Ознакомьтесь со [списком стран, поддерживаемых
        Xsolla](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/),
        а также с процессом [определения
        страны](https://developers.xsolla.com/ru/doc/shop-builder/features/pricing-policy/#pricing_policy_country_determination).
      in: query
      name: country
      required: false
      schema:
        example: US
        type: string
    coupon_code-path-param:
      description: Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
      in: path
      name: coupon_code
      required: true
      schema:
        example: WINTER2021
        maxLength: 128
        minLength: 1
        type: string
    currency-query-param:
      description: >-
        Валюта, в которой указаны цены товаров в корзине. Трехбуквенный код
        валюты в соответствии с [ISO
        4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную информацию о
        [валютах, поддерживаемых Xsolla, смотрите в
        документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
      in: query
      name: currency
      required: false
      schema:
        default: USD
        type: string
    daily_chain_id-path-param:
      description: ID ежедневной награды.
      in: path
      name: daily_chain_id
      required: true
      schema:
        example: 101
        type: integer
    daily_chain_step_number-path-param:
      description: Номер уровня ежедневной награды.
      in: path
      name: step_number
      required: true
      schema:
        example: 1
        type: integer
    enabled-query-param:
      description: Фильтрует элементы по флагу `is_enabled`.
      in: query
      name: enabled
      required: false
      schema:
        type: integer
    external_id-attr-path-param:
      description: External ID атрибута.
      in: path
      name: external_id
      required: true
      schema:
        example: attribute_id
        type: string
    external_id-group-path-param:
      description: External ID группы.
      in: path
      name: external_id
      required: true
      schema:
        default: all
        type: string
    external_id-promotion-path-param:
      description: External ID акции. Уникальный идентификатор акции в рамках проекта.
      in: path
      name: external_id
      required: true
      schema:
        example: coupon_44056_1
        type: integer
    external_id_59080-group-path-param:
      description: External ID группы.
      in: path
      name: external_id
      required: true
      schema:
        default: armour
        type: string
    group_id-path-param:
      description: ID группы.
      in: path
      name: group_id
      required: true
      schema:
        example: 10
        type: integer
    is_enabled-query-param:
      description: Фильтрует элементы по флагу `is_enabled`.
      in: query
      name: is_enabled
      required: false
      schema:
        type: integer
    is_expired-daily-chain-query-param:
      description: >-
        Фильтруйте ежедневные награды, чтобы показывать только те, у которых
        срок действия истек.
      in: query
      name: is_expired
      required: false
      schema:
        type: integer
    item_id-path-param:
      description: ID предмета (артикул).
      in: path
      name: item_id
      required: true
      schema:
        example: '656'
        type: string
    item_id_59080-path-param:
      description: ID предмета (артикул).
      in: path
      name: item_id
      required: true
      schema:
        example: '259774'
        type: string
    item_sku-path-param:
      description: Артикул товара.
      in: path
      name: item_sku
      required: true
      schema:
        example: booster_mega_1
        type: string
    item_sku_59080-path-param:
      description: Артикул товара.
      in: path
      name: sku
      required: true
      schema:
        example: electric_shield
        type: string
    limit-query-param:
      description: Лимит количества элементов на странице.
      example: 50
      in: query
      name: limit
      required: false
      schema:
        example: 50
        minimum: 1
        type: integer
    locale-query-param:
      description: >-
        Язык ответа. Двухбуквенный код языка в нижнем регистре в соответствии с
        ISO 639-1.
      in: query
      name: locale
      required: false
      schema:
        default: en
        type: string
    merchant_id-path-param:
      description: ID продавца.
      in: path
      name: merchant_id
      required: true
      schema:
        example: 121212
        type: integer
    offer_chain_id-path-param:
      description: ID цепочки предложений.
      in: path
      name: offer_chain_id
      required: true
      schema:
        example: 101
        type: integer
    offer_chain_step_number-path-param:
      description: Номер уровня в цепочке предложений.
      in: path
      name: step_number
      required: true
      schema:
        example: 1
        type: integer
    offset-query-param:
      description: >-
        Номер элемента, с которого выполняется вывод на странице (нумерация
        ведется с 0).
      example: 0
      in: query
      name: offset
      required: false
      schema:
        example: 0
        minimum: 0
        type: integer
    order_id-path-param:
      description: ID заказа.
      in: path
      name: order_id
      required: true
      schema:
        example: '656'
        type: string
    personalized-catalog-rule_id-path-param:
      description: ID правила.
      in: path
      name: rule_id
      required: true
      schema:
        example: 1
        type: number
    platform-query-param:
      description: >-
        Платформа публикации, на которой играет пользователь: `xsolla` (по
        умолчанию), `playstation_network`, `xbox_live`, `pc_standalone`,
        `nintendo_shop`, `google_play`, `app_store_ios`, `android_standalone`,
        `ios_standalone`, `android_other`, `ios_other`, `pc_other`.
      in: query
      name: platform
      required: false
      schema:
        default: xsolla
        enum:
          - playstation_network
          - xbox_live
          - xsolla
          - pc_standalone
          - nintendo_shop
          - google_play
          - app_store_ios
          - android_standalone
          - ios_standalone
          - android_other
          - ios_other
          - pc_other
        type: string
    project_id-path-param:
      description: >-
        ID проекта. Вы можете найти этот параметр в [Личном
        кабинете](https://publisher.xsolla.com/) рядом с названием проекта.
      in: path
      name: project_id
      required: true
      schema:
        example: 44056
        type: integer
    project_id_59080-path-param:
      description: >-
        ID проекта. Вы можете найти этот параметр в [Личном
        кабинете](https://publisher.xsolla.com/) рядом с названием проекта.
      in: path
      name: project_id
      required: true
      schema:
        example: 59080
        type: integer
    promo_code-query-param:
      description: Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
      in: query
      name: promo_code
      required: false
      schema:
        example: WINTER2021
        maxLength: 128
        minLength: 1
        type: string
    promocode_code-path-param:
      description: Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
      in: path
      name: promocode_code
      required: true
      schema:
        example: SO6rew99j9
        maxLength: 128
        minLength: 1
        type: string
    promotion_id-path-param:
      description: ID акции. Уникальный идентификатор акции в рамках проекта.
      in: path
      name: promotion_id
      required: true
      schema:
        example: 111425
        type: integer
    quantity-query-param:
      description: Количество кодов.
      in: query
      name: quantity
      required: true
      schema:
        example: 100
        type: integer
    reason-query-param:
      description: Причина получения кодов.
      in: query
      name: reason
      required: true
      schema:
        example: Very important
        type: string
    region_id-path-param:
      description: ID региона. Уникальный идентификатор региона в рамках проекта.
      in: path
      name: region_id
      required: true
      schema:
        example: 42
        type: integer
    region_id-query-param:
      description: ID региона.
      in: query
      name: region_id
      required: false
      schema:
        default: 1
        type: integer
    reward_chain_id-path-param:
      description: ID цепочки наград.
      in: path
      name: reward_chain_id
      required: true
      schema:
        example: 101
        type: integer
    reward_chain_step_id-path-param:
      description: ID уровня цепочки наград.
      in: path
      name: step_id
      required: true
      schema:
        example: 120
        type: integer
    sandbox-query-param:
      description: >-
        Какой тип прав владения должен быть возвращен. Если параметру присвоено
        значение 1, возвращаются права владения, полученные пользователем только
        в режиме тестового окружения. Если параметр не передан или установлен в
        0, возвращаются права владения, полученные пользователем только в режиме
        боевого окружения.
      in: query
      name: sandbox
      required: false
      schema:
        default: 0
        type: integer
    show_inactive_time_limited_items-query-param:
      description: >-
        Отображает предметы с ограниченным сроком действия, которые недоступны
        пользователю. Срок действия таких предметов еще не начался или уже
        истек.
      in: query
      name: show_inactive_time_limited_items
      required: false
      schema:
        default: 0
        example: 1
        type: integer
    sku-path-param:
      description: Артикул бандла.
      in: path
      name: sku
      required: true
      schema:
        example: kg_1
        type: string
    type-daily-chain-query-param:
      description: Фильтрует ежедневные награды, чтобы возвращать только указанный тип.
      in: query
      name: type
      required: false
      schema:
        enum:
          - calendar_hard
          - rolling_skippable
          - rolling_unskippable
        type: string
    user_email-query-param:
      description: Email-адрес пользователя.
      in: query
      name: user_email
      required: true
      schema:
        example: email@email.com
        type: string
    user_external_id-query-param:
      description: External ID пользователя
      in: query
      name: user_external_id
      required: true
      schema:
        example: d342dad2-9d59-11e9-a384-42010aa8003f
        type: string
    value_external_id-path-param:
      description: External ID значения атрибута.
      in: path
      name: value_external_id
      required: true
      schema:
        example: value_id
        pattern: ^[-_\.\d\w]+$
        type: string
    value_point_sku-path-param:
      description: Value Point SKU.
      in: path
      name: value_point_sku
      required: true
      schema:
        example: value_point_3
        type: string
    virtual_currency_package_sku-path-param:
      description: Артикул пакета виртуальной валюты.
      in: path
      name: virtual_currency_package_sku
      required: true
      schema:
        example: crystal-pack
        type: string
    virtual_currency_sku-path-param:
      description: Артикул виртуальной валюты.
      in: path
      name: virtual_currency_sku
      required: true
      schema:
        example: crystal
        type: string
    x-user-for-header:
      description: >-
        Идентификатор пользователя может быть передан с помощью JWT пользователя
        Авторизации Иксолла или [токена доступа Платежей
        Иксолла](https://developers.xsolla.com/ru/pay-station-api/current/token/create-token)).
      example: ACCESS_TOKEN/LOGIN_JWT
      in: header
      name: x-user-for
      required: false
      schema:
        type: string
    x-user-id-header:
      description: >-
        Вы можете использовать свой собственный ID пользователя при продаже
        корзины с играми.
      example: UNIQUE_ID
      in: header
      name: x-user-id
      required: false
      schema:
        maxLength: 32
        type: string
  requestBodies:
    Bundles_bundle:
      content:
        application/json:
          example:
            attributes:
              - external_id: class
                name:
                  en: Class
                values:
                  - external_id: soldier
                    value:
                      en: Soldier
                  - external_id: officer
                    value:
                      en: Officer
            content:
              - quantity: 1
                sku: com.xsolla.iron_gloves_1
              - quantity: 1
                sku: com.xsolla.iron_boots_1
              - quantity: 1
                sku: com.xsolla.iron_shield_1
              - quantity: 1
                sku: com.xsolla.iron_armour_1
              - quantity: 1
                sku: com.xsolla.iron_helmet_1
            custom_attributes:
              purchased: 0
              type: lootbox
            description:
              de: Brustpanzer für Soldaten
              en: Chest of armour for soldiers
            groups:
              - chests
            image_url: https://picture.bundle-with-many-stuff.png
            is_enabled: true
            is_free: true
            limits:
              per_item: null
              per_user: null
            long_description:
              de: Brustpanzer für Soldaten
              en: Chest of armour for soldiers
            media_list:
              - type: image
                url: https://test.com/image0
              - type: image
                url: https://test.com/image1
            name:
              de: Brustpanzer
              en: Chest of armour
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices:
              - amount: '9.99'
                currency: USD
                is_default: true
                is_enabled: true
              - amount: '9.99'
                currency: EUR
                is_default: false
                is_enabled: true
            sku: com.xsolla.armour_chest_1
            vc_prices: []
          schema:
            $ref: '#/components/schemas/Bundles_admin_bundle_request'
      description: Объект с данными бандла.
      required: true
    Cart-Payment_admin-create-payment-token:
      content:
        application/json:
          examples:
            common:
              value:
                purchase:
                  items:
                    - quantity: 2
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.t-shirt01
                    - quantity: 1
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.hat01
                settings:
                  currency: USD
                  external_id: AABBCCDD01
                  language: de
                  payment_method: 1380
                  return_url: https://developers.xsolla.com/ru/
                  ui:
                    theme: 63295aab2e47fab76f7708e3
                user:
                  country:
                    allow_modify: false
                    value: US
                  email:
                    value: user@xsolla.com
                  id:
                    value: user-id
                  name:
                    value: user-name
            in-sandbox:
              value:
                purchase:
                  items:
                    - quantity: 2
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.t-shirt01
                    - quantity: 1
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.hat01
                sandbox: true
                settings:
                  currency: USD
                user:
                  id:
                    value: user-id
            with-custom-parameters:
              value:
                custom_parameters:
                  user_os: windows10
                  user_public_id: player1
                purchase:
                  items:
                    - quantity: 2
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.t-shirt01
                    - quantity: 1
                      sku: com.xsolla.cup01
                    - quantity: 1
                      sku: com.xsolla.hat01
                settings:
                  currency: USD
                  external_id: AABBCCDD01
                  language: de
                  payment_method: 1380
                  return_url: https://developers.xsolla.com/ru/
                  ui:
                    theme: 63295aab2e47fab76f7708e3
                user:
                  country:
                    allow_modify: false
                    value: US
                  email:
                    value: user@xsolla.com
                  id:
                    value: user-id
                  name:
                    value: user-name
          schema:
            additionalProperties: false
            properties:
              custom_parameters:
                $ref: '#/components/schemas/Cart-Payment_custom_parameters'
              promo_code:
                $ref: '#/components/schemas/Promotions_coupon_code'
              purchase:
                $ref: '#/components/schemas/Cart_admin_payment'
              sandbox:
                $ref: '#/components/schemas/Cart-Payment_settings_sandbox'
              settings:
                additionalProperties: false
                description: >-
                  Параметры для настройки процесса оплаты и платежного
                  интерфейса для пользователя.
                properties:
                  currency:
                    $ref: '#/components/schemas/Cart-Payment_settings_currency'
                  external_id:
                    $ref: '#/components/schemas/Cart-Payment_settings_external_id'
                  language:
                    $ref: '#/components/schemas/Cart-Payment_settings_locale'
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                type: object
              user:
                $ref: '#/components/schemas/Cart-Payment_admin-user-request-body'
            required:
              - user
              - purchase
            type: object
    Cart-Payment_admin-fill-cart-json-model:
      content:
        application/json:
          examples:
            basic:
              value:
                currency: USD
                items:
                  - quantity: 2
                    sku: com.xsolla.cup01
                  - quantity: 1
                    sku: com.xsolla.t-shirt01
                  - quantity: 1
                    sku: com.xsolla.cup01
                  - quantity: 1
                    sku: com.xsolla.hat01
          schema:
            $ref: '#/components/schemas/Cart'
    Cart-Payment_create-order-by-cart-idJsonModel:
      content:
        application/json:
          example:
            custom_parameters:
              character_id: ingameUsername
            sandbox: true
            settings:
              ui:
                desktop:
                  header:
                    close_button: false
                    is_visible: true
                    type: normal
                    visible_logo: true
                    visible_name: true
                    visible_purchase: true
                theme: 63295a9a2e47fab76f7708e1
          schema:
            properties:
              currency:
                description: >-
                  Валюта, в которой указана стоимость заказа. Трехбуквенный код
                  валюты в соответствии с [ISO
                  4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                  информацию о [валютах, поддерживаемых Xsolla, смотрите в
                  документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                type: string
              custom_parameters:
                description: Дополнительные пользовательские параметры проекта.
                maxProperties: 200
                minProperties: 1
                type: object
              locale:
                description: Язык ответа.
                type: string
              sandbox:
                default: false
                description: >-
                  Создает заказ в тестовом окружении. Эта возможность доступна
                  для пользователей, указанных в списке пользователей компании.
                type: boolean
              settings:
                additionalProperties: false
                description: >-
                  Параметры для настройки процесса оплаты и платежного
                  интерфейса для пользователя.
                properties:
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                type: object
            type: object
    Cart-Payment_create-order-with-specified-item-idJsonModel:
      content:
        application/json:
          example:
            custom_parameters:
              character_id: ingameUsername
            promo_code: discount_code
            quantity: 5
            sandbox: true
            settings:
              ui:
                desktop:
                  header:
                    close_button: false
                    is_visible: true
                    type: normal
                    visible_logo: true
                    visible_name: true
                    visible_purchase: true
                theme: 63295a9a2e47fab76f7708e1
          schema:
            properties:
              currency:
                description: >-
                  Валюта, в которой указана стоимость заказа. Трехбуквенный код
                  валюты в соответствии с [ISO
                  4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                  информацию о [валютах, поддерживаемых Xsolla, смотрите в
                  документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                type: string
              custom_parameters:
                description: Дополнительные пользовательские параметры проекта.
                maxProperties: 200
                minProperties: 1
                type: object
              locale:
                description: Язык ответа.
                type: string
              promo_code:
                description: Погашает промокод при оплате.
                type: string
              quantity:
                default: 1
                description: Количество товаров.
                minimum: 1
                type: integer
              sandbox:
                default: false
                description: >-
                  Создает заказ в тестовом окружении. Эта возможность доступна
                  для пользователей, указанных в списке пользователей компании.
                type: boolean
              settings:
                additionalProperties: false
                description: >-
                  Параметры для настройки процесса оплаты и платежного
                  интерфейса для пользователя.
                properties:
                  payment_method:
                    $ref: '#/components/schemas/Cart-Payment_settings_payment_method'
                  redirect_policy:
                    $ref: '#/components/schemas/Cart-Payment_redirect_policy'
                  return_url:
                    $ref: '#/components/schemas/Cart-Payment_settings_return_url'
                  ui:
                    $ref: '#/components/schemas/Cart-Payment_settings_ui'
                type: object
            type: object
    Cart-Payment_fill-cart-json-model:
      content:
        application/json:
          schema:
            example:
              items:
                - quantity: 123
                  sku: com.xsolla.booster_mega_1
            properties:
              items:
                description: Список товаров.
                items:
                  minItems: 1
                  properties:
                    quantity:
                      default: 123
                      type: number
                    sku:
                      default: booster_mega_1
                      type: string
                  required:
                    - sku
                    - quantity
                  type: object
                type: array
            required:
              - items
            type: object
    Cart-Payment_put-item-by-cart-idJsonModel:
      content:
        application/json:
          schema:
            properties:
              quantity:
                default: 123
                description: Количество товаров.
                type: number
            type: object
    Game-Keys_create-update-game-model:
      content:
        application/json:
          schema:
            example:
              description:
                en-US: Game description
                ru-RU: Краткое описание игры
              groups:
                - new_games
              image_url: http://image.png
              is_enabled: true
              is_show_in_store: true
              long_description:
                en-US: Game long description
                ru-RU: Полное описание игры
              media_list:
                - type: image
                  url: http://image.png
                - type: video
                  url: http://video.png
              name:
                en-US: Game name
                ru-RU: Название игры
              sku: com.xsolla.game_1
              unit_items:
                - drm_sku: steam_key_1
                  is_enabled: true
                  is_free: false
                  is_show_in_store: true
                  limits:
                    per_item:
                      available: 5000
                      reserved: 500
                      sold: 4500
                      total: 10000
                    per_user:
                      total: 5
                  name:
                    en-US: Game key name
                    ru-RU: Название игрового ключа
                  periods:
                    - date_from: '2020-08-11T10:00:00+03:00'
                      date_until: '2020-08-11T20:00:00+03:00'
                  pre_order:
                    description: Some description
                    is_enabled: true
                    release_date: '2020-08-11T10:00:00+03:00'
                  prices:
                    - amount: 35.5
                      currency: USD
                      is_default: true
                      is_enabled: true
                  regions:
                    - id: 12
                    - id: 64
                  sku: com.xsolla.game_key_1
                  vc_prices:
                    - amount: 35.5
                      is_default: true
                      is_enabled: true
                      sku: com.xsolla.gold_1
            properties:
              attributes:
                $ref: '#/components/schemas/Game-Keys_admin-post-put-attributes'
              description:
                $ref: '#/components/schemas/description-localization-object'
              groups:
                description: Группы, к которым принадлежит товар.
                items:
                  properties:
                    external_id:
                      example: horror
                      type: string
                  required:
                    - external_id
                  type: object
                type: array
              image_url:
                description: URL-адрес изображения.
                example: https://image.example.com
                type: string
              is_enabled:
                description: >-
                  Если этот параметр отключен, товар нельзя приобрести и
                  получить к нему доступ через инвентарь.
                type: boolean
              is_show_in_store:
                description: Товар доступен для покупки.
                type: boolean
              long_description:
                $ref: '#/components/schemas/long-description-localization-object'
              media_list:
                description: >-
                  Дополнительные ассеты игры, такие как скриншоты, видео
                  игрового процесса и т.д.
                example:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                items:
                  properties:
                    type:
                      description: 'Тип медиа: `image`/`video`.'
                      enum:
                        - image
                        - video
                      example: image
                      type: string
                    url:
                      description: Ссылка на файл.
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      type: string
                  type: object
                type: array
              name:
                $ref: '#/components/schemas/name-localization-object'
              order:
                description: Приоритет порядка игры в списке.
                example: 1
                type: integer
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: game_1
                maxLength: 255
                minLength: 1
                pattern: ^[a-zA-Z0-9_\-–.]*$
                type: string
              unit_items:
                description: Платформы публикации игры.
                items:
                  description: >-
                    Игра, опубликованная на определенной платформе (steam, gog и
                    т.д.).
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_admin-attributes'
                    drm_sku:
                      description: Уникальный ID платформы.
                      example: steam
                      type: string
                    groups:
                      description: Группы, к которым принадлежит товар.
                      items:
                        properties:
                          external_id:
                            example: horror
                            type: string
                        required:
                          - external_id
                        type: object
                      type: array
                    is_enabled:
                      description: >-
                        Если этот параметр отключен, товар нельзя приобрести и
                        получить к нему доступ через инвентарь.
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_show_in_store:
                      description: Товар доступен для покупки.
                      type: boolean
                    limits:
                      $ref: '#/components/schemas/Game-key-item-limit'
                    name:
                      $ref: '#/components/schemas/name-localization-object'
                    order:
                      description: Приоритет порядка игры в списке.
                      example: 1
                      type: integer
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    pre_order:
                      description: Настройки предзаказа.
                      properties:
                        description:
                          description: >-
                            Дополнительная информация для предзаказа, которая
                            будет выслана по электронной почте.
                          type: string
                        is_enabled:
                          description: >-
                            Если этот параметр отключен, товар не является
                            предзаказом.
                          type: boolean
                        release_date:
                          description: Дата выпуска игры на платформе в формате ISO 8601.
                          type: string
                      required:
                        - release_date
                        - is_enabled
                      type: object
                    prices:
                      description: Цены в реальных валютах.
                      items:
                        properties:
                          amount:
                            example: 1299.99
                            type: number
                          currency:
                            description: >-
                              Валюта, в которой указана цена товара.
                              Трехбуквенный код в соответствии с [ISO
                              4217](https://en.wikipedia.org/wiki/ISO_4217).
                              Подробную информацию о [валютах, поддерживаемых
                              Xsolla, смотрите в
                              документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                            example: RUB
                            type: string
                          is_default:
                            description: >-
                              Цена по умолчанию используется для построения
                              каталога, если цена в валюте пользователя не
                              указана.
                            type: boolean
                          is_enabled:
                            type: boolean
                        required:
                          - amount
                          - currency
                          - is_default
                          - is_enabled
                        type: object
                      type: array
                    regions:
                      $ref: '#/components/schemas/Game-Keys_regions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: game_1
                      maxLength: 255
                      minLength: 1
                      type: string
                    vc_prices:
                      items:
                        properties:
                          amount:
                            type: number
                          is_default:
                            type: boolean
                          is_enabled:
                            type: boolean
                          sku:
                            description: >-
                              Уникальный ID товара. Артикул может содержать
                              только строчные и заглавные латинские буквы,
                              цифры, точки, тире и подчеркивания.
                            example: gold
                            type: string
                        required:
                          - amount
                          - currency
                          - is_default
                          - is_enabled
                        type: object
                      type: array
                  required:
                    - sku
                    - drm_sku
                    - prices
                  type: object
                type: array
            required:
              - sku
              - name
              - unit_items
            type: object
      description: Объект с игровыми данными.
      required: true
    Promotions_cancel-promo-code-model:
      content:
        application/json:
          schema:
            properties:
              cart:
                nullable: true
                properties:
                  id:
                    default: current
                    description: ID корзины.
                    type: string
                required:
                  - id
                type: object
            type: object
    Promotions_coupon-create:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: account_status
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: golden
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_2
                external_id: coupon_external_id
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                external_id: coupon_external_id
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              bonus:
                $ref: '#/components/schemas/Promotions_coupon_bonus'
              external_id:
                $ref: '#/components/schemas/Promotions_coupon-external_id'
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - external_id
              - name
            type: object
    Promotions_coupon-update:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: account_status
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: golden
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_2
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              bonus:
                $ref: '#/components/schemas/Promotions_coupon_bonus'
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - name
            type: object
    Promotions_create-coupon-promocode-code:
      content:
        application/json:
          schema:
            properties:
              coupon_code:
                $ref: '#/components/schemas/Promotions_coupon_code'
            type: object
    Promotions_create-update-bonus-promotion:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: account_status
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: golden
                bonus:
                  - quantity: 50000
                    sku: com.xsolla.mp_credits
                condition:
                  - sku: com.xsolla.year_1_season_pass
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
            simple:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                  - quantity: 2
                    sku: com.xsolla.elven_shield_1
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_1
                condition:
                  - sku: com.xsolla.elven_boots_1
                  - sku: com.xsolla.elven_knife_1
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
            with excluded promotions:
              value:
                bonus:
                  - quantity: 50000
                    sku: com.xsolla.mp_credits
                condition:
                  - sku: com.xsolla.year_1_season_pass
                excluded_promotions:
                  - 12
                  - 789
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
            with price conditions:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_2
                  - quantity: 2
                    sku: com.xsolla.elven_shield_2
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_2
                condition:
                  - sku: com.xsolla.elven_boots_2
                  - sku: com.xsolla.elven_knife_2
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                price_conditions:
                  - operator: gt
                    value: '10.0000'
                  - operator: lt
                    value: '20.0000'
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              bonus:
                items:
                  description: >-
                    Список товаров, которые будут добавлены в покупку
                    пользователя в качестве бонуса.
                  properties:
                    quantity:
                      default: 1
                      description: Количество товаров.
                      type: number
                    sku:
                      default: elven_shield
                      description: Артикул товара.
                      type: string
                  type: object
                nullable: true
                type: array
              condition:
                description: >-
                  Набор товаров, которые необходимо включить в покупку для
                  применения акции. Если этот параметр равен `null`, акция будет
                  применена к любым покупкам в рамках проекта.
                items:
                  properties:
                    sku:
                      default: elven_sword
                      description: Артикул товара.
                      type: string
                  type: object
                nullable: true
                type: array
              excluded_promotions:
                $ref: '#/components/schemas/excluded_promotions'
              id:
                description: ID акции. Уникальный идентификатор акции в рамках проекта.
                type: integer
              is_enabled:
                $ref: '#/components/schemas/Promotions_is_enabled'
              limits:
                $ref: '#/components/schemas/Promotions_promotion_limits'
              name:
                additionalProperties:
                  type: string
                description: >-
                  Название акции. Данный параметр должен содержать пары
                  ключ/значение, где ключ — это локаль в формате
                  "^[a-z]{2}-[A-Z]{2}$", значение — строка.
                example:
                  de-DE: Sommersaison Bonus
                  en-US: Summer season bonus
                type: object
              price_conditions:
                $ref: '#/components/schemas/price_conditions_bonus'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
            required:
              - condition
              - bonus
              - name
            type: object
    Promotions_create-update-item-promotion:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: race
                    operator: eq
                    type: string
                    value: ork
                  - attribute: level
                    can_be_missing: true
                    operator: eq
                    type: number
                    value: '10'
                discount:
                  percent: '24.00'
                is_enabled: true
                items: []
                name:
                  en-US: Ork set discount
                  ru-RU: Скидка на набор для орка
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
            simple:
              value:
                discount:
                  percent: '10.00'
                is_enabled: true
                items:
                  - sku: com.xsolla.elven_sword_1
                  - sku: com.xsolla.elven_helmet_1
                  - sku: com.xsolla.elven_armor_1
                name:
                  en-US: Promotion
                  ru-RU: Акция
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-16T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
            with excluded promotions:
              value:
                discount:
                  percent: '24.00'
                excluded_promotions:
                  - 12
                  - 789
                is_enabled: true
                items: []
                name:
                  en-US: Ork set discount
                  ru-RU: Скидка на набор для орка
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
            with price condition:
              value:
                discount:
                  percent: '24.00'
                items: []
                name:
                  en-US: Ork set discount
                  ru-RU: Скидка на набор для орка
                price_conditions:
                  - operator: ge
                    value: '10.5000'
                  - operator: lt
                    value: '20.5000'
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              discount:
                properties:
                  percent:
                    description: >-
                      Процент скидки. 

                      Цена товара будет уменьшена с использованием значения,
                      рассчитанного с использованием этого процента, а затем
                      округлена до 2 знаков после запятой.
                    example: 10
                    type: string
                required:
                  - percent
                type: object
              excluded_promotions:
                $ref: '#/components/schemas/excluded_promotions'
              is_enabled:
                $ref: '#/components/schemas/Promotions_is_enabled'
              items:
                items:
                  description: Список товаров, на которые будет распространяться скидка.
                  properties:
                    sku:
                      default: elven_sword
                      description: Артикул товара.
                      type: string
                  required:
                    - sku
                  type: object
                type: array
              limits:
                $ref: '#/components/schemas/Promotions_promotion_limits'
              name:
                additionalProperties:
                  type: string
                description: >-
                  Название акции. Данный параметр должен содержать пары
                  ключ/значение,
                   где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение — строка.
                example:
                  en-US: Promotion
                  ru-RU: Акция
                type: object
              price_conditions:
                $ref: '#/components/schemas/price_conditions_discount'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
            required:
              - items
              - discount
              - name
            type: object
      description: Объект с данными акции.
      required: true
    Promotions_promocode-create:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: account_status
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: golden
                discount:
                  percent: '10.10'
                external_id: coupon_external_id
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple bonus:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                  - quantity: 2
                    sku: com.xsolla.elven_shield_1
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_1
                external_id: promo_code_external_id
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple discount:
              value:
                discount:
                  percent: '10.10'
                external_id: promo_code_external_id
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with excluded promotions:
              value:
                discount:
                  percent: '10.10'
                excluded_promotions:
                  - 12
                  - 789
                external_id: coupon_external_id
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with item price conditions:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_3
                  - quantity: 2
                    sku: com.xsolla.elven_shield_3
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_3
                discount:
                  percent: '10.10'
                external_id: promo_code_external_id
                item_price_conditions:
                  - operator: ge
                    value: '10.5000'
                  - operator: lt
                    value: '50.0000'
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with price conditions:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_2
                  - quantity: 2
                    sku: com.xsolla.elven_shield_2
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_2
                external_id: promo_code_external_id
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                price_conditions:
                  - operator: ge
                    value: '10.5000'
                  - operator: lt
                    value: '50.0000'
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              bonus:
                $ref: '#/components/schemas/Promotions_coupon_bonus'
              discount:
                example:
                  percent: '10.10'
                nullable: true
                properties:
                  percent:
                    $ref: '#/components/schemas/Promotions_promotion_discount_percent'
                type: object
              discounted_items:
                $ref: '#/components/schemas/Promotions_discounted_items'
              excluded_promotions:
                $ref: '#/components/schemas/excluded_promotions'
              external_id:
                $ref: '#/components/schemas/Promotions_coupon-external_id'
              item_price_conditions:
                $ref: '#/components/schemas/item_price_conditions_promocode'
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              price_conditions:
                $ref: '#/components/schemas/price_conditions_promocode'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - external_id
              - name
            type: object
    Promotions_promocode-update:
      content:
        application/json:
          examples:
            personalized:
              value:
                attribute_conditions:
                  - attribute: account_status
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: golden
                discount:
                  percent: '10.10'
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple bonus:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                  - quantity: 2
                    sku: com.xsolla.elven_shield_1
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_1
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple discount:
              value:
                discount:
                  percent: '10.10'
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with excluded promotions:
              value:
                discount:
                  percent: '10.10'
                excluded_promotions:
                  - 12
                  - 789
                name:
                  de-DE: Neujahrsrabatt
                  en-US: New Year Discount
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with item price conditions:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_3
                  - quantity: 2
                    sku: com.xsolla.elven_shield_3
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_3
                discount:
                  percent: '10.10'
                item_price_conditions:
                  - operator: gt
                    value: '10.5000'
                  - operator: lt
                    value: '50.0000'
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            with price conditions:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_2
                  - quantity: 2
                    sku: com.xsolla.elven_shield_2
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_2
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                price_conditions:
                  - operator: gt
                    value: '10.5000'
                  - operator: lt
                    value: '50.0000'
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
          schema:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/promotion_user-attribute_conditions_model-post
              bonus:
                $ref: '#/components/schemas/Promotions_coupon_bonus'
              discount:
                example:
                  percent: '10.10'
                nullable: true
                properties:
                  percent:
                    $ref: '#/components/schemas/Promotions_promotion_discount_percent'
                type: object
              discounted_items:
                $ref: '#/components/schemas/Promotions_discounted_items'
              excluded_promotions:
                $ref: '#/components/schemas/excluded_promotions'
              item_price_conditions:
                $ref: '#/components/schemas/item_price_conditions_promocode'
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              price_conditions:
                $ref: '#/components/schemas/price_conditions_promocode'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - name
            type: object
    Promotions_redeem-coupon-model:
      content:
        application/json:
          schema:
            properties:
              coupon_code:
                default: WINTER2021
                description: Уникальный код купона. Содержит буквы и цифры.
                example: WINTER2021
                maxLength: 128
                minLength: 1
                type: string
              selected_unit_items:
                $ref: '#/components/schemas/Promotions_selected_unit_items'
            type: object
    Promotions_redeem-promo-code-model:
      content:
        application/json:
          schema:
            properties:
              cart:
                nullable: true
                properties:
                  id:
                    default: current
                    description: ID корзины.
                    type: string
                required:
                  - id
                type: object
              coupon_code:
                default: SUMMER2021
                description: Уникальный код промокода. Содержит буквы и цифры.
                example: SUMMER2021
                maxLength: 128
                minLength: 1
                type: string
              selected_unit_items:
                $ref: '#/components/schemas/Promotions_selected_unit_items'
            type: object
    Promotions_unique_catalog_offer-create:
      content:
        application/json:
          examples:
            limited:
              value:
                date_end: '2020-04-25T18:16:00+05:00'
                date_start: '2020-04-15T18:16:00+05:00'
                external_id: offer_external_id
                items:
                  - elven_sword
                  - elven_boots
                name:
                  de-DE: Neujahrsangebot
                  en-US: New Year Offer
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple:
              value:
                date_end: '2020-04-25T18:16:00+05:00'
                date_start: '2020-04-15T18:16:00+05:00'
                external_id: offer_external_id
                items:
                  - elven_sword
                  - elven_boots
                name:
                  de-DE: Neujahrsangebot
                  en-US: New Year Offer
          schema:
            properties:
              date_end:
                $ref: '#/components/schemas/Promotions_coupon_date_end'
              date_start:
                $ref: '#/components/schemas/Promotions_coupon_date_start'
              external_id:
                $ref: '#/components/schemas/Promotions_coupon-external_id'
              items:
                $ref: '#/components/schemas/Promotions_unique_catalog_offer_items'
                type: array
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - external_id
              - name
            type: object
    Promotions_unique_catalog_offer-update:
      content:
        application/json:
          examples:
            limited:
              value:
                items:
                  - elven_sword
                  - elven_boots
                name:
                  de-DE: Neujahrsangebot
                  en-US: New Year Offer
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                redeem_code_limit: 1
                redeem_total_limit: 100
                redeem_user_limit: 1
            simple:
              value:
                items:
                  - elven_sword
                  - elven_boots
                name:
                  de-DE: Neujahrsangebot
                  en-US: New Year Offer
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
                  - date_from: '2020-05-15T18:16:00+05:00'
                    date_until: '2020-05-25T18:16:00+05:00'
          schema:
            properties:
              items:
                $ref: '#/components/schemas/Promotions_unique_catalog_offer_items'
              name:
                $ref: '#/components/schemas/Promotions_coupon_name'
              promotion_periods:
                $ref: '#/components/schemas/promotion_periods'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
              redeem_user_limit:
                $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
            required:
              - name
            type: object
    Virtual-Items-Currency_admin-create-virtual-currency:
      content:
        application/json:
          example:
            attributes:
              - external_id: material
                name:
                  en-US: Material
                values:
                  - external_id: gold
                    value:
                      en-US: Gold
            custom_attributes:
              attr: value
              purchased: 0
            description:
              de-DE: Die Hauptwährung deines Königreichs
              en-US: The main currency of your kingdom
            groups:
              - gold
            is_enabled: true
            is_free: false
            limits:
              per_item: 10000
              per_user: 5
            name:
              de-DE: Goldmünze
              en-US: Gold coin
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices:
              - amount: 100
                currency: USD
                is_default: true
                is_enabled: true
            sku: com.xsolla.coin_1
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-currency
    Virtual-Items-Currency_admin-create-virtual-currency-package:
      content:
        application/json:
          example:
            attributes:
              - external_id: event
                name:
                  en-US: Event
                values:
                  - external_id: 10-anniversary
                    value:
                      en-US: 10th anniversary
                  - external_id: christmas
                    value:
                      en-US: Christmas
            content:
              - quantity: 500
                sku: com.xsolla.novigrad_crown
            custom_attributes:
              attr: value
              purchased: 0
            description:
              en-US: >-
                The Crown (also known as the Novigradian crown) is a monetary
                unit which is used in some Northern Kingdoms
              ru-RU: >-
                Крона (Также известна как Новиградская крона) - платежная
                единица, используемая в северных королевствах
            groups:
              - witcher
            image_url: >-
              https://vignette.wikia.nocookie.net/witcher/images/7/7c/Items_Orens.png/revision/latest?cb=20081113120917
            is_enabled: true
            is_free: false
            limits:
              per_item: null
              per_user: null
            long_description:
              en-US: Long Test new
              ru-RU: Длинное описание
            media_list:
              - type: image
                url: https://test.com/image0
              - type: image
                url: https://test.com/image1
            name:
              en-US: 500x Novigradian crown
              ru-RU: 500x Новиградских крон
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices:
              - amount: 99.99
                currency: USD
                is_default: true
              - amount: 80.03
                currency: EUR
                is_enabled: false
            sku: com.xsolla.novigrad_crown_500
            vc_prices: null
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-currency-package
    Virtual-Items-Currency_admin-create-virtual-item:
      content:
        application/json:
          example:
            attributes:
              - external_id: craft-materials
                name:
                  en: Craft materials
                values:
                  - external_id: steel
                    value:
                      en-US: '5'
                  - external_id: leather
                    value:
                      en-US: '1'
            custom_attributes:
              attr: value
              purchased: 0
            description:
              de: >-
                Ein Schwert ist eine Nahkampfwaffe mit Klinge, die zum Schneiden
                oder Stechen bestimmt ist, länger als ein Messer oder Dolch ist
                und aus einer langen Klinge besteht, die an einem Griff
                befestigt ist.
              en: >-
                A sword is a bladed melee weapon intended for cutting or
                thrusting that is longer than a knife or dagger, consisting of a
                long blade attached to a hilt.
            groups:
              - weapons
            is_enabled: true
            is_free: false
            is_show_in_store: true
            limits:
              per_item: 100
              per_user: 5
            name:
              de: Schwert
              en: Sword
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices:
              - amount: 100
                currency: USD
                is_default: true
                is_enabled: true
              - amount: 200
                country_iso: CZ
                currency: CZK
                is_default: true
                is_enabled: false
            sku: com.xsolla.sword_1
            vc_prices: []
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-create-virtual-item
    admin-order-search:
      content:
        application/json:
          example:
            created_date_from: '2018-01-07T00:00:00+03:00'
            created_date_until: '2018-01-09T16:00:00+03:00'
            limit: 5
            offset: 0
          schema:
            properties:
              created_date_from:
                description: >-
                  Дата или дата и время начала периода создания заказов согласно
                  стандарту [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
                example: '2020-04-15T18:16:00+05:00'
                format: date-time
                nullable: false
                type: string
              created_date_until:
                description: >-
                  Дата или дата и время окончания периода создания заказов
                  согласно стандарту [ISO
                  8601](https://en.wikipedia.org/wiki/ISO_8601).
                example: '2020-04-16T18:16:00+05:00'
                format: date-time
                nullable: false
                type: string
              limit:
                default: 10
                description: Ограничение на количество заказов для вывода в ответе.
                maximum: 10
                minimum: 1
                nullable: false
                type: integer
              offset:
                default: 0
                description: >-
                  Номер заказа, с которого формируется список в ответе
                  (нумерация ведется с 0).
                minimum: 0
                nullable: false
                type: integer
            type: object
      description: Параметры поиска заказа
    connector-import-items-body:
      content:
        application/json:
          schema:
            properties:
              connector_external_id:
                description: >-
                  Фиксированное значение, определяющее тип операции для импорта
                  товаров.
                enum:
                  - import_items
                type: string
              file_url:
                description: >-
                  URL-адрес файла с данными в формате JSON. Файл должен быть
                  размещен на сервисе хранения данных в публичном доступе.
                  Шаблон файла вы можете скачать в Личном кабинете в разделе
                  [Store > Виртуальные предметы > Управление каталогом >
                  Импортировать товары
                  (JSON)](https://publisher.xsolla.com/0/projects/0/storefront/import-export/import-items).
                example: https://my-bucket.s3.amazonaws.com/items.json
                type: string
              mode:
                default: create_and_update
                description: 'Действия при импорте:'
                enum:
                  - create
                  - create_and_update
                  - sync
                type: string
                x-enumDescriptions:
                  create: Добавить новые товары.
                  create_and_update: Добавить новые и обновить существующие товары.
                  sync: >-
                    Добавить новые, обновить существующие и отключить
                    недостающие товары.
            required:
              - connector_external_id
              - file_url
            type: object
    create-daily-chain:
      content:
        application/json:
          examples:
            calendar_hard:
              summary: Ежедневная награда с типом `calendar_hard`
              value:
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  en: New daily reward short description
                is_enabled: true
                name:
                  en: New daily reward
                  ru: Новая ежедневная награда
                order: 4
                steps:
                  - items:
                      - quantity: 2
                        sku: vg_enabled_shown_in_store_1
                    step_number: 1
                  - items:
                      - quantity: 2
                        sku: >-
                          bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg
                    step_number: 2
                  - items:
                      - quantity: 2
                        sku: >-
                          vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: vg_enabled_shown_in_store_1
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: >-
                          bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg
                    step_number: 5
                  - items:
                      - quantity: 1
                        sku: >-
                          vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1
                    step_number: 6
                type: calendar_hard
            rolling_skippable:
              summary: Ежедневная награда с типом `rolling_skippable`
              value:
                date_end: '2023-05-31T10:00:00+05:00'
                date_start: '2023-05-01T10:00:00+05:00'
                description:
                  en: New skippable login reward short description
                is_enabled: true
                is_recurrent: true
                name:
                  en: New skippable login reward
                order: 1
                steps:
                  - items:
                      - quantity: 1
                        sku: monday_reward_item_one
                    step_number: 1
                  - items:
                      - quantity: 1
                        sku: tuesday_reward_item_two
                    step_number: 2
                  - items:
                      - quantity: 1
                        sku: wednesday_reward_item_three
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: thursday_reward_item_four
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: friday_reward_item_five
                    step_number: 5
                  - items:
                      - quantity: 1
                        sku: saturday_reward_item_six
                    step_number: 6
                  - items:
                      - quantity: 1
                        sku: sunday_reward_item_seven
                    step_number: 7
                type: rolling_skippable
            rolling_unskippable:
              summary: Ежедневная награда с типом `rolling_unskippable`
              value:
                date_end: '2023-06-30T10:00:00+05:00'
                date_start: '2023-06-01T10:00:00+05:00'
                description:
                  en: New unskippable login reward short description
                is_enabled: true
                is_recurrent: false
                name:
                  en: New unskippable login reward
                order: 2
                steps:
                  - items:
                      - quantity: 1
                        sku: monday_reward_item_one
                    step_number: 1
                  - items:
                      - quantity: 1
                        sku: tuesday_reward_item_two
                    step_number: 2
                  - items:
                      - quantity: 1
                        sku: wednesday_reward_item_three
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: thursday_reward_item_four
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: friday_reward_item_five
                    step_number: 5
                type: rolling_unskippable
          schema:
            oneOf:
              - $ref: '#/components/schemas/create-calendar-hard-daily-chain-model'
              - $ref: >-
                  #/components/schemas/create-rolling-skippable-daily-chain-model
              - $ref: >-
                  #/components/schemas/create-rolling-unskippable-daily-chain-model
    create-offer-chain:
      content:
        application/json:
          examples:
            default:
              summary: Пример стандартной цепочки предложений
              value:
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: Eine kurze Beschreibung einer regulären Angebotskette
                  en: A short description of a regular offer chain
                  fr: Une brève description d'une chaîne d'offres régulière
                  it: Una breve descrizione di una catena di offerte regolare
                  ru: Краткое описание обычной цепочки предложений
                is_always_visible: true
                is_enabled: true
                name:
                  de: Neue Angebotskette
                  en: New offer chain
                  fr: Nouvelle chaîne d'offres
                  it: Nuova catena di offerte
                  ru: Новая цепочка предложений
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_step_1_paid_bundle_sku
                    step_number: 1
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_step_2_free_virtual_good_sku
                    step_number: 2
                  - is_free: false
                    items:
                      - quantity: 5
                        sku: chain_step_3_paid_virtual_currency_package_sku
                    step_number: 3
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_step_4_free_bundle_sku
                    step_number: 4
            personalized-default:
              summary: Пример персонализированной цепочки предложений
              value:
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: >-
                    Standard-personalisierte Angebotskette für Benutzer, die die
                    Bedingungen anderer personalisierter Ketten nicht erfüllen
                  en: >-
                    Default personalized offer chain for users that do not meet
                    the conditions of other personalized chains
                  fr: >-
                    Chaîne d'offres personnalisée par défaut pour les
                    utilisateurs qui ne répondent pas aux conditions des autres
                    chaînes personnalisées
                  it: >-
                    Catena di offerte personalizzata predefinita per gli utenti
                    che non soddisfano le condizioni di altre catene
                    personalizzate
                  ru: >-
                    Персонализированная цепочка по умолчанию для пользователей,
                    не подходящих под условия других персонализированных цепочек
                is_always_visible: false
                is_enabled: true
                name:
                  de: Neue personalisierte Standard-Angebotskette
                  en: New personalized default offer chain
                  fr: Nouvelle chaîne d'offres personnalisée par défaut
                  it: Nuova catena di offerte personalizzata predefinita
                  ru: Новая персонализированная цепочка предложений по умолчанию
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 1
                        sku: chain_x_step_1_item_default
                    step_number: 1
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_x_step_2_item_default
                    step_number: 2
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_x_step_3_free_item_default
                    step_number: 3
            personalized-with-conditions:
              summary: >-
                Пример персонализированной цепочки предложений с условиями по
                атрибутам пользователя
              value:
                attribute_conditions:
                  - attribute: race
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: elf
                  - attribute: level
                    can_be_missing: false
                    operator: ge
                    type: number
                    value: '10'
                  - attribute: 10_level_up_date
                    can_be_missing: false
                    operator: le
                    type: date
                    value: '2026-01-01T00:00:00'
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: >-
                    Personalisierte Angebotskette mit
                    Benutzerattributbedingungen - für Elfen der Stufe 10 und
                    höher, die Stufe 10 spätestens am 2026-01-01 00:00:00
                    erreicht haben, einschließlich
                  en: >-
                    Personalized offer chain with user attribute conditions -
                    for level 10 and above elves who reached level 10 no later
                    than 2026-01-01 00:00:00, inclusive
                  fr: >-
                    Chaîne d'offres personnalisée avec des conditions d'attribut
                    utilisateur - pour les elfes de niveau 10 et plus qui ont
                    atteint le niveau 10 au plus tard le 2026-01-01 00:00:00,
                    inclus
                  it: >-
                    Catena di offerte personalizzata con condizioni di attributo
                    utente - per elfi di livello 10 e superiore che hanno
                    raggiunto il livello 10 non più tardi del 2026-01-01
                    00:00:00, inclusi
                  ru: >-
                    Персонализированная цепочка предложений с условиями по
                    атрибутам пользователя - для эльфов уровня 10 и выше,
                    достигших 10 уровня не позднее 2026-01-01 00:00:00
                    включительно
                is_always_visible: false
                is_enabled: true
                name:
                  de: Neue personalisierte Angebotskette
                  en: New personalized offer chain
                  fr: Nouvelle chaîne d'offres personnalisée
                  it: Nuova catena di offerte personalizzata
                  ru: Новая персонализированная цепочка предложений
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 1
                        sku: chain_x_step_1_item_for_elves_level_10_and_above
                    step_number: 1
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_x_step_2_item_for_elves_level_10_and_above
                    step_number: 2
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_x_step_3_free_item_for_elves_level_10_and_above
                    step_number: 3
            recurrent:
              summary: Пример повторяющейся цепочки предложений
              value:
                date_end: '2025-04-25T18:16:00+05:00'
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: >-
                    Eine wiederkehrende Angebotskette, die wöchentlich mittwochs
                    um 07:00 Uhr GMT+3 zurückgesetzt wird
                  en: >-
                    A recurring offer chain that resets weekly on Wednesdays at
                    07:00 AM GMT+3
                  fr: >-
                    Une chaîne d'offres récurrente qui se réinitialise chaque
                    semaine le mercredi à 07h00 GMT+3
                  it: >-
                    Una catena di offerte ricorrente che si resetta
                    settimanalmente il mercoledì alle 07:00 GMT+3
                  ru: >-
                    Рекуррентная цепочка предложений, которая сбрасывается
                    еженедельно по средам в 07:00 по GMT+3
                is_always_visible: true
                is_enabled: false
                name:
                  de: Neue wiederkehrende Angebotskette
                  en: New recurrent offer chain
                  fr: Nouvelle chaîne d'offres récurrente
                  it: Nuova catena di offerte ricorrente
                  ru: Новая рекуррентная цепочка предложений
                order: 1
                recurrent_schedule:
                  day_of_week: 3
                  interval_type: weekly
                  time: 07:00:00+03:00
                steps:
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_step_1_paid_bundle_sku
                    step_number: 1
                  - is_free: true
                    items:
                      - quantity: 3
                        sku: chain_step_2_free_virtual_good_sku
                    step_number: 2
          schema:
            $ref: '#/components/schemas/create-offer-chain-model'
    create-reward-chain:
      content:
        application/json:
          examples:
            clan:
              summary: Пример клановой цепочки наград
              value:
                clan_type: guild
                description:
                  en: Clan reward chain description.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_enabled: true
                long_description:
                  en: Clan reward chain long description.
                name:
                  en: Clan reward chain
                order: 1
                periods:
                  - date_from: '2026-01-01T01:00:00+05:00'
                    date_until: '2026-01-31T23:59:59+05:00'
                  - date_from: '2026-02-01T01:00:00+05:00'
                    date_until: '2026-02-28T23:59:59+05:00'
                popup_header:
                  en: How to unlock rewards
                popup_image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                popup_instruction:
                  en: >-
                    You must be a clan member to get clan rewards. You join a
                    clan when a clan member invites you to the clan, and you
                    accept the invite. You can also create your own clan.
                recurrent_schedule:
                  day_of_week: 1
                  interval_type: weekly
                  time: 01:00:00+08:00
                steps:
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: First step of the reward chain
                    price:
                      amount: 10
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_1
                      - quantity: 1
                        sku: com.xsolla.item_2
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: Second step of the reward chain
                    price:
                      amount: 15
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_3
                      - quantity: 1
                        sku: com.xsolla.item_4
                value_point:
                  sku: com.xsolla.clan_value_point_1
            default:
              summary: Пример цепочки наград
              value:
                attribute_conditions:
                  - attribute: race
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: ork
                description:
                  en: Reward chain description.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_always_visible: true
                is_enabled: true
                is_reset_after_end: true
                long_description:
                  en: Reward chain long description.
                name:
                  en: Reward chain
                order: 1
                periods:
                  - date_from: '2026-01-01T01:00:00+05:00'
                    date_until: '2026-01-31T23:59:59+05:00'
                  - date_from: '2026-02-01T01:00:00+05:00'
                    date_until: '2026-02-28T23:59:59+05:00'
                recurrent_schedule:
                  day_of_week: 1
                  interval_type: weekly
                  time: 01:00:00+08:00
                steps:
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: First step of the reward chain
                    price:
                      amount: 10
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_1
                      - quantity: 1
                        sku: com.xsolla.item_2
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: Second step of the reward chain
                    price:
                      amount: 15
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_3
                      - quantity: 1
                        sku: com.xsolla.item_4
                value_point:
                  sku: com.xsolla.value_point_1
          schema:
            oneOf:
              - $ref: '#/components/schemas/create-reward-chain-model'
              - $ref: '#/components/schemas/create-clan-reward-chain-model'
    create-update-attribute:
      content:
        application/json:
          example:
            external_id: genre
            name:
              de: Genre
              en: Genre
          schema:
            properties:
              external_id:
                $ref: '#/components/schemas/admin-attribute-external_id'
              name:
                $ref: '#/components/schemas/admin-attribute-name'
            required:
              - external_id
              - name
            type: object
    create-update-attribute-value:
      content:
        application/json:
          example:
            external_id: weapon_class_sword_value
            value:
              de: Schwert
              en: Sword
          schema:
            $ref: '#/components/schemas/request-attribute-value'
    create-update-region:
      content:
        application/json:
          schema:
            example:
              countries:
                - JP
                - CN
                - VN
              name:
                de-DE: Asien
                en-US: Asia
            properties:
              countries:
                $ref: '#/components/schemas/Regions_countries'
              name:
                $ref: '#/components/schemas/Regions_name'
            required:
              - countries
              - name
            type: object
    create-upsell:
      content:
        application/json:
          examples:
            fixed_list:
              summary: Пример апселла с фиксированным списком товаров
              value:
                is_enabled: true
                items:
                  - game_sku_1
                  - game_sku_2
                  - game_sku_3
                type: fixed_list
            special_type_most_sellable:
              summary: Пример апселла самых продаваемых товаров за последние 30 дней
              value:
                is_enabled: true
                items: []
                type: most_sellable
            special_type_promotions:
              summary: 'Пример апселла с товарами с промоакциями '
              value:
                is_enabled: true
                items: []
                type: only_promotions
          schema:
            oneOf:
              - $ref: '#/components/schemas/Upsell-model'
              - $ref: '#/components/schemas/Upsell-model-not-fixed-list'
    create-value-point:
      content:
        application/json:
          examples:
            clan:
              summary: Призовой балл для цепочки наград для клана
              value:
                description:
                  en: Value points for clan reward system.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_clan: true
                is_enabled: true
                long_description:
                  en: >-
                    Value points given to clans to get new rewards in a reward
                    chain.
                media_list: []
                name:
                  en: Clan Reward VP 1
                order: 3
                sku: com.xsolla.clan_value_point_1
            default:
              summary: Призовой балл для цепочки наград
              value:
                description:
                  en: Value points for reward system.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_enabled: true
                long_description:
                  en: >-
                    Value points given to users to get new rewards in a reward
                    chain.
                media_list: []
                name:
                  en: Reward VP 1
                order: 1
                sku: com.xsolla.reward_vp_1
          schema:
            $ref: '#/components/schemas/admin_value_points-create'
    personalized-catalog_create-update-body:
      content:
        application/json:
          example:
            attribute_conditions:
              - attribute: race
                can_be_missing: false
                operator: eq
                type: string
                value: ork
            is_enabled: true
            is_satisfied_for_unauth: false
            items:
              - item_id: 1
            name: Ork race armor rule
          schema:
            $ref: >-
              #/components/schemas/user-attribute_personalized-catalog-body-required
    reset-user-limits:
      content:
        application/json:
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
          schema:
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user'
            required:
              - user
            type: object
    reset-user-limits-flexible:
      content:
        application/json:
          example:
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
          schema:
            properties:
              user:
                $ref: '#/components/schemas/User-limit_user_flexible'
            required:
              - user
            type: object
    set-item-value-point-reward:
      content:
        application/json:
          example:
            - amount: 100
              sku: com.xsolla.booster_1
            - amount: 200
              sku: com.xsolla.booster_mega
          schema:
            $ref: '#/components/schemas/item-value-point-reward-set'
    set-item-value-point-reward-for-patch:
      content:
        application/json:
          example:
            - amount: 100
              sku: booster_1
            - amount: 0
              sku: booster_mega
          schema:
            $ref: '#/components/schemas/item-value-point-reward-set-for-patch'
    update-daily-chain:
      content:
        application/json:
          examples:
            calendar_hard:
              summary: Ежедневная награда с типом `calendar_hard`
              value:
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  en: Updated daily reward description
                is_enabled: true
                name:
                  en: Updated daily reward
                  ru: Обновленная ежедневная награда
                order: 4
                steps:
                  - items:
                      - quantity: 1
                        sku: vg_enabled_shown_in_store_1
                    step_number: 1
                  - items:
                      - quantity: 1
                        sku: vg_enabled_shown_in_store_2
                    step_number: 2
                  - items:
                      - quantity: 1
                        sku: vg_not_shown_in_store
                    step_id: 10
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: >-
                          bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg
                    step_id: 8
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: >-
                          vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1
                    step_number: 5
                type: calendar_hard
            rolling_skippable:
              summary: Ежедневная награда с типом `rolling_skippable`
              value:
                date_end: '2023-08-31T10:00:00+05:00'
                date_start: '2023-08-01T10:00:00+05:00'
                description:
                  en: Updated login reward description
                is_enabled: true
                name:
                  en: Updated login reward
                order: 4
                steps:
                  - items:
                      - quantity: 1
                        sku: monday_reward_item_one
                    step_number: 1
                  - items:
                      - quantity: 1
                        sku: tuesday_reward_item_two
                    step_number: 2
                  - items:
                      - quantity: 1
                        sku: wednesday_reward_item_three
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: thursday_reward_item_four
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: friday_reward_item_five
                    step_number: 5
                  - items:
                      - quantity: 1
                        sku: saturday_reward_item_six
                    step_number: 6
                  - items:
                      - quantity: 1
                        sku: sunday_reward_item_seven
                    step_number: 7
                type: rolling_skippable
            rolling_unskippable:
              summary: Ежедневная награда с типом `rolling_unskippable`
              value:
                date_end: '2023-09-30T10:00:00+05:00'
                date_start: '2023-09-01T10:00:00+05:00'
                description:
                  en: Updated unskippable login reward description
                is_enabled: true
                name:
                  en: Updated unskippable login reward
                order: 2
                steps:
                  - items:
                      - quantity: 1
                        sku: monday_reward_item_one
                    step_number: 1
                  - items:
                      - quantity: 1
                        sku: tuesday_reward_item_two
                    step_number: 2
                  - items:
                      - quantity: 1
                        sku: wednesday_reward_item_three
                    step_number: 3
                  - items:
                      - quantity: 1
                        sku: thursday_reward_item_four
                    step_number: 4
                  - items:
                      - quantity: 1
                        sku: friday_reward_item_five
                    step_number: 5
                type: rolling_unskippable
          schema:
            oneOf:
              - $ref: '#/components/schemas/update-calendar-hard-daily-chain-model'
              - $ref: >-
                  #/components/schemas/update-rolling-skippable-daily-chain-model
              - $ref: >-
                  #/components/schemas/update-rolling-unskippable-daily-chain-model
    update-offer-chain:
      content:
        application/json:
          examples:
            default:
              summary: Пример по умолчанию
              value:
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: Eine kurze Beschreibung einer regulären Angebotskette
                  en: A short description of a regular offer chain
                  fr: Une brève description d'une chaîne d'offres régulière
                  it: Una breve descrizione di una catena di offerte regolare
                  ru: Краткое описание обычной цепочки предложений
                is_always_visible: true
                is_enabled: true
                name:
                  de: Aktualisierte Angebotskette
                  en: Updated offer chain
                  fr: Chaîne d'offres mise à jour
                  it: Catena di offerte aggiornata
                  ru: Обновляемая цепочка предложений
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_step_1_paid_bundle_sku
                    step_id: 10
                    step_number: 1
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_step_2_free_virtual_good_sku
                    step_number: 2
                  - is_free: false
                    items:
                      - quantity: 5
                        sku: chain_step_3_paid_virtual_currency_package_sku
                    step_number: 3
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_step_4_free_bundle_sku
                    step_id: 9
                    step_number: 4
            personalized-default:
              summary: Пример персонализированной цепочки предложений
              value:
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: >-
                    Standard-personalisierte Angebotskette für Benutzer, die die
                    Bedingungen anderer personalisierter Ketten nicht erfüllen
                  en: >-
                    Default personalized offer chain for users that do not meet
                    the conditions of other personalized chains
                  fr: >-
                    Chaîne d'offres personnalisée par défaut pour les
                    utilisateurs qui ne répondent pas aux conditions des autres
                    chaînes personnalisées
                  it: >-
                    Catena di offerte personalizzata predefinita per gli utenti
                    che non soddisfano le condizioni di altre catene
                    personalizzate
                  ru: >-
                    Персонализированная цепочка по умолчанию для пользователей,
                    не подходящих под условия других персонализированных цепочек
                is_always_visible: false
                is_enabled: true
                name:
                  de: Neue personalisierte Standard-Angebotskette
                  en: New personalized default offer chain
                  fr: Nouvelle chaîne d'offres personnalisée par défaut
                  it: Nuova catena di offerte personalizzata predefinita
                  ru: Новая персонализированная цепочка предложений по умолчанию
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 1
                        sku: chain_x_step_1_item_default
                    step_id: 10
                    step_number: 1
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_x_step_2_item_default
                    step_number: 2
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_x_step_3_free_item_default
                    step_id: 9
                    step_number: 3
            personalized-with-conditions:
              summary: >-
                Пример персонализированной цепочки предложений с условиями по
                атрибутам пользователя
              value:
                attribute_conditions:
                  - attribute: race
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: elf
                  - attribute: level
                    can_be_missing: false
                    operator: ge
                    type: number
                    value: '10'
                  - attribute: 10_level_up_date
                    can_be_missing: false
                    operator: le
                    type: date
                    value: '2026-01-01T00:00:00'
                date_end: null
                date_start: '2023-04-15T18:16:00+05:00'
                description:
                  de: >-
                    Personalisierte Angebotskette mit
                    Benutzerattributbedingungen - für Elfen der Stufe 10 und
                    höher, die Stufe 10 spätestens am 2026-01-01 00:00:00
                    erreicht haben, einschließlich
                  en: >-
                    Personalized offer chain with user attribute conditions -
                    for level 10 and above elves who reached level 10 no later
                    than 2026-01-01 00:00:00, inclusive
                  fr: >-
                    Chaîne d'offres personnalisée avec des conditions d'attribut
                    utilisateur - pour les elfes de niveau 10 et plus qui ont
                    atteint le niveau 10 au plus tard le 2026-01-01 00:00:00,
                    inclus
                  it: >-
                    Catena di offerte personalizzata con condizioni di attributo
                    utente - per elfi di livello 10 e superiore che hanno
                    raggiunto il livello 10 non più tardi del 2026-01-01
                    00:00:00, inclusi
                  ru: >-
                    Персонализированная цепочка предложений с условиями по
                    атрибутам пользователя - для эльфов уровня 10 и выше,
                    достигших 10 уровня не позднее 2026-01-01 00:00:00
                    включительно
                is_always_visible: false
                is_enabled: true
                name:
                  de: Neue personalisierte Angebotskette
                  en: New personalized offer chain
                  fr: Nouvelle chaîne d'offres personnalisée
                  it: Nuova catena di offerte personalizzata
                  ru: Новая персонализированная цепочка предложений
                order: 4
                recurrent_schedule: null
                steps:
                  - is_free: false
                    items:
                      - quantity: 1
                        sku: chain_x_step_1_item_for_elves_level_10_and_above
                    step_id: 10
                    step_number: 1
                  - is_free: false
                    items:
                      - quantity: 2
                        sku: chain_x_step_2_item_for_elves_level_10_and_above
                    step_id: 8
                    step_number: 2
                  - is_free: true
                    items:
                      - quantity: 1
                        sku: chain_x_step_3_free_item_for_elves_level_10_and_above
                    step_number: 3
            recurrent:
              summary: Пример повторяющейся цепочки предложений
              value:
                date_end: '2025-04-25T19:16:00+05:00'
                date_start: '2023-04-15T17:16:00+05:00'
                description:
                  de: >-
                    Aktualisierte Angebotskette, die wiederkehrend wird und
                    monatlich am 2. Tag um 03:00 Uhr GMT+8 zurückgesetzt wird
                  en: >-
                    Updated offer chain that becomes recurrent and resets
                    monthly on the 2nd day at 03:00 AM GMT+8
                  fr: >-
                    Chaîne d'offres mise à jour qui devient récurrente et se
                    réinitialise mensuellement le 2e jour à 03h00 GMT+8
                  it: >-
                    Catena di offerte aggiornata che diventa ricorrente e si
                    resetta mensilmente il 2° giorno alle 03:00 GMT+8
                  ru: >-
                    Обновляемая цепочка предложений, которая становится
                    рекуррентной и сбрасывается ежемесячно во 2-й день в 03:00
                    по GMT+8
                id: 1
                is_enabled: true
                name:
                  de: Aktualisierte wiederkehrende Angebotskette
                  en: Updated recurrent offer chain
                  fr: Chaîne d'offres récurrente mise à jour
                  it: Catena di offerte ricorrente aggiornata
                  ru: Обновляемая рекуррентная цепочка предложений
                order: 4
                recurrent_schedule:
                  day_of_month: 2
                  interval_type: monthly
                  time: 03:00:00+08:00
                steps:
                  - is_free: false
                    items:
                      - quantity: 6
                        sku: chain_bundle_sku
                    step_number: 1
                  - is_free: true
                    items:
                      - quantity: 2
                        sku: chain_bundle_sku
                    step_number: 1
          schema:
            $ref: '#/components/schemas/modify-offer-chain-model'
    update-reward-chain:
      content:
        application/json:
          examples:
            clan:
              summary: Пример клановой цепочки наград
              value:
                clan_type: guild
                description:
                  en: Clan reward chain description.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_enabled: true
                long_description:
                  en: Clan reward chain long description.
                name:
                  en: Clan reward chain
                order: 1
                periods:
                  - date_from: '2026-01-01T01:00:00+05:00'
                    date_until: '2026-01-31T23:59:59+05:00'
                  - date_from: '2026-02-01T01:00:00+05:00'
                    date_until: '2026-02-28T23:59:59+05:00'
                popup_header:
                  en: How to unlock rewards
                popup_image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                popup_instruction:
                  en: >-
                    You should be a clan member to get clan rewards. You join a
                    clan when a clan member invited you to the clan, and you
                    accepted the invite. You can create your own clan.
                recurrent_schedule:
                  day_of_week: 1
                  interval_type: weekly
                  time: 01:00:00+08:00
                steps:
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: First step of the reward chain
                    price:
                      amount: 10
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_1
                      - quantity: 1
                        sku: com.xsolla.item_2
                    step_id: 1
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: Second step of the reward chain
                    price:
                      amount: 15
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_3
                      - quantity: 1
                        sku: com.xsolla.item_4
                    step_id: 2
            default:
              summary: Пример цепочки наград
              value:
                attribute_conditions:
                  - attribute: race
                    can_be_missing: false
                    operator: eq
                    type: string
                    value: ork
                description:
                  en: Reward chain description.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_always_visible: true
                is_enabled: true
                is_reset_after_end: true
                long_description:
                  en: Reward chain long description.
                name:
                  en: Reward chain
                order: 1
                periods:
                  - date_from: '2026-01-01T01:00:00+05:00'
                    date_until: '2026-01-31T23:59:59+05:00'
                  - date_from: '2026-02-01T01:00:00+05:00'
                    date_until: '2026-02-28T23:59:59+05:00'
                recurrent_schedule:
                  day_of_week: 1
                  interval_type: weekly
                  time: 01:00:00+08:00
                steps:
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: First step of the reward chain
                    price:
                      amount: 10
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_1
                      - quantity: 1
                        sku: com.xsolla.item_2
                    step_id: 1
                  - image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                    name:
                      en: Second step of the reward chain
                    price:
                      amount: 15
                    reward:
                      - quantity: 5
                        sku: com.xsolla.item_3
                      - quantity: 1
                        sku: com.xsolla.item_4
                    step_id: 2
          schema:
            oneOf:
              - $ref: '#/components/schemas/update-reward-chain-model'
              - $ref: '#/components/schemas/update-clan-reward-chain-model'
    update-upsell:
      content:
        application/json:
          examples:
            fixed_list:
              summary: Пример апселла с фиксированным списком товаров
              value:
                is_enabled: true
                items:
                  - game_sku_1
                  - game_sku_2
                  - game_sku_3
                type: fixed_list
            special_type_most_sellable:
              summary: Пример апселла самых продаваемых товаров за последние 30 дней
              value:
                is_enabled: true
                items: []
                type: most_sellable
            special_type_promotions:
              summary: 'Пример апселла с товарами с промоакциями '
              value:
                is_enabled: true
                items: []
                type: only_promotions
          schema:
            oneOf:
              - $ref: '#/components/schemas/Upsell-model'
              - $ref: '#/components/schemas/Upsell-model-not-fixed-list'
    update-user-limits-flexible:
      content:
        application/json:
          example:
            available: 0
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
          schema:
            properties:
              available:
                $ref: '#/components/schemas/User-limit_available_flexible'
              user:
                $ref: '#/components/schemas/User-limit_user'
            required:
              - user
              - available
            type: object
    update-user-limits-strict:
      content:
        application/json:
          example:
            available: 1
            user:
              user_external_id: d342dad2-9d59-11e9-a384-42010aa8003f
          schema:
            properties:
              available:
                $ref: '#/components/schemas/User-limit_available'
              user:
                $ref: '#/components/schemas/User-limit_user'
            required:
              - user
              - available
            type: object
  responses:
    200-admin-get-attribute:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/admin_attribute_response'
      description: Указанный атрибут успешно получен.
    200-admin-get-attribute-list-response:
      content:
        application/json:
          examples:
            response:
              value:
                attributes:
                  - external_id: size
                    name:
                      de: Größe
                      en: Size
                  - external_id: genre
                    name:
                      de: Genre
                      en: Genre
                total_count: 2
          schema:
            description: Объект с товарами.
            properties:
              attributes:
                items:
                  $ref: '#/components/schemas/admin_attribute_response'
                type: array
              total_count:
                type: integer
            type: object
      description: Список атрибутов успешно получен.
    200-admin-get-code-coupon-limits:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/code-limit'
          schema:
            properties:
              has_more:
                description: Существует ли другая страница с кодами.
                type: boolean
              items:
                items:
                  $ref: '#/components/schemas/Code-limit-promo-code'
                type: array
              promotion_id:
                description: ID акции. Уникальный идентификатор акции в рамках проекта.
                type: integer
              total_items_count:
                description: Общее количество кодов.
                type: number
            type: object
      description: Успешно получены ограничения купона.
    200-admin-get-code-promo-code-limits:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/code-limit'
          schema:
            properties:
              has_more:
                description: Существует ли другая страница с кодами.
                type: boolean
              items:
                items:
                  $ref: '#/components/schemas/Code-limit-promo-code'
                type: array
              promotion_id:
                description: ID акции. Уникальный идентификатор акции в рамках проекта.
                type: integer
              total_items_count:
                description: Общее количество кодов.
                type: number
            type: object
      description: Успешно получены ограничения промокода.
    200-admin-get-daily-chain:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-admin-daily-chain'
          schema:
            $ref: '#/components/schemas/admin-daily-chain-long-model'
      description: Данные о ежедневной награде успешно получены.
    200-admin-get-list-daily-chains:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-admin-daily-chain-list'
          schema:
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                items:
                  $ref: '#/components/schemas/admin-daily-chain-short-model'
                type: array
              total_items_count:
                description: Общее количество ежедневных наград.
                example: 3
                type: integer
            type: object
      description: Список ежедневных наград успешно получен.
    200-admin-get-list-offer-chains:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-admin-offer-chain-list'
          schema:
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                items:
                  $ref: '#/components/schemas/admin-offer-chain-short-model'
                type: array
            type: object
      description: Список цепочек предложений успешно получен.
    200-admin-get-list-reward-chains:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-reward-chain-list'
          schema:
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                items:
                  oneOf:
                    - $ref: >-
                        #/components/schemas/admin-get-reward-chain-item-basic-model
                    - $ref: >-
                        #/components/schemas/admin-get-reward-chain-item-clan-basic-model
                type: array
            type: object
      description: Список цепочек наград был успешно получен.
    200-admin-get-list-value-point-rewards:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-value-points-rewards-list'
          schema:
            properties:
              items:
                items:
                  $ref: '#/components/schemas/admin-item-value-point-reward'
                type: array
            type: object
      description: Список товаров с призовыми баллами был успешно получен.
    200-admin-get-offer-chain:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-admin-offer-chain'
          schema:
            $ref: '#/components/schemas/admin-offer-chain-long-model'
      description: Данные цепочки предложений успешно получены.
    200-admin-get-redeemable-by-code:
      content:
        application/json:
          examples:
            Coupon Response:
              value:
                bonus:
                  - quantity: 3
                    sku: epic_fall_hammer_1
                external_id: coupon_fall_hammer_2
                is_enabled: true
                name:
                  en: This is a Coupon code for Epic Fall Hammer
                  ru: Eto kod kupona на Epic Fall Hammer
                promotion_periods:
                  - date_from: '2023-04-15T01:00:00+05:00'
                    date_until: '2023-04-30T23:59:59+05:00'
                  - date_from: '2023-05-15T01:00:00+05:00'
                    date_until: '2023-05-30T23:59:59+05:00'
                redeem_code_limit: null
                redeem_total_limit: 99
                redeem_user_limit: 1
            Promo Code Response:
              value:
                bonus: []
                discount:
                  percent: null
                discounted_items:
                  - discount:
                      percent: '20.00'
                    sku: epic_fall_hammer_1
                external_id: falls2023
                is_enabled: true
                name:
                  en: Promo Code discount for Epic Fall Hammer
                  ru: Скидка по промокоду на Epic Fall Hammer
                promotion_periods:
                  - date_from: '2023-05-01T01:00:00+05:00'
                    date_until: '2023-05-31T23:59:59+05:00'
                  - date_from: '2023-06-01T01:00:00+05:00'
                    date_until: '2023-06-30T23:59:59+05:00'
                redeem_code_limit: null
                redeem_total_limit: 2
                redeem_user_limit: 3
                total_limit_state:
                  available: 1
                  reserved: 1
                  used: 0
          schema:
            $ref: >-
              #/components/schemas/admin-promotions_200-get-redeemable-coupon-promotion-model
      description: Акция успешно получена.
    200-admin-get-region:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Regions_200-region-model'
      description: Указанный регион успешно получен.
    200-admin-get-regions-list:
      content:
        application/json:
          examples:
            response:
              value:
                regions:
                  - id: 44
                    name:
                      de-DE: Asien
                      en-US: Asia
                  - id: 45
                    name:
                      de-DE: GUS
                      en-US: CIS
          schema:
            description: Объект с товарами.
            properties:
              regions:
                items:
                  $ref: '#/components/schemas/Regions_200-region-short-model'
                type: array
            type: object
      description: Список регионов успешно получен.
    200-admin-get-reward-chain:
      content:
        application/json:
          examples:
            clan:
              $ref: '#/components/examples/200-clan-reward-chain'
            common:
              $ref: '#/components/examples/200-reward-chain'
          schema:
            oneOf:
              - $ref: '#/components/schemas/admin-get-reward-chain-item-full-model'
              - $ref: >-
                  #/components/schemas/admin-get-reward-chain-item-clan-full-model
      description: Указанная цепочка наград была успешно получена.
    200-admin-get-user-coupon-limits:
      content:
        application/json:
          examples:
            response:
              value:
                per_user:
                  available: 9
                  total: 10
          schema:
            $ref: '#/components/schemas/User-limit-coupon'
      description: Успешно получены ограничения купона для пользователя.
    200-admin-get-user-item-limits:
      content:
        application/json:
          examples:
            response:
              value:
                per_user:
                  available: 9
                  total: 10
          schema:
            $ref: '#/components/schemas/User-limit-item'
      description: Ограничения на покупку для пользователя были успешно получены.
    200-admin-get-user-promo-code-limits:
      content:
        application/json:
          examples:
            response:
              value:
                per_user:
                  available: 9
                  total: 10
          schema:
            $ref: '#/components/schemas/User-limit-promo-code'
      description: Успешно получены ограничения промокода для пользователей.
    200-admin-get-user-promotion-limits:
      content:
        application/json:
          examples:
            response:
              value:
                per_user:
                  available: 9
                  total: 10
          schema:
            $ref: '#/components/schemas/User-limit-promotion'
      description: Ограничения на продвижение для пользователя были успешно получены.
    200-admin-get-value-point:
      content:
        application/json:
          examples:
            response:
              $ref: >-
                #/components/examples/200-value-points-reward-chain_admin_get-value-point
          schema:
            $ref: '#/components/schemas/Value-point-item-model'
      description: Указанные призовые баллы были успешно получены.
    200-admin-get-value-points:
      content:
        application/json:
          examples:
            response:
              $ref: >-
                #/components/examples/200-value-points-reward-chain_admin_get-value-point-list
          schema:
            properties:
              items:
                items:
                  $ref: '#/components/schemas/Value-points-item-model'
                type: array
            type: object
      description: Список призовых баллов был успешно получен.
    200-admin-order-search:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: true
                orders:
                  - date_created: '2018-01-08T15:32:06+03:00'
                    is_free: true
                    items:
                      - description:
                          description: 'yes'
                          image_url: http://example.com/image.jpg
                          name: bla
                        is_bonus: false
                        is_free: true
                        item_id: 1005111
                        order_item_id: 29
                        quantity: 1
                        region_id: 1
                        sku: com.xsolla.1005111
                        tax_category: DG00001
                        type: virtual_good
                      - description: null
                        is_bonus: true
                        is_free: true
                        item_id: 1005112
                        order_item_id: 30
                        quantity: 3
                        region_id: 1
                        sku: com.xsolla.1005112
                        tax_category: DG00001
                        type: value_point
                    mode: default
                    order_id: 100511
                    project_id: 101
                    status: done
                    user:
                      country: US
                      email: user@xsolla.com
                      id: 07e653a2b15011e6818f005056a54369
                      region_id: 1
                  - coupons:
                      - code: OPQRSTUVWX
                        coupon_id: 100510
                        sku: com.xsolla.100510
                        type: promocode
                    date_created: '2018-01-07T15:32:06+03:00'
                    invoice_id: '100510'
                    is_free: false
                    items:
                      - description: null
                        is_bonus: false
                        is_free: false
                        item_id: 1005101
                        order_item_id: 27
                        price:
                          amount: '67.3400'
                          amount_without_discount: '67.3400'
                          currency: USD
                          is_virtual_currency: false
                        quantity: 1
                        region_id: null
                        sku: com.xsolla.1005101
                        tax_category: DG00001
                        type: game_key
                      - description: null
                        is_bonus: true
                        is_free: true
                        item_id: 1005102
                        order_item_id: 28
                        quantity: 2
                        region_id: null
                        sku: com.xsolla.1005102
                        tax_category: DG00001
                        type: value_point
                    mode: default
                    order_id: 100510
                    price:
                      amount: '67.3400'
                      amount_without_discount: '72.3400'
                      currency: USD
                      is_virtual_currency: false
                    project_id: 101
                    promotions:
                      - promotion_id: 1005101
                    status: paid
                    user:
                      country: US
                      email: user@xsolla.com
                      id: 07e653a2b15011e6818f005056a54369
                      region_id: null
                  - date_created: '2018-01-02T15:32:06+03:00'
                    is_free: false
                    items:
                      - description: null
                        is_bonus: true
                        is_free: true
                        item_id: 1005051
                        order_item_id: 17
                        quantity: 1
                        region_id: null
                        sku: com.xsolla.1005051
                        tax_category: DG00001
                        type: virtual_good
                      - description: null
                        is_bonus: true
                        is_free: true
                        item_id: 1005052
                        order_item_id: 18
                        quantity: 3
                        region_id: null
                        sku: com.xsolla.1005052
                        tax_category: DG00001
                        type: value_point
                    mode: default
                    order_id: 100505
                    price:
                      amount: '78.2300'
                      amount_without_discount: '78.2300'
                      currency: popugi
                      is_virtual_currency: true
                    project_id: 101
                    status: paid
                    user:
                      country: US
                      email: user@xsolla.com
                      id: 07e653a2b15011e6818f005056a54369
                      region_id: null
                total_items_count: 11
          schema:
            properties:
              has_more:
                description: Есть ли дополнительные страницы.
                example: true
                type: boolean
              orders:
                description: Список заказов.
                items:
                  properties:
                    coupons:
                      description: Список купонов, примененных к заказу.
                      items:
                        properties:
                          code:
                            description: >-
                              Используемый код купона. Уникальный код,
                              чувствительный к регистру. Содержит буквы и цифры.
                            type: string
                          coupon_id:
                            description: >-
                              ID купона, сгенерированный на стороне Xsolla при
                              создании акции с купоном.
                            type: integer
                          sku:
                            description: >-
                              Артикул купона, сгенерированный на стороне Xsolla
                              при создании акции с купоном.
                            type: string
                          type:
                            description: Тип купона.
                            enum:
                              - unique_catalog_offer
                              - coupon
                              - promocode
                            type: string
                        type: object
                      nullable: true
                      type: array
                    date_created:
                      description: >-
                        Дата или дата и время создания заказа согласно стандарту
                        [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
                      example: '2020-08-11T10:00:00+03:00'
                      format: date-time
                      type: string
                    invoice_id:
                      description: ID счета.
                      type: string
                    is_free:
                      description: Является ли заказ бесплатным.
                      example: false
                      type: boolean
                    items:
                      description: Список товаров.
                      items:
                        properties:
                          description:
                            description: Объект с информацией о товаре.
                            nullable: true
                            properties:
                              description:
                                description: Описание товара.
                                type: string
                              image_url:
                                description: URL-адрес изображения товара.
                                format: uri
                                type: string
                              name:
                                description: Название товара.
                                type: string
                            type: object
                          is_bonus:
                            description: Является ли товар бонусным.
                            example: false
                            type: boolean
                          is_free:
                            default: false
                            description: Является ли товар бесплатным.
                            example: false
                            type: boolean
                          item_id:
                            description: >-
                              ID товара. Генерируется на стороне Xsolla при
                              создании товара.
                            example: 1
                            type: integer
                          order_item_id:
                            description: >-
                              ID товара в заказе. Генерируется на стороне Xsolla
                              во время создания заказа.
                            type: integer
                          price:
                            description: Цена товара.
                            nullable: true
                            properties:
                              amount:
                                description: Цена товара со скидкой.
                                example: '30'
                                type: string
                              amount_without_discount:
                                description: Цена товара без скидки.
                                example: '30'
                                type: string
                              currency:
                                description: >-
                                  Артикул виртуальной валюты или трехбуквенный
                                  код реальной валюты согласно стандарту [ISO
                                  4217](https://en.wikipedia.org/wiki/ISO_4217).
                                  Список валют, поддерживаемых Xsolla, [приведен
                                  в
                                  документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                                example: USD
                                type: string
                              is_virtual_currency:
                                description: Является ли валюта виртуальной.
                                example: false
                                type: boolean
                            type: object
                          quantity:
                            description: Количество товаров.
                            example: 1
                            type: integer
                          region_id:
                            description: >-
                              ID региона, в котором товар доступен. Подробную
                              информацию о региональных ограничениях продаж
                              читайте в
                              [документации](https://developers.xsolla.com/ru/doc/shop-builder/features/regional-restrictions/).
                            nullable: true
                            type: integer
                          sku:
                            description: >-
                              ID товара, указанный при его создании. Артикул
                              может содержать только строчные и заглавные
                              латинские буквы, цифры, точки, тире и
                              подчеркивания.
                            example: elven_shield
                            type: string
                          tax_category:
                            description: Налоговая категория.
                            example: DG00002
                            type: string
                          type:
                            description: Тип товара.
                            enum:
                              - virtual_good
                              - virtual_currency
                              - bundle
                              - game_key
                              - physical_good
                              - value_point
                            example: virtual_good
                            type: string
                        type: object
                      type: array
                    mode:
                      description: Режим создания заказа.
                      enum:
                        - default
                        - sandbox
                      example: default
                      type: string
                    order_id:
                      description: ID заказа.
                      example: 1
                      type: integer
                    price:
                      description: Стоимость заказа.
                      nullable: true
                      properties:
                        amount:
                          description: Финальная стоимость заказа.
                          example: '30'
                          type: string
                        amount_without_discount:
                          description: Стоимость заказа без учета скидки.
                          example: '30'
                          type: string
                        currency:
                          description: >-
                            Артикул виртуальной валюты или трехбуквенный код
                            реальной валюты согласно стандарту [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                            Список валют, поддерживаемых Xsolla, [приведен в
                            документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                          example: USD
                          type: string
                        is_virtual_currency:
                          description: Является ли валюта виртуальной.
                          example: false
                          type: boolean
                      type: object
                    project_id:
                      description: >-
                        ID проекта. Вы можете найти этот параметр в [Личном
                        кабинете](https://publisher.xsolla.com/) рядом с
                        названием проекта.
                      example: 44056
                      type: integer
                    promotions:
                      description: Список акций, примененных к заказу.
                      items:
                        properties:
                          promotion_id:
                            description: ID акции в рамках проекта.
                            example: 111425
                            type: integer
                        type: object
                      nullable: true
                      type: array
                    status:
                      description: Статус заказа.
                      enum:
                        - new
                        - paid
                        - done
                        - canceled
                        - expired
                      example: paid
                      type: string
                    user:
                      properties:
                        country:
                          description: >-
                            Двухбуквенное обозначение страны в верхнем регистре
                            согласно стандарту [ISO 3166-1
                            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
                            Список стран, поддерживаемых Xsolla, приведен [в
                            документации](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/).
                          example: US
                          type: string
                        email:
                          description: >-
                            Email-адрес пользователя. Должен быть валидным в
                            соответствии с протоколом [ RFC
                            822](https://www.w3.org/Protocols/rfc822/#z8).
                          example: user@xsolla.com
                          format: email
                          type: string
                        id:
                          description: ID пользователя, переданный при создании заказа.
                          example: 07e653a2b15011e6818f005056a54369
                          type: string
                        region_id:
                          description: >-
                            ID региона пользователя. Возвращается, если
                            настроены региональные ограничения продаж. Страна
                            пользователя, переданная при создании заказа,
                            сопоставляется со списком стран, указанных при
                            [создании
                            региона](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-region/).
                            Подробную информацию о региональных ограничениях
                            продаж читайте в
                            [документации](https://developers.xsolla.com/ru/doc/shop-builder/features/regional-restrictions/).
                          example: 12
                          nullable: true
                          type: integer
                      type: object
                  type: object
                type: array
              total_items_count:
                description: Общее количество заказов за указанный период времени.
                example: 1
                type: integer
            type: object
      description: Список заказов успешно получен.
    200-client-get-daily-chains-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-client-daily-chain-list'
          schema:
            properties:
              has_more:
                description: Используется как индикатор того, что остались еще страницы.
                example: true
                type: boolean
              items:
                items:
                  $ref: '#/components/schemas/client-daily-chain-model'
                type: array
              total_items_count:
                description: Общее количество ежедневных наград.
                example: 3
                type: integer
            type: object
      description: Ежедневные награды пользователя были успешно получены.
    200-client-get-offer-chains-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-client-offer-chain-list'
          schema:
            properties:
              has_more:
                description: Показывает, доступны ли другие страницы.
                example: true
                type: boolean
              items:
                items:
                  $ref: '#/components/schemas/client-offer-chain-model'
                type: array
              total_items_count:
                description: Общее количество доступных цепочек предложений.
                example: 10
                type: integer
            type: object
      description: Цепочки предложений пользователя успешно получены.
    200-client-get-reward-chains-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-client-get-reward-chains-list'
          schema:
            properties:
              has_more:
                description: Используется как индикатор того, что остались еще страницы.
                example: true
                type: boolean
              items:
                items:
                  $ref: '#/components/schemas/client-reward-chain-item-model'
                type: array
              total_items_count:
                description: Общее количество цепочек наград в системе.
                example: 10
                type: integer
            type: object
      description: Цепочка наград пользователя была успешно восстановлена.
    200-client-get-user-reward-chain-balance:
      content:
        application/json:
          examples:
            clan:
              $ref: >-
                #/components/examples/200-client-get-user-clan-reward-chain-balance
            common:
              $ref: '#/components/examples/200-client-get-user-reward-chain-balance'
          schema:
            properties:
              amount:
                description: Количество призовых баллов.
                type: integer
              description:
                $ref: '#/components/schemas/value-point-description'
              image_url:
                $ref: '#/components/schemas/Common_admin-image_url'
              is_clan:
                $ref: '#/components/schemas/is_clan'
              long_description:
                $ref: '#/components/schemas/value-point-long-description'
              name:
                $ref: '#/components/schemas/value-point-name'
              sku:
                $ref: '#/components/schemas/value-point-sku'
            type: object
      description: Баланс призовых баллов пользователя был успешно восстановлен.
    200-client-update-user-clan:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/200-client-update-user-clan'
          schema:
            properties:
              reward:
                items:
                  properties:
                    bundle_type:
                      description: Тип бандла. Возвращается, если тип предмета — бандл.
                      enum:
                        - standard
                        - virtual_currency_package
                      type: string
                    description:
                      description: Описание товара.
                      example: Super box with items
                      type: string
                    image_url:
                      $ref: '#/components/schemas/Common_admin-image_url'
                    name:
                      description: Название товара.
                      example: Super box
                      type: string
                    quantity:
                      description: Количество товаров.
                      example: 2
                      type: integer
                    sku:
                      $ref: '#/components/schemas/sku'
                    type:
                      description: Тип товара.
                      example: bundle
                      type: string
                  type: object
                type: array
            type: object
      description: Клан пользователя был успешно обновлен.
    200-items-import-status-model:
      content:
        application/json:
          schema:
            example:
              date_completed: '2024-11-19T15:27:31+03:00'
              date_created: '2024-11-19T14:27:31+03:00'
              date_updated: '2024-11-19T15:27:31+03:00'
              error: null
              error_code: null
              progress: 100
              result:
                errors_by_sku:
                  - error_code: 4055
                    error_message: '[0401-4055]: Item default price not set'
                    sku: com.xsolla.sword_1
                    type: virtual_items
                  - error_code: 1817
                    error_message: '[0410-1817]: SKU can''t be empty'
                    sku: ''
                    type: null
                errors_count: 2
                total_entities_count: 10
              status: error
            properties:
              date_completed:
                description: >-
                  Дата и время завершения операции импорта. Если импорт был
                  прерван из-за ошибки и не было импортировано ни одного товара,
                  будет передана пустая строка.
                example: '2024-12-15T18:16:00+03:00'
                type: string
              date_created:
                description: >-
                  Дата и время создания операции импорта по часовому поясу
                  GMT+3.
                example: '2024-12-15T18:16:00+03:00'
                type: string
              date_updated:
                description: >-
                  Дата и время, когда импорт был прерван из-за возникшей ошибки
                  по часовому поясу GMT+3.
                example: '2024-12-15T18:16:00+03:00'
                type: string
              error:
                description: Описание общей ошибки при импорте.
                type: string
              error_code:
                description: Код общей ошибки при импорте.
                type: string
              progress:
                description: Прогресс выполнения импорта в процентах.
                example: 100
                type: integer
              result:
                description: >-
                  Объект с данными о результатах импорта и ошибках импорта по
                  конкретным товарам.
                properties:
                  errors_by_sku:
                    description: >-
                      Массив объектов с данными об ошибках импорта по конкретным
                      товарам.
                    items:
                      properties:
                        error_code:
                          description: Код ошибки импорта для конкретного артикула товара.
                          example: 1001
                          type: integer
                        error_message:
                          description: >-
                            Описание ошибки импорта для конкретного артикула
                            товара.
                          example: Something went wrong
                          type: string
                        sku:
                          description: Артикул импортируемого товара.
                          example: sku_1
                          type: string
                        type:
                          description: Тип товара.
                          enum:
                            - virtual_good
                            - virtual_currency
                            - virtual_currency_packages
                            - bundle
                          example: vi
                          type: string
                      type: object
                    type: array
                  errors_count:
                    description: Количество товаров, при импорте которых возникли ошибки.
                    example: 3
                    type: integer
                  total_entities_count:
                    description: Общее количество импортируемых товаров.
                    example: 11
                    type: integer
                type: object
              status:
                description: Статус импорта.
                enum:
                  - initialized
                  - process
                  - done
                  - error
                example: error
                type: string
                x-enumDescriptions:
                  done: Импорт успешно завершен.
                  error: >-
                    Из-за ошибок импорт не был выполнен или был выполнен
                    частично.
                  initialized: Импорт запущен.
                  process: Импорт в процессе.
            type: object
      description: Статус импорта успешно получен.
    201-admin-create-attribute:
      content:
        application/json:
          example:
            external_id: genre
          schema:
            properties:
              external_id:
                $ref: '#/components/schemas/admin-attribute-external_id'
            type: object
      description: Атрибут успешно создан.
    201-admin-create-attribute-value:
      content:
        application/json:
          example:
            external_id: rpg
          schema:
            properties:
              external_id:
                $ref: '#/components/schemas/value-external_id'
            type: object
      description: Значение атрибута успешно создано.
    201-admin-create-daily-chain:
      content:
        application/json:
          examples:
            response:
              value:
                daily_chain_id: 10
          schema:
            properties:
              daily_chain_id:
                example: 10
                type: integer
            type: object
      description: Ежедневная награда была успешно создана.
    201-admin-create-offer-chain:
      content:
        application/json:
          examples:
            response:
              value:
                offer_chain_id: 10
          schema:
            properties:
              offer_chain_id:
                example: 10
                type: integer
            type: object
      description: Цепочка предложений успешно создана.
    201-admin-create-region:
      content:
        application/json:
          example:
            region_id: 42
          schema:
            properties:
              region_id:
                $ref: '#/components/schemas/Regions_region_id'
            type: object
      description: Регион успешно создан.
    201-admin-create-reward-chain:
      content:
        application/json:
          examples:
            response:
              value:
                reward_chain_id: 10
          schema:
            properties:
              reward_chain_id:
                example: 10
                type: integer
            type: object
      description: Цепочка наград была успешно создана.
    201-admin-create-value-point:
      content:
        application/json:
          examples:
            response:
              value:
                item_id: 10
                sku: com.xsolla.item_new
          schema:
            properties:
              item_id:
                example: 10
                type: integer
              sku:
                example: new-sku
                type: string
            type: object
      description: Призовые баллы были успешно созданы.
    204-admin-delete-region:
      content: {}
      description: Регион успешно удален.
    204-admin-delete-reward-chain:
      content: {}
      description: Цепочка наград была успешно удалена.
    204-admin-reset-reward-chain:
      content: {}
      description: Цепочка наград сброшена.
    204-admin-toggle-reward-chain:
      content: {}
      description: Цепочка наград была отключена/включена.
    204-admin-update-attribute:
      content: {}
      description: Атрибут успешно обновлен.
    204-admin-update-region:
      content: {}
      description: Регион успешно обновлен.
    204-admin-update-reward-chain:
      content: {}
      description: Цепочка наград была успешно обновлена.
    401-client-auth-error:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1501
                errorMessage: '[0401-1501]: Authorization failed: Provide authorization'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1501
                type: integer
              errorMessage:
                example: '[0401-1501]: Authorization failed: Provide authorization'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: Данные для аутентификации не переданы или ошибочны.
    401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    403-auth-header-not-sent:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 0
                errorMessage: Authorization header not sent
                statusCode: 403
          schema:
            properties:
              errorCode:
                example: 0
                type: integer
              errorMessage:
                example: Authorization header not sent.
                type: string
              statusCode:
                example: 403
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Заголовок Authorization не отправлен.
    404-admin-reward-chain-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9901
                errorMessage: '[0401-4001]: Reward chain not found'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-4001]: Reward chain not found'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Цепочка наград не найдена.
    404-attribute-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9901
                errorMessage: '[0401-9901]: Attribute not found.'
                statusCode: 404
                transactionId: x-x-x-x-transactionId-mock-x-x-x
          schema:
            properties:
              errorCode:
                example: 9901
                type: integer
              errorMessage:
                example: '[0401-9901]: Attribute not found.'
                type: string
              statusCode:
                example: 404
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Атрибут не найден.
    404-attribute-value-not-found:
      content:
        application/json:
          examples:
            Attribue value not found:
              $ref: '#/components/examples/404-attribute-value-not-found'
            Attribute not found:
              $ref: '#/components/examples/404-attribute-not-found'
          schema:
            $ref: '#/components/schemas/404-not-found'
      description: Значение атрибута не найдено.
    404-code-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9811
                errorMessage: '[0401-9811]: Code not found.'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 9811
                type: integer
              errorMessage:
                example: '[0401-9811]: Code not found.'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: >-
        Код не найден. Убедитесь, что указанное значение кода является
        правильным.
    404-daily-chain-not-found:
      content:
        application/json:
          examples:
            not-found:
              $ref: '#/components/examples/404-daily-chain-not-found'
          schema:
            $ref: '#/components/schemas/daily-chain-error-model'
      description: Ежедневная награда не найдена.
    404-daily-chain-step-not-found:
      content:
        application/json:
          examples:
            not-found:
              $ref: '#/components/examples/404-daily-chain-step-not-found'
          schema:
            $ref: '#/components/schemas/daily-chain-error-model'
      description: Ежедневная награда или уровень ежедневной награды не найдены.
    404-offer-chain-not-found:
      content:
        application/json:
          examples:
            not-found:
              $ref: '#/components/examples/404-offer-chain-not-found'
          schema:
            $ref: '#/components/schemas/offer-chain-error-model'
      description: Цепочка предложений не найдена.
    404-offer-chain-step-not-found:
      content:
        application/json:
          examples:
            not-found:
              $ref: '#/components/examples/404-offer-chain-step-not-found'
          schema:
            $ref: '#/components/schemas/offer-chain-error-model'
      description: Цепочка предложений или уровень не найдены.
    404-region-not-found:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 9701
                type: integer
              errorMessage:
                example: '[0401-9701]: Region not found'
                type: string
              statusCode:
                example: 404
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Регион не найден. Убедитесь, что верно указали `id`.
    404-reward-chain-step-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9911
                errorMessage: '[0401-9911]: Reward chain step not found.'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 9911
                type: integer
              errorMessage:
                example: '[0401-9911]: Reward chain step not found.'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Уровень цепочки наград не найден.
    405-method-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 0
                errorMessage: 'Method is not allowed. Method must be one of: OPTIONS'
                statusCode: 405
          schema:
            properties:
              errorCode:
                example: 0
                type: integer
              errorMessage:
                example: 'Method is not allowed. Method must be one of: OPTIONS'
                type: string
              statusCode:
                example: 405
                type: integer
            type: object
      description: Неправильный формат кода. Код может содержать только буквы и цифры.
    422-admin-create-error-list:
      content:
        application/json:
          examples:
            incorrect-items:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-items
            incorrect-period:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-period
            incorrect-steps-order-error:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-steps-order
            invalid-dates:
              $ref: '#/components/examples/422-admin-daily-chain-error-invalid-dates'
            item-limit-exceeded:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-item-limit-exceeded
            too-many-steps-error:
              $ref: '#/components/examples/422-admin-daily-chain-error-too-many-steps'
          schema:
            $ref: '#/components/schemas/daily-chain-error-model'
      description: Ошибки в настройках ежедневных наград.
    422-admin-create-update-rc-vp-invalid-request:
      content:
        application/json:
          examples:
            The property `sku` is required:
              $ref: '#/components/examples/422-property-sku-is-required'
          schema:
            $ref: '#/components/schemas/422-rc-vp-invalid-request'
      description: Неверный запрос.
    422-admin-update-error-list:
      content:
        application/json:
          examples:
            active-daily-chain:
              $ref: '#/components/examples/422-admin-daily-chain-error-activated'
            chain-id-mismatch:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-chain-id-mismatch
            chain-step-ids-duplication:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-duplicate-step-ids
            incorrect-items:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-items
            incorrect-period:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-period
            incorrect-steps-order-error:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-incorrect-steps-order
            invalid-chain-step-ids:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-invalid-chain-step-ids
            invalid-dates:
              $ref: '#/components/examples/422-admin-daily-chain-error-invalid-dates'
            item-limit-exceeded:
              $ref: >-
                #/components/examples/422-admin-daily-chain-error-item-limit-exceeded
            too-many-steps-error:
              $ref: '#/components/examples/422-admin-daily-chain-error-too-many-steps'
          schema:
            $ref: '#/components/schemas/daily-chain-error-model'
      description: Ошибки в настройках ежедневных наград.
    422-create-error-list:
      content:
        application/json:
          examples:
            incorrect-items:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-items
            incorrect-period:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-period
            incorrect-steps-order-error:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-steps-order
            invalid-dates:
              $ref: '#/components/examples/422-admin-offer-chain-error-invalid-dates'
            item-limit-exceeded:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-item-limit-exceeded
            too-many-steps-error:
              $ref: '#/components/examples/422-admin-offer-chain-error-too-many-steps'
          schema:
            $ref: '#/components/schemas/offer-chain-error-model'
      description: Некорректная конфигурация цепочки предложений.
    422-create-update-attribute-value:
      content:
        application/json:
          examples:
            external_id is duplicate:
              $ref: '#/components/examples/422-external-id-duplicate'
            external_id is invalid:
              $ref: '#/components/examples/422-external-id-invalid'
            external_id is required:
              $ref: '#/components/examples/422-external-id-required'
            value is required:
              $ref: '#/components/examples/422-value-invalid'
            value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
            value properties minimum length:
              $ref: '#/components/examples/422-value-properties-required'
          schema:
            $ref: '#/components/schemas/schemas-422-invalid-request'
      description: Неверный запрос.
    422-reward-chain-step-reward-can-not-claimed:
      content:
        application/json:
          examples:
            Not enough VP to claim reward chain step reward:
              value:
                errorCode: 9913
                errorMessage: '[0401-9913]: Not enough value points to claim step reward.'
                statusCode: 422
            Reward chain step reward already claimed:
              value:
                errorCode: 9912
                errorMessage: '[0401-9912]: Reward already claimed.'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 9912
                type: integer
              errorMessage:
                example: '[0401-9912]: Can''t claim the step reward.'
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: Невозможно получить награду на уровне цепочки наград.
    422-update-error-list:
      content:
        application/json:
          examples:
            active-offer-chain:
              $ref: '#/components/examples/422-admin-offer-chain-error-activated'
            chain-id-mismatch:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-chain-id-mismatch
            chain-step-ids-duplication:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-duplicate-step-ids
            incorrect-items:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-items
            incorrect-period:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-period
            incorrect-steps-order-error:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-incorrect-steps-order
            invalid-chain-step-ids:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-invalid-chain-step-ids
            invalid-dates:
              $ref: '#/components/examples/422-admin-offer-chain-error-invalid-dates'
            item-limit-exceeded:
              $ref: >-
                #/components/examples/422-admin-offer-chain-error-item-limit-exceeded
            too-many-steps-error:
              $ref: '#/components/examples/422-admin-offer-chain-error-too-many-steps'
          schema:
            $ref: '#/components/schemas/offer-chain-error-model'
      description: Некорректная конфигурация цепочки предложений.
    422-validation-failed:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `external_id`
                  is required
                statusCode: 422
          schema:
            $ref: '#/components/schemas/schemas-422-invalid-request'
      description: Неверный запрос.
    Bundles_200-admin-get-bundle:
      content:
        application/json:
          example:
            attributes: []
            bundle_type: standard
            content:
              - description:
                  en: Opens ONE Empire lootbox of any kind
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                name:
                  en: Empire Key
                quantity: 5
                sku: com.xsolla.keys_2
                type: virtual_good
              - description:
                  en: >-
                    Take it, take it all! All of the Empires riches in one Mega
                    Booster.
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                name:
                  en: Empire Booster Mega
                quantity: 1
                sku: com.xsolla.booster_mega_2
                type: virtual_good
              - description:
                  en: Test your luck to find glorious treasures from Empire's past
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                name:
                  en: Empire Booster Mini
                quantity: 3
                sku: com.xsolla.booster_min_2
                type: virtual_good
            custom_attributes:
              purchased: 0
              type: lootbox
            description:
              en: Empire bundle with items
            groups:
              - external_id: all
                name:
                  en: Equipment
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
            is_enabled: true
            is_free: false
            is_show_in_store: true
            item_id: 610316
            limits:
              per_item: null
              per_user:
                limit_exceeded_visibility: show
                total: 10
              recurrent_schedule: null
            long_description:
              en: Empire bundle with some goods
            media_list: []
            name:
              en: Empire bundle
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices: []
            regions: []
            sku: com.xsolla.EmpireBundle_1
            type: bundle
            virtual_prices:
              - amount: '150'
                description:
                  en: Main in-game currency
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                is_default: true
                name:
                  en: Crystals
                  ru: Crystals
                sku: com.xsolla.crystal_1
                type: virtual_currency
          schema:
            $ref: '#/components/schemas/Bundles_admin_bundle_response'
      description: Указанный бандл успешно получен.
    Bundles_200-admin-get-bundle-list:
      content:
        application/json:
          example:
            items:
              - attributes: []
                bundle_type: standard
                content:
                  - description:
                      en: >-
                        Test your luck to find glorious treasures from the past
                        in an Xsolla Booster Mini.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5ee252b292a560930c8f7e2c791dfc6d.png
                    name:
                      en: Xsolla Booster Mini
                    quantity: 2
                    sku: com.xsolla.booster_min_1
                    type: virtual_good
                  - description:
                      en: >-
                        Get high-quality, competitively priced gas with Booster.
                        Download the app for free same-day delivery. Kick the
                        gas station habit for good.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e76d317ee5a8d06a4b730bcf23746e9e.png
                    name:
                      en: Booster
                    quantity: 15
                    sku: com.xsolla.booster_min_2
                    type: virtual_good
                  - description:
                      en: >-
                        Enjoy a range of outdoor activities with gloves from EK
                        Sporting Goods.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/93a7ee3ae284b677d3dc1f2e989731cb.png
                    name:
                      en: Xsolla Gloves
                    quantity: 3
                    sku: com.xsolla.gloves_1
                    type: virtual_good
                  - description:
                      en: Stylishly protect your toes with the accent of Xsolla
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/6e33d40df3cdac152dac9ac3d1f5986e.png
                    name:
                      en: Xsolla Boots
                    quantity: 2
                    sku: com.xsolla.boots_1
                    type: virtual_good
                  - description:
                      en: >-
                        The M134 Minigun is a 7.62×51mm NATO, six-barrel rotary
                        machine gun with a high rate of fire (2,000 to 6,000
                        rounds per minute)
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/3093eeb39d5ec7def3af6396607a30ba.png
                    name:
                      en: Xsolla Gun
                    quantity: 10
                    sku: com.xsolla.gun_max
                    type: virtual_good
                  - description:
                      en: Just hold down the trigger and pray to the Empire
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/dabfa4567cd2d82e0562d4b0f448b436.png
                    name:
                      en: Empire Minigun
                    quantity: 3
                    sku: com.xsolla.minigun_2
                    type: virtual_good
                custom_attributes:
                  purchased: 0
                  type: lootbox
                description:
                  en: Ultra Super Lootbox with items
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/779d2588a5b3cf348133fa7d5755cec8.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                item_id: 610316
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    limit_exceeded_visibility: show
                    total: 10
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-03-01T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677639600
                      time: 11:00:00+08:00
                long_description:
                  en: Ultra Super lootbox with different items
                media_list: []
                name:
                  en: Ultra Super Lootbox Bundle
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: '150.49'
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.UltraSuperLootboxBundle_1
                type: bundle
                virtual_prices: []
              - attributes: []
                bundle_type: standard
                content:
                  - description:
                      en: Opens ONE Empire lootbox of any kind
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                    name:
                      en: Empire Key
                    quantity: 5
                    sku: com.xsolla.keys_2
                    type: virtual_good
                  - description:
                      en: >-
                        Take it, take it all! All of the Empires riches in one
                        Mega Booster.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                    name:
                      en: Empire Booster Mega
                    quantity: 1
                    sku: com.xsolla.booster_mega_2
                    type: virtual_good
                  - description:
                      en: >-
                        Test your luck to find glorious treasures from Empire's
                        past
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                    name:
                      en: Empire Booster Mini
                    quantity: 3
                    sku: com.xsolla.booster_min_2
                    type: virtual_good
                description:
                  en: Empire bundle with items
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                item_id: 610317
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description:
                  en: Empire bundle with some goods
                media_list: []
                name:
                  en: Empire bundle
                order: 1
                periods: []
                prices: []
                regions: []
                sku: com.xsolla.EmpireBundle_1
                type: bundle
                virtual_prices:
                  - amount: '150'
                    description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    is_default: true
                    name:
                      en: Crystals
                      ru: Crystals
                    sku: com.xsolla.crystal_1
                    type: virtual_currency
          schema:
            description: Объект с товарами.
            properties:
              items:
                items:
                  $ref: '#/components/schemas/Bundles_admin_bundle_response'
                type: array
            type: object
      description: Список бандлов успешно получен.
    Bundles_200-admin-get-bundle-list-in-group:
      content:
        application/json:
          example:
            items:
              - attributes: []
                bundle_type: standard
                content:
                  - description:
                      en: >-
                        Test your luck to find glorious treasures from the past
                        in an Xsolla Booster Mini.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5ee252b292a560930c8f7e2c791dfc6d.png
                    name:
                      en: Xsolla Booster Mini
                    quantity: 2
                    sku: com.xsolla.booster_min_1
                    type: virtual_good
                  - description:
                      en: >-
                        Get high-quality, competitively priced gas with Booster.
                        Download the app for free same-day delivery. Kick the
                        gas station habit for good.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e76d317ee5a8d06a4b730bcf23746e9e.png
                    name:
                      en: Booster
                    quantity: 15
                    sku: com.xsolla.booster_min_2
                    type: virtual_good
                  - description:
                      en: >-
                        Enjoy a range of outdoor activities with gloves from EK
                        Sporting Goods.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/93a7ee3ae284b677d3dc1f2e989731cb.png
                    name:
                      en: Xsolla Gloves
                    quantity: 3
                    sku: com.xsolla.gloves_1
                    type: virtual_good
                  - description:
                      en: Stylishly protect your toes with the accent of Xsolla
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/6e33d40df3cdac152dac9ac3d1f5986e.png
                    name:
                      en: Xsolla Boots
                    quantity: 2
                    sku: com.xsolla.boots_1
                    type: virtual_good
                  - description:
                      en: >-
                        The M134 Minigun is a 7.62×51mm NATO, six-barrel rotary
                        machine gun with a high rate of fire (2,000 to 6,000
                        rounds per minute)
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/3093eeb39d5ec7def3af6396607a30ba.png
                    name:
                      en: Xsolla Gun
                    quantity: 10
                    sku: com.xsolla.gun_max
                    type: virtual_good
                  - description:
                      en: Just hold down the trigger and pray to the Empire
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/dabfa4567cd2d82e0562d4b0f448b436.png
                    name:
                      en: Empire Minigun
                    quantity: 3
                    sku: com.xsolla.minigun_2
                    type: virtual_good
                custom_attributes:
                  purchased: 0
                  type: lootbox
                description:
                  en: Ultra Super Lootbox with items
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/779d2588a5b3cf348133fa7d5755cec8.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                item_id: 610316
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    limit_exceeded_visibility: show
                    total: 10
                  recurrent_schedule:
                    per_user:
                      day_of_week: 2
                      displayable_reset_next_date: '2023-03-07T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: weekly
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description:
                  en: Ultra Super lootbox with different items
                media_list: []
                name:
                  en: Ultra Super Lootbox Bundle
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: '150.49'
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.UltraSuperLootboxBundle_1
                type: bundle
                virtual_prices: []
              - attributes: []
                bundle_type: standard
                content:
                  - description:
                      en: Opens ONE Empire lootbox of any kind
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5c2f8536f08a9949964e4fa2e01a7cb8.png
                    name:
                      en: Empire Key
                    quantity: 5
                    sku: com.xsolla.keys_2
                    type: virtual_good
                  - description:
                      en: >-
                        Take it, take it all! All of the Empires riches in one
                        Mega Booster.
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/55e908cb9670301ac8f89a6382433a27.png
                    name:
                      en: Empire Booster Mega
                    quantity: 1
                    sku: com.xsolla.booster_mega_2
                    type: virtual_good
                  - description:
                      en: >-
                        Test your luck to find glorious treasures from Empire's
                        past
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/5bcecec17400a0d8c72dd265ff730b07.png
                    name:
                      en: Empire Booster Mini
                    quantity: 3
                    sku: com.xsolla.booster_min_2
                    type: virtual_good
                description:
                  en: Empire bundle with items
                groups:
                  - external_id: all
                    name:
                      en: Equipment
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/685b21f9d9dca4aa0c953e8816b4eb4b.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                item_id: 610317
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description:
                  en: Empire bundle with some goods
                media_list: []
                name:
                  en: Empire bundle
                order: 1
                periods: []
                prices: []
                regions: []
                sku: com.xsolla.EmpireBundle_1
                type: bundle
                virtual_prices:
                  - amount: '150'
                    description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    is_default: true
                    name:
                      en: Crystals
                      ru: Crystals
                    sku: com.xsolla.crystal_1
                    type: virtual_currency
          schema:
            description: Объект с товарами.
            properties:
              items:
                items:
                  $ref: '#/components/schemas/Bundles_admin_bundle_response'
                type: array
            type: object
      description: Список бандлов успешно получен.
    Bundles_200-get-bundle-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Bundles_200-get-bundle-list'
          schema:
            description: Объект с товарами.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                items:
                  $ref: '#/components/schemas/Bundles_client_bundle'
                type: array
            type: object
      description: Список бандлов успешно получен.
    Bundles_201-admin-create-bundle:
      content:
        application/json:
          examples:
            response:
              value:
                sku: com.xsolla.kg_1
          schema:
            properties:
              sku:
                $ref: '#/components/schemas/Bundles_sku'
            type: object
      description: Бандл успешно создан.
    Bundles_204-admin-delete-bundle:
      content: {}
      description: Бандл успешно удален.
    Bundles_204-admin-hide-bundle:
      content: {}
      description: Бандл успешно скрыт.
    Bundles_204-admin-show-bundle:
      content: {}
      description: Бандл успешно отображен.
    Bundles_204-admin-update-bundle:
      content: {}
      description: Бандл успешно обновлен.
    Bundles_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Bundles_422-invalid-request:
      content:
        application/json:
          examples:
            Custom attributes JSON can’t exceed 500 characters:
              $ref: '#/components/examples/422-custom-attributes-size-exceeded'
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            The property `sku` is required:
              $ref: '#/components/examples/422-property-sku-is-required'
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
          schema:
            $ref: '#/components/schemas/Bundles_422-invalid-request'
      description: Неверный запрос.
    Cart-Free_200-order-created:
      content:
        application/json:
          examples:
            response:
              value:
                order_id: 641
          schema:
            properties:
              order_id:
                description: ID заказа.
                type: integer
            type: object
      description: Бесплатный заказ успешно создан.
    Cart-Payment_200-admin-fill-cart-json-model:
      content:
        application/json:
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    can_be_bought: true
                    description: The cup of tea
                    groups:
                      - external_id: cups
                        name: Cups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_bonus: false
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Cup
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    promotions: []
                    quantity: 2
                    sku: com.xsolla.cup01
                    type: physical_good
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes: []
                    can_be_bought: true
                    description: Wonderful white T-shirt
                    groups: []
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_bonus: false
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: White T-shirt
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '3.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 1
                    sku: com.xsolla.t-shirt01
                    type: physical_good
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes: []
                    can_be_bought: true
                    description: Wonderful white T-shirt
                    groups:
                      - external_id: clothes
                        name: Clothes
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_bonus: false
                    is_free: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Cat's cup
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price: null
                    promotions: []
                    quantity: 1
                    sku: com.xsolla.cup01
                    type: physical_good
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                price:
                  amount: '15.97'
                  amount_without_discount: '22.96'
                  currency: USD
                promotions:
                  - bonus:
                      - image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        name: Xsolla Minigun
                        quantity: 1
                        sku: com.xsolla.minigun_1
                        type: virtual_good
                    date_end: '2026-04-15T16:16:00+03:00'
                    date_start: '2020-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    name: Bonus promotion
                warnings:
                  - errorCode: 4001
                    errorMessage: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku = hut01
                      not found
                    quantity: 1
                    sku: com.xsolla.hat01
          schema:
            properties:
              cart_id:
                description: >-
                  ID корзины. Передается в виде параметра запроса к
                  прокси-странице или в виде параметра пути в API методах
                  оплаты.
                example: cart_id
                type: string
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_bonus:
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      nullable: true
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    price:
                      description: Цена товара.
                      nullable: true
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    virtual_prices:
                      $ref: '#/components/schemas/Bundles_virtual_prices'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
              price:
                description: Цена корзины.
                nullable: true
                properties:
                  amount:
                    type: string
                  amount_without_discount:
                    type: string
                  currency:
                    type: string
                type: object
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
              warnings:
                items:
                  properties:
                    errorCode:
                      type: integer
                    errorMessage:
                      type: string
                    quantity:
                      type: integer
                    sku:
                      type: string
                  type: object
                type: array
            type: object
      description: Корзина с товарами успешно возвращена.
    Cart-Payment_200-fill-cart-json-model:
      content:
        application/json:
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Take it, take it all! All of Xsollas riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_bonus: false
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Xsolla Booster Mega
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                promotions:
                  - bonus:
                      - image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        name: Xsolla Minigun
                        quantity: 1
                        sku: com.xsolla.minigun_1
                        type: virtual_good
                    date_end: '2026-04-15T16:16:00+03:00'
                    date_start: '2020-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    name: Bonus promotion
                warnings:
                  - errorCode: 4001
                    errorMessage: >-
                      [0401-4001]: Item with Project Id = 44056 and Sku =
                      booster_mega_2 not found
                    quantity: 1
                    sku: com.xsolla.booster_mega_21
          schema:
            properties:
              cart_id:
                description: ID корзины.
                example: cart_id
                type: string
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_bonus:
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      nullable: true
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    price:
                      description: Цена товара.
                      example:
                        amount: '6150.0000000000000000'
                        amount_without_discount: '6150.0000000000000000'
                        currency: USD
                      nullable: true
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    virtual_item_type:
                      description: Тип товара.
                      type: string
                    virtual_prices:
                      $ref: '#/components/schemas/Bundles_virtual_prices'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
              price:
                description: Цена корзины.
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                nullable: true
                properties:
                  amount:
                    default: '50.0000000000000000'
                    type: string
                  amount_without_discount:
                    default: '100.0000000000000000'
                    type: string
                  currency:
                    default: USD
                    type: string
                type: object
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
              warnings:
                items:
                  properties:
                    errorCode:
                      type: integer
                    errorMessage:
                      type: string
                    quantity:
                      type: integer
                    sku:
                      type: string
                  type: object
                type: array
            type: object
      description: Корзина с товарами успешно возвращена.
    Cart-Payment_200-get-cart-json-model:
      content:
        application/json:
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Take it, take it all! All of Xsollas riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_bonus: false
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Xsolla Booster Mega
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions: []
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                promotions:
                  - bonus:
                      - image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        name: Xsolla Minigun
                        quantity: 1
                        sku: com.xsolla.minigun_1
                        type: virtual_good
                    date_end: '2026-04-15T16:16:00+03:00'
                    date_start: '2020-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    name: Bonus promotion
          schema:
            properties:
              cart_id:
                description: ID корзины.
                example: cart_id
                type: string
              is_free:
                $ref: '#/components/schemas/value-cart_is_free'
              items:
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Cart-Payment_client-attributes'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_bonus:
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      nullable: true
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    price:
                      description: Цена товара.
                      example:
                        amount: '6150.0000000000000000'
                        amount_without_discount: '6150.0000000000000000'
                        currency: USD
                      nullable: true
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                        currency:
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    virtual_item_type:
                      description: Тип товара.
                      type: string
                    virtual_prices:
                      $ref: '#/components/schemas/Bundles_virtual_prices'
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
              price:
                description: Цена корзины.
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                nullable: true
                properties:
                  amount:
                    default: '50.0000000000000000'
                    type: string
                  amount_without_discount:
                    default: '100.0000000000000000'
                    type: string
                  currency:
                    default: USD
                    type: string
                type: object
              promotions:
                $ref: '#/components/schemas/Catalog_cart_promotions'
            type: object
      description: Корзина с товарами успешно возвращена.
    Cart-Payment_200-get-order:
      content:
        application/json:
          examples:
            response:
              value:
                content:
                  is_free: false
                  items:
                    - is_free: false
                      price:
                        amount: '30'
                        amount_without_discount: '30'
                        currency: USD
                      quantity: 1
                      sku: com.xsolla.item_1
                  price:
                    amount: '30'
                    amount_without_discount: '30'
                    currency: USD
                order_id: 1
                status: paid
          schema:
            properties:
              content:
                description: Детали заказа.
                properties:
                  is_free:
                    description: Если `true`, заказ бесплатный.
                    example: false
                    type: boolean
                  items:
                    description: Список товаров.
                    example:
                      - is_free: false
                        price:
                          amount: '30'
                          amount_without_discount: '30'
                          currency: USD
                        quantity: 1
                        sku: com.xsolla.item_1
                    items:
                      properties:
                        is_free:
                          $ref: '#/components/schemas/value-is_free'
                        price:
                          description: Цена товара.
                          properties:
                            amount:
                              description: Цена товара со скидкой.
                              example: '30'
                              type: string
                            amount_without_discount:
                              description: Цена товара.
                              example: '30'
                              type: string
                            currency:
                              description: >-
                                Валюта, в которой указана цена товара.
                                Трехбуквенный код в соответствии со стандартом
                                [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217).
                              example: USD
                              type: string
                          type: object
                        quantity:
                          description: Количество товаров.
                          example: 1
                          type: integer
                        sku:
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          example: some_sku
                          type: string
                      type: object
                    type: array
                  price:
                    description: Стоимость заказа.
                    properties:
                      amount:
                        description: Цена заказа со скидкой.
                        example: '30'
                        type: string
                      amount_without_discount:
                        description: Стоимость заказа.
                        example: '30'
                        type: string
                      currency:
                        description: >-
                          Валюта, в которой указана стоимость заказа.
                          Трехбуквенный код в соответствии со стандартом [ISO
                          4217](https://en.wikipedia.org/wiki/ISO_4217).
                        example: USD
                        type: string
                    type: object
                  virtual_price:
                    description: Цена заказа в виртуальной валюте.
                    properties:
                      amount:
                        description: Цена заказа со скидкой.
                        example: '100'
                        type: string
                      amount_without_discount:
                        description: Стоимость заказа.
                        example: '150'
                        type: string
                      currency:
                        description: Артикул виртуальной валюты, используемый в заказе.
                        example: test_vc
                        type: string
                    type: object
                type: object
              order_id:
                default: Order ID.
                description: ID заказа.
                example: 1
                type: integer
              status:
                description: 'Статус заказа: `new`/`paid`/`done`/`canceled`.'
                example: paid
                type: string
            type: object
      description: Успешный запрос заказа.
    Cart-Payment_200-order-created:
      content:
        application/json:
          examples:
            response:
              value:
                order_id: 641
                token: f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo
          schema:
            properties:
              order_id:
                description: ID заказа.
                type: integer
              token:
                description: Платежный токен.
                type: string
            type: object
      description: Заказ успешно создан.
    Cart-Payment_201-admin-create-payment-token:
      content:
        application/json:
          examples:
            response:
              value:
                order_id: 12345
                token: huooAqbXBSJxB8Q4dYBqJp4ybiInqsPb
          schema:
            properties:
              order_id:
                description: ID заказа.
                example: 1
                type: integer
              token:
                description: Платежный токен.
                type: string
            type: object
      description: Платежный токен и заказ успешно созданны.
    Cart-Payment_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Cart-Payment_404-create-order-with-item-not-found-errors:
      content:
        application/json:
          examples:
            coupon not found:
              $ref: '#/components/examples/404-coupon-not-found'
            item not found:
              $ref: '#/components/examples/404-item-by-sku-not-found'
          schema:
            properties:
              errorCode:
                type: integer
              errorMessage:
                type: string
              statusCode:
                type: integer
              transactionId:
                type: string
            type: object
      description: Товар или купон не найден. Убедитесь, что используемые данные верны.
    Cart-Payment_404-get-order:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9001
                errorMessage: '[0401-9001]: Order not found'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 9001
                type: integer
              errorMessage:
                example: '[0401-9001]: Order not found'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Заказ не найден. Убедитесь, что верно указали `project_id` и `order_id`.
    Cart-Payment_404-item:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: >-
                  [0401-4001]: Item with Project Id = 44056 and Sku =
                  booster_mega_12222 not found
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Товар не найден. Убедитесь, что верно указали `project_id` и `item_sku`.
    Cart-Payment_404-user:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 5008
                type: integer
              errorMessage:
                example: '[0401-5008]: Could not find User'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: >-
        Пользователь не найден. Убедитесь, что верно указали токен `x-user-for`
        или `x-user-id`.
    Cart-Payment_422-admin-create-payment-token:
      content:
        application/json:
          examples:
            Empty cart:
              value:
                errorCode: 1417
                errorMessage: '[0401-1417]: Empty cart! Cart shouldn''t be empty!'
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
            Invalid cart:
              value:
                errorCode: 1401
                errorMessage: '[0401-1401]: Invalid cart'
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
            Invalid request body:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `name` is
                  required
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
            Item is free:
              value:
                errorCode: 1421
                errorMessage: '[0401-1421]: Item is free'
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
            User country not provided:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: The parameter user.country.value or the header
                  X-User-Ip must be specified
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
          schema:
            $ref: '#/components/schemas/422-invalid-request'
      description: |-
        Ошибка в теле запроса или на этапе создания корзины.
         - Нельзя наполнить корзину переданными товарами. Проверяет, что корзина не пуста и что все товары не бесплатны.
         - Неверное тело запроса.
    Cart-Payment_422-can-put-only-virtual-good-to-cart:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1421
                errorMessage: Only Virtual Good Supported
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1421
                type: integer
              errorMessage:
                example: >-
                  This type of item cannot be put to the cart. Select another
                  type of item.
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: >-
        Этот тип товара не может быть помещен в корзину. Выберите другой тип
        товара.
    Cart-Payment_422-create-order-with-item-invalid:
      content:
        application/json:
          examples:
            code expired:
              value:
                errorCode: 9810
                errorMessage: '[0401-9810]: Sorry, this code is expired.'
                statusCode: 422
            code redemption limit:
              value:
                errorCode: 9804
                errorMessage: '[0401-9804]: You have reached the coupon redemption limit.'
                statusCode: 422
            invalid item:
              value:
                errorCode: 1411
                errorMessage: '[0401-1411]: Invalid item'
                statusCode: 422
            regionally restricted:
              value:
                errorCode: 9808
                errorMessage: '[0401-9808]: Coupon is not available in your region.'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1411
                type: integer
              errorMessage:
                example: '[0401-1411]: Invalid item'
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: Недопустимая ошибка.
    Cart-Payment_422-invalid-cart:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1401
                errorMessage: '[0401-1401]: Invalid cart'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1401
                type: integer
              errorMessage:
                example: '[0401-1401]: Invalid cart'
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: >-
        Недействительная корзина. Убедитесь, что корзина существует, не пуста и
        все товары в ней не бесплатны.
    Cart-Payment_422-invalid-item:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1411
                errorMessage: '[0401-1411]: Invalid item'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1411
                type: integer
              errorMessage:
                example: '[0401-1411]: Invalid item'
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: >-
        Недействительный товар. Проверьте, что товар существует, не отключен, не
        удален и не бесплатен.
    Cart-Payment_422-non-negative-quantity:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: '[0401-1102]: Item quantity must be non-negative integer'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: Item quantity must be non-negative integer.
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: Количество товара должно быть неотрицательным целым числом.
    Common_401-complex:
      content:
        application/json:
          examples:
            Authorization header not sent:
              $ref: '#/components/examples/401-complex-auth-header-not-found'
            Incorrect credentials:
              $ref: '#/components/examples/401-complex-auth-incorrect-credentials'
          schema:
            properties:
              errorCode:
                example: 1501
                type: integer
              errorMessage:
                example: >-
                  [0401-1501]: Authorization failed: Authorization header not
                  sent
                type: string
              statusCode:
                example: 401
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: >-
        Данные для аутентификации не переданы или ошибочны. Убедитесь, что
        использовали аутентификацию и проверьте правильность учетных данных.
    Common_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Common_422-body-validation:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `name` is
                  required
                statusCode: 422
                transactionId: da145238620011eb8e24fe6913ff226a
          schema:
            $ref: '#/components/schemas/422-invalid-request'
      description: Ошибка валидации запроса.
    Game-Keys_200-admin-get-game-by-sku:
      content:
        application/json:
          examples:
            response:
              value:
                attributes:
                  - external_id: platform
                    name:
                      en-US: Platform
                    values:
                      - external_id: >-
                          platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                        value:
                          de-DE: Windows, Linux
                          en-US: Windows, Linux
                description:
                  en: Example game 1
                groups:
                  - external_id: horror
                    name:
                      en: Horror
                image_url: https://image.example.com
                is_enabled: true
                is_free: false
                is_show_in_store: false
                item_id: 1
                long_description:
                  en: Example game's long description
                media_list:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                name:
                  en: Game 1
                order: 1
                sku: com.xsolla.game_1
                type: unit
                unit_items:
                  - drm_id: 1
                    drm_image: >-
                      https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                    drm_name: Steam
                    drm_sku: steam_key_1
                    is_enabled: true
                    is_free: false
                    is_sales_exist: false
                    is_show_in_store: false
                    item_id: 3
                    keys:
                      available: 3
                      total: 4
                      used: 1
                    limits:
                      per_item:
                        available: 5000
                        reserved: 500
                        sold: 4500
                        total: 10000
                      per_user:
                        limit_exceeded_visibility: show
                        total: 5
                      recurrent_schedule:
                        per_user:
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    order: 1
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    pre_order:
                      description: null
                      is_enabled: false
                      release_date: null
                    prices:
                      - amount: 1199.99
                        country_iso: RU
                        currency: RUB
                        is_default: true
                        is_enabled: true
                    sku: com.xsolla.game_1_key_1
                    type: game_key
                    virtual_prices: []
                  - drm_id: 8
                    drm_image: null
                    drm_name: Epic Games Store
                    drm_sku: epicgames_key_1
                    is_enabled: true
                    is_free: false
                    is_sales_exist: false
                    is_show_in_store: false
                    item_id: 4
                    keys:
                      available: 0
                      total: 0
                      used: 0
                    limits:
                      per_item: null
                      per_user: null
                      recurrent_schedule: null
                    order: 1
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    pre_order:
                      description: null
                      is_enabled: true
                      release_date: '2020-08-11T10:00:00+03:00'
                    prices:
                      - amount: 1299.99
                        country_iso: RU
                        currency: RUB
                        is_default: true
                        is_enabled: true
                    regions:
                      - id: 12
                      - id: 64
                    sku: com.xsolla.game_1_key_2
                    type: game_key
                    virtual_prices: null
          schema:
            description: Объект с информацией об игре.
            properties:
              attributes:
                $ref: '#/components/schemas/Game-Keys_admin-attributes'
              description:
                $ref: '#/components/schemas/description-localization-object'
              groups:
                description: Группы, к которым принадлежит товар.
                example:
                  - external_id: horror
                    name:
                      en: Horror
                items:
                  properties:
                    external_id:
                      example: horror
                      type: string
                    name:
                      example:
                        en: Horror
                      type: object
                  type: object
                type: array
              image_url:
                description: URL-адрес изображения.
                example: https://image.example.com
                type: string
              is_enabled:
                type: boolean
              is_free:
                $ref: '#/components/schemas/value-is_free'
              is_show_in_store:
                type: boolean
              item_id:
                description: >-
                  Внутренний уникальный ID товара, который задается при создании
                  товара.
                example: 1
                type: integer
              long_description:
                $ref: '#/components/schemas/long-description-localization-object'
              media_list:
                description: >-
                  Дополнительные ассеты игры, такие как скриншоты, видео
                  игрового процесса и так далее.
                example:
                  - type: image
                    url: >-
                      https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                items:
                  properties:
                    type:
                      description: 'Тип медиа: `image`/`video`.'
                      enum:
                        - image
                        - video
                      example: image
                      type: string
                    url:
                      description: Ссылка на файл.
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      type: string
                  type: object
                type: array
              name:
                $ref: '#/components/schemas/name-localization-object'
              order:
                description: Приоритет порядка игры в списке.
                example: 1
                type: integer
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: game_1
                type: string
              type:
                description: Тип товара. В данном случае это всегда `unit`.
                example: unit
                type: string
              unit_items:
                description: Платформы публикации игры.
                items:
                  description: >-
                    Игра, опубликованная на определенной платформе (steam, gog и
                    т.д.).
                  properties:
                    drm_id:
                      description: Внутренний уникальный ID платформы.
                      example: 1
                      type: integer
                    drm_image:
                      description: Значок игры на платформе.
                      example: >-
                        https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                      nullable: true
                      type: string
                    drm_name:
                      description: Название игры на платформе.
                      example: Steam
                      type: string
                    drm_sku:
                      description: Уникальный ID платформы.
                      example: steam
                      type: string
                    is_enabled:
                      description: >-
                        Если этот параметр отключен, товар нельзя приобрести и
                        получить к нему доступ через инвентарь.
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_sales_exist:
                      description: >-
                        Если `true`, зафиксированы продажи игры на данной
                        платформе.
                      type: boolean
                    is_show_in_store:
                      description: Товар доступен для покупки.
                      type: boolean
                    item_id:
                      description: >-
                        Внутренний уникальный ID товара, который задается при
                        создании товара.
                      example: 1
                      type: integer
                    keys:
                      properties:
                        available:
                          description: Количество игровых ключей, доступных для покупки.
                          type: integer
                        total:
                          description: Общее количество загруженных игровых ключей.
                          type: integer
                        used:
                          description: Количество проданных игровых ключей.
                          type: integer
                      type: object
                    limits:
                      $ref: '#/components/schemas/admin-item-limit-response'
                    order:
                      description: Приоритет порядка игры в списке.
                      example: 1
                      type: integer
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
                    pre_order:
                      description: Настройки предзаказа.
                      properties:
                        description:
                          description: >-
                            Дополнительная информация для предзаказа, которая
                            будет выслана по электронной почте.
                          nullable: true
                          type: string
                        is_enabled:
                          description: >-
                            Если этот параметр отключен, товар не является
                            предзаказом.
                          type: boolean
                        release_date:
                          description: Дата выпуска игры на платформе в формате ISO 8601.
                          nullable: true
                          type: string
                      type: object
                    prices:
                      description: Цены в реальных валютах.
                      example:
                        - amount: 1299.99
                          country_is: RU
                          currency: RUB
                          is_default: true
                          is_enabled: true
                      items:
                        properties:
                          amount:
                            example: 1299.99
                            type: number
                          country_iso:
                            description: >-
                              Страна, где доступна эта цена. Двухбуквенный код в
                              соответствии с [ISO 3166-1 alpha
                              2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
                            example: US
                            nullable: true
                            type: string
                          currency:
                            description: >-
                              Валюта, в которой указана цена товара.
                              Трехбуквенный код в соответствии со стандартом
                              [ISO
                              4217](https://en.wikipedia.org/wiki/ISO_4217).
                            example: RUB
                            type: string
                          is_default:
                            description: >-
                              Цена по умолчанию используется для построения
                              каталога, если цена в валюте пользователя не
                              указана.
                            type: boolean
                          is_enabled:
                            type: boolean
                        type: object
                      type: array
                    regions:
                      $ref: '#/components/schemas/Game-Keys_regions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: game_1
                      type: string
                    type:
                      description: Тип товара. В данном случае это всегда `game_key`.
                      example: game_key
                      type: string
                    virtual_prices:
                      example:
                        - amount: 1000
                          description: null
                          image_url: >-
                            https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                          is_default: true
                          name:
                            en: Gold
                          sku: com.xsolla.gold_1
                          type: virtual_currency
                      items:
                        properties:
                          amount:
                            type: number
                          description:
                            additionalProperties: true
                            description: >-
                              Объект с локализациями для описания игры. Игровые
                              ключи для обозначения стран указаны в стандарте
                              ISO 3166-1.
                            example:
                              en: Game 1 Example
                            type: object
                          image_url:
                            description: URL-адрес изображения.
                            example: https://image.example.com
                            type: string
                          is_default:
                            type: boolean
                          name:
                            additionalProperties: true
                            description: >-
                              Объект с локализациями для названия виртуальной
                              валюты. Ключи для обозначения стран указаны в
                              стандарте ISO 3166-1.
                            example:
                              en: Gold
                            type: object
                          sku:
                            description: >-
                              Уникальный ID товара. Артикул может содержать
                              только строчные и заглавные латинские буквы,
                              цифры, точки, тире и подчеркивания.
                            example: gold
                            type: string
                          type:
                            description: >-
                              Тип товара. В данном случае это всегда
                              `virtual_currency`.
                            example: virtual_currency
                            type: string
                        type: object
                      nullable: true
                      type: array
                  type: object
                type: array
            type: object
      description: Игра успешно получена.
    Game-Keys_200-admin-get-games-list:
      content:
        application/json:
          examples:
            response:
              value:
                items:
                  - attributes:
                      - external_id: platform
                        name:
                          en-US: Platform
                        values:
                          - external_id: >-
                              platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                            value:
                              de-DE: Windows, Linux
                              en-US: Windows, Linux
                    description:
                      en: Example game 1
                    groups:
                      - external_id: horror
                        name:
                          en: Horror
                    image_url: https://image.example.com
                    is_enabled: true
                    is_free: false
                    is_show_in_store: false
                    item_id: 1
                    long_description:
                      en: Example game's long description
                    media_list:
                      - type: image
                        url: >-
                          https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                    name:
                      en: Game 1
                    order: 1
                    sku: com.xsolla.game_1
                    type: unit
                    unit_items:
                      - drm_id: 1
                        drm_image: >-
                          https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                        drm_name: Steam
                        drm_sku: steam_key_1
                        is_enabled: true
                        is_free: false
                        is_sales_exist: false
                        is_show_in_store: false
                        item_id: 3
                        keys:
                          available: 3
                          total: 4
                          used: 1
                        limits:
                          per_item:
                            available: 5000
                            reserved: 500
                            sold: 4500
                            total: 10000
                          per_user:
                            limit_exceeded_visibility: show
                            total: 10
                          recurrent_schedule:
                            per_user:
                              displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                              displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                              interval_type: daily
                              reset_next_date: 1677553200
                              time: 11:00:00+08:00
                        order: 1
                        periods:
                          - date_from: '2020-08-11T20:00:00+03:00'
                            date_until: null
                        pre_order:
                          description: null
                          is_enabled: false
                          release_date: null
                        prices:
                          - amount: 1199.99
                            country_iso: RU
                            currency: RUB
                            is_default: true
                            is_enabled: true
                        sku: com.xsolla.game_1_key_1
                        type: game_key
                        virtual_prices: []
                      - attributes: []
                        drm_id: 8
                        drm_image: null
                        drm_name: Epic Games Store
                        drm_sku: epicgames_key_1
                        groups: []
                        is_enabled: true
                        is_free: false
                        is_sales_exist: true
                        is_show_in_store: false
                        item_id: 4
                        keys:
                          available: 0
                          total: 0
                          used: 0
                        limits:
                          per_item: null
                          per_user: null
                          recurrent_schedule: null
                        name:
                          en: Game 1 Key 2
                        order: 1
                        periods: []
                        pre_order:
                          description: Some description
                          is_enabled: true
                          release_date: '2020-08-11T10:00:00+03:00'
                        prices:
                          - amount: 1299.99
                            country_iso: RU
                            currency: RUB
                            is_default: true
                            is_enabled: true
                        sku: com.xsolla.game_1_key_2
                        type: game_key
                        virtual_prices: null
                  - attributes:
                      - external_id: platform
                        name:
                          en-US: Platform
                        values:
                          - external_id: >-
                              platform_value_d847f9a494487f5e95ad218f7beecac646f15989
                            value:
                              de-DE: Windows, Linux
                              en-US: Windows, Linux
                    description:
                      en: Example game 2
                    groups:
                      - external_id: horror
                        name:
                          en: Horror
                    image_url: https://image.example.com
                    is_enabled: true
                    is_free: false
                    is_show_in_store: true
                    item_id: 2
                    long_description:
                      en: Example game's long description
                    media_list: []
                    name:
                      en: Game 2
                    order: 1
                    sku: com.xsolla.game_2
                    type: unit
                    unit_items:
                      - drm_id: 8
                        drm_image: null
                        drm_name: Epic Games Store
                        drm_sku: epicgames_key_1
                        is_enabled: false
                        is_free: false
                        is_sales_exist: true
                        is_show_in_store: false
                        item_id: 5
                        keys:
                          available: 0
                          total: 0
                          used: 0
                        limits:
                          per_item:
                            available: 5000
                            reserved: 500
                            sold: 4500
                            total: 10000
                          per_user:
                            limit_exceeded_visibility: show
                            total: 10
                          recurrent_schedule:
                            per_user:
                              displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                              displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                              interval_type: daily
                              reset_next_date: 1677553200
                              time: 11:00:00+08:00
                        order: 1
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        pre_order:
                          description: null
                          is_enabled: false
                          release_date: null
                        prices: []
                        sku: com.xsolla.game_2_key_2
                        type: game_key
                        virtual_prices:
                          - amount: 1000
                            description: null
                            image_url: >-
                              https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                            is_default: true
                            name:
                              en: Gold
                            sku: com.xsolla.gold_1
                            type: virtual_currency
          schema:
            description: Объект с играми.
            properties:
              items:
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_admin-attributes'
                    description:
                      $ref: '#/components/schemas/description-localization-object'
                    groups:
                      description: Группы, к которым принадлежит товар.
                      example:
                        - external_id: horror
                          name:
                            en: Horror
                      items:
                        properties:
                          external_id:
                            example: horror
                            type: string
                          name:
                            example:
                              en: Horror
                            type: object
                        type: object
                      type: array
                    image_url:
                      description: URL-адрес изображения.
                      example: https://image.example.com
                      type: string
                    is_enabled:
                      description: >-
                        Если этот параметр отключен, товар нельзя приобрести и
                        получить к нему доступ через инвентарь.
                      type: boolean
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_show_in_store:
                      description: Товар доступен для покупки.
                      type: boolean
                    item_id:
                      description: >-
                        Внутренний уникальный ID товара, который задается при
                        создании товара.
                      example: 1
                      type: integer
                    long_description:
                      $ref: >-
                        #/components/schemas/long-description-localization-object
                    media_list:
                      description: >-
                        Дополнительные ассеты игры, такие как скриншоты, видео
                        игрового процесса и так далее.
                      example:
                        - type: image
                          url: >-
                            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                      items:
                        properties:
                          type:
                            description: 'Тип медиа: `image`/`video`.'
                            enum:
                              - image
                              - video
                            example: image
                            type: string
                          url:
                            description: Ссылка на файл.
                            example: >-
                              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                            type: string
                        type: object
                      type: array
                    name:
                      $ref: '#/components/schemas/name-localization-object'
                    order:
                      description: Приоритет порядка игры в списке.
                      example: 1
                      type: integer
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: game_1
                      type: string
                    type:
                      description: Тип товара. В данном случае это всегда `unit`.
                      example: unit
                      type: string
                    unit_items:
                      description: Платформы публикации игры.
                      items:
                        description: >-
                          Игра, опубликованная на определенной платформе (steam,
                          gog и т.д.).
                        properties:
                          attributes:
                            $ref: '#/components/schemas/Game-Keys_admin-attributes'
                          drm_id:
                            description: Внутренний уникальный ID платформы.
                            example: 1
                            type: integer
                          drm_image:
                            description: Значок игры на платформе.
                            example: >-
                              https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                            nullable: true
                            type: string
                          drm_name:
                            description: Название игры на платформе.
                            example: Steam
                            type: string
                          drm_sku:
                            description: Уникальный ID платформы.
                            example: steam
                            type: string
                          groups:
                            description: Группы, к которым принадлежит товар.
                            example:
                              - external_id: horror
                                name:
                                  en: Horror
                            items:
                              properties:
                                external_id:
                                  example: horror
                                  type: string
                                name:
                                  example:
                                    en: Horror
                                  type: object
                              type: object
                            type: array
                          is_enabled:
                            description: >-
                              Если этот параметр отключен, товар нельзя
                              приобрести и получить к нему доступ через
                              инвентарь.
                            type: boolean
                          is_free:
                            $ref: '#/components/schemas/value-is_free'
                          is_sales_exist:
                            description: >-
                              Если `true`, зафиксированы продажи игры на данной
                              платформе.
                            type: boolean
                          is_show_in_store:
                            description: Товар доступен для покупки.
                            type: boolean
                          item_id:
                            description: >-
                              Внутренний уникальный ID товара, который задается
                              при создании товара.
                            example: 1
                            type: integer
                          keys:
                            properties:
                              available:
                                description: >-
                                  Количество игровых ключей, доступных для
                                  покупки.
                                type: integer
                              total:
                                description: Общее количество загруженных игровых ключей.
                                type: integer
                              used:
                                description: Количество проданных игровых ключей.
                                type: integer
                            type: object
                          limits:
                            $ref: '#/components/schemas/admin-item-limit-response'
                          long_description:
                            $ref: >-
                              #/components/schemas/long-description-localization-object
                          name:
                            $ref: '#/components/schemas/name-localization-object'
                          order:
                            description: Приоритет порядка игры в списке.
                            example: 1
                            type: integer
                          periods:
                            $ref: '#/components/schemas/item-periods-response'
                          pre_order:
                            description: Настройки предзаказа.
                            properties:
                              description:
                                description: >-
                                  Дополнительная информация для предзаказа,
                                  которая будет выслана по электронной почте.
                                nullable: true
                                type: string
                              is_enabled:
                                description: >-
                                  Если этот параметр отключен, товар не является
                                  предзаказом.
                                type: boolean
                              release_date:
                                description: >-
                                  Дата выпуска игры на платформе в формате ISO
                                  8601.
                                nullable: true
                                type: string
                            type: object
                          prices:
                            description: Цены в реальных валютах.
                            example:
                              - amount: 1299.99
                                currency: RUB
                                is_default: true
                                is_enabled: true
                            items:
                              properties:
                                amount:
                                  example: 1299.99
                                  type: number
                                country_iso:
                                  description: >-
                                    Страна, где доступна эта цена. Двухбуквенный
                                    код в соответствии с [ISO 3166-1 alpha
                                    2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
                                  example: US
                                  nullable: true
                                  type: string
                                currency:
                                  description: >-
                                    Валюта, в которой указана цена товара.
                                    Трехбуквенный код в соответствии со
                                    стандартом [ISO
                                    4217](https://en.wikipedia.org/wiki/ISO_4217).
                                  example: RUB
                                  type: string
                                is_default:
                                  description: >-
                                    Цена по умолчанию используется для
                                    построения каталога, если цена в валюте
                                    пользователя не указана.
                                  type: boolean
                                is_enabled:
                                  type: boolean
                              type: object
                            type: array
                          regions:
                            $ref: '#/components/schemas/Game-Keys_regions'
                          sku:
                            description: >-
                              Уникальный ID товара. Артикул может содержать
                              только строчные и заглавные латинские буквы,
                              цифры, точки, тире и подчеркивания.
                            example: game_1
                            type: string
                          type:
                            description: Тип товара. В данном случае это всегда `game_key`.
                            example: game_key
                            type: string
                          virtual_prices:
                            example:
                              - amount: 1000
                                description: null
                                image_url: >-
                                  https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png
                                is_default: true
                                name:
                                  en: Gold
                                sku: com.xsolla.gold_1
                                type: virtual_currency
                            items:
                              properties:
                                amount:
                                  type: number
                                description:
                                  additionalProperties: true
                                  description: >-
                                    Объект с локализациями для описания игры.
                                    Игровые ключи для обозначения стран указаны
                                    в стандарте ISO 3166-1.
                                  example:
                                    en: Game 1 Example
                                  nullable: true
                                  type: object
                                image_url:
                                  description: URL-адрес изображения.
                                  example: https://image.example.com
                                  type: string
                                is_default:
                                  type: boolean
                                name:
                                  additionalProperties: true
                                  description: >-
                                    Объект с локализациями для названия
                                    виртуальной валюты. Ключи для обозначения
                                    стран указаны в стандарте ISO 3166-1.
                                  example:
                                    en: Gold
                                  type: object
                                sku:
                                  description: >-
                                    Уникальный ID товара. Артикул может
                                    содержать только строчные и заглавные
                                    латинские буквы, цифры, точки, тире и
                                    подчеркивания.
                                  example: gold
                                  type: string
                                type:
                                  description: >-
                                    Тип товара. В данном случае это всегда
                                    `virtual_currency`.
                                  example: virtual_currency
                                  type: string
                              type: object
                            nullable: true
                            type: array
                        type: object
                      type: array
                  type: object
                type: array
            type: object
      description: Список игр успешно получен.
    Game-Keys_200-get-codes:
      content:
        text/plain:
          examples:
            response:
              value: PIN-CODE-ALL PIN-CODE-ALL-3
          schema:
            example: PIN-CODE-ALL PIN-CODE-ALL-3
            type: string
      description: Коды успешно получены.
    Game-Keys_200-get-drm-list:
      content:
        application/json:
          examples:
            response:
              value:
                drm:
                  - drm_id: 1
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: https://support.steampowered.com
                    name: Steam
                    redeem_instruction_link: https://support.steampowered.com
                    sku: steam_key_1
                  - drm_id: 2
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: null
                    name: Playstation
                    redeem_instruction_link: https://support.us.playstation.com
                    sku: playstation_key_1
          schema:
            description: Объект с играми.
            properties:
              drm:
                example:
                  - drm_id: 1
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: https://support.steampowered.com
                    name: Steam
                    redeem_instruction_link: https://support.steampowered.com
                    sku: steam_key_1
                  - drm_id: 2
                    image: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    link: null
                    name: Playstation
                    redeem_instruction_link: https://support.us.playstation.com
                    sku: playstation_key_1
                items:
                  properties:
                    drm_id:
                      description: ID платформы.
                      example: 1
                      type: number
                    image:
                      description: URL-адрес изображения.
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      type: string
                    link:
                      description: Ссылка для активации ключа.
                      example: https://support.us.playstation.com
                      nullable: true
                      type: string
                    name:
                      description: Название платформы.
                      example: Steam
                      type: string
                    redeem_instruction_link:
                      description: Ссылка на инструкцию по активации.
                      example: https://support.us.playstation.com
                      type: string
                    sku:
                      description: >-
                        Уникальный ID платформы. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: steam
                      type: string
                  type: object
                type: array
            type: object
      description: Список платформ успешно получен.
    Game-Keys_200-get-game-keys-by-group-catalog:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: true
                items:
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam_key_1
                    groups:
                      - external_id: all
                        item_order_in_group: 2
                        name: All games
                      - external_id: Xsolla
                        item_order_in_group: 1
                        name: Xsolla games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: true
                    name: Game name
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    release_date: '2020-08-11T10:00:00+03:00'
                    sku: com.xsolla.game_1
                    type: game_key
                    virtual_prices: []
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam_key_2
                    groups:
                      - external_id: all
                        item_order_in_group: 1
                        name: All games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: false
                    name: Game name
                    periods: []
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    release_date: null
                    sku: com.xsolla.game_2
                    type: game_key
                    virtual_prices: []
          schema:
            description: Объект с играми.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                example:
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam_key_1
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: true
                    name: Game name
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    release_date: '2020-08-11T10:00:00+03:00'
                    sku: com.xsolla.game_1
                    type: game_key
                    virtual_prices: []
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam_key_2
                    groups:
                      - external_id: all
                        name: All games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: false
                    name: Game name
                    periods: []
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    release_date: null
                    sku: com.xsolla.game_2
                    type: game_key
                    virtual_prices: []
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                    description:
                      description: Описание товара.
                      example: Game description
                      type: string
                    drm_name:
                      description: Название платформы.
                      example: Steam
                      type: string
                    drm_sku:
                      description: >-
                        Уникальный ID платформы. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: steam
                      type: string
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    has_keys:
                      description: >-
                        Если `true`, у игры на платформе есть игровые ключи для
                        продажи.
                      example: false
                      type: boolean
                    image_url:
                      description: URL-адрес изображения.
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    is_pre_order:
                      description: >-
                        Если `true`, игра на платформе находится в предзаказе и
                        дата релиза еще не прошла.
                      example: true
                      type: boolean
                    name:
                      description: Название товара.
                      example: Game name
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
                    price:
                      description: Цены на товар.
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '2.9900'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '2.9900'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    release_date:
                      description: Дата выпуска игры на платформе в формате ISO 8601.
                      example: '2020-08-11T10:00:00+03:00'
                      nullable: true
                      type: string
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: game_01
                      type: string
                    type:
                      description: 'Тип товара: `game_key`.'
                      example: game_key
                      type: string
                    virtual_prices:
                      description: Виртуальные цены.
                      items:
                        description: Виртуальная цена.
                        properties:
                          amount:
                            description: Цена товара со скидкой в виртуальной валюте.
                            example: 100
                            type: integer
                          amount_without_discount:
                            description: Цена товара.
                            example: 200
                            type: integer
                          description:
                            description: Описание виртуальной валюты.
                            example: Big Rocket - description
                            type: string
                          image_url:
                            description: Изображение виртуальной валюты.
                            example: http://image.png
                            type: string
                          is_default:
                            description: Является ли данная цена товара ценой по умолчанию.
                            example: true
                            type: boolean
                          name:
                            description: Название виртуальной валюты.
                            example: SHOTGUN FOR TRUE RAIDERS
                            type: string
                          sku:
                            description: Артикул виртуальной валюты.
                            example: vc_test
                            type: string
                          type:
                            description: Тип виртуальной валюты.
                            example: virtual_currency
                            type: string
                        type: object
                      type: array
                  type: object
                type: array
            type: object
      description: Список игр успешно получен.
    Game-Keys_200-get-games-catalog:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - attributes:
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    groups:
                      - external_id: all
                        item_order_in_group: 2
                        name: All games
                      - external_id: Xsolla
                        item_order_in_group: 1
                        name: Xsolla games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    promotions: []
                    sku: com.xsolla.game_1
                    type: unit
                    unit_items:
                      - can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_free: false
                        is_pre_order: true
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        release_date: '2020-08-11T10:00:00+03:00'
                        sku: com.xsolla.game_key_01
                        type: game_key
                        virtual_prices: []
                        vp_rewards:
                          - amount: 130
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            item_id: 175232
                            name: Value point
                            sku: com.xsolla.value_point_1
                          - amount: 50
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            is_clan: true
                            item_id: 186321
                            name: Clan Reward VP 1
                            sku: com.xsolla.clan_value_point_1
                      - can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        periods: []
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        release_date: null
                        sku: com.xsolla.game_key_02
                        type: game_key
                        virtual_prices: []
                        vp_rewards: []
                    unit_type: game
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                    description: Game description
                    groups:
                      - external_id: all
                        item_order_in_group: 1
                        name: All games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    promotions: []
                    sku: com.xsolla.game_2
                    type: unit
                    unit_items:
                      - can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        periods:
                          - date_from: '2020-08-11T20:00:00+03:00'
                            date_until: null
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        release_date: null
                        sku: com.xsolla.game_key_01
                        type: game_key
                        virtual_prices: []
                        vp_rewards: []
                    unit_type: game
          schema:
            description: Объект с играми.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                example:
                  - attributes:
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    description: Game description
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    promotions: []
                    sku: com.xsolla.game_1
                    type: unit
                    unit_items:
                      - can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_free: false
                        is_pre_order: true
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        promotions: []
                        release_date: '2020-08-11T10:00:00+03:00'
                        sku: com.xsolla.game_key_01
                        type: game_key
                        virtual_prices: []
                      - can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        periods: []
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        promotions: []
                        release_date: null
                        sku: com.xsolla.game_key_02
                        type: game_key
                        virtual_prices: []
                    unit_type: game
                  - attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                    description: Game description
                    groups:
                      - external_id: all
                        name: All games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    promotions: []
                    sku: com.xsolla.game_2
                    type: unit
                    unit_items:
                      - can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_2
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        periods:
                          - date_from: null
                            date_until: '2020-08-11T20:00:00+03:00'
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        promotions: []
                        release_date: null
                        sku: com.xsolla.game_key_01
                        type: game_key
                        virtual_prices: []
                    unit_type: game
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                    description:
                      description: Описание товара.
                      example: Game description
                      type: string
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    image_url:
                      description: URL-адрес изображения.
                      example: >-
                        https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                      type: string
                    name:
                      description: Название товара.
                      example: Game name
                      type: string
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: game_01
                      type: string
                    type:
                      description: >-
                        Тип товара:
                        `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
                      example: unit
                      type: string
                    unit_items:
                      items:
                        properties:
                          can_be_bought:
                            $ref: '#/components/schemas/Can_be_bought'
                          drm_name:
                            description: Название платформы.
                            example: Steam
                            type: string
                          drm_sku:
                            description: >-
                              Уникальный ID платформы. Артикул может содержать
                              только строчные и заглавные латинские буквы,
                              цифры, точки, тире и подчеркивания.
                            example: steam
                            type: string
                          has_keys:
                            description: >-
                              Если `true`, у игры на платформе есть игровые
                              ключи для продажи.
                            example: false
                            type: boolean
                          is_free:
                            $ref: '#/components/schemas/value-is_free'
                          is_pre_order:
                            description: >-
                              Если `true`, игра на платформе находится в
                              предзаказе и дата релиза еще не прошла.
                            example: true
                            type: boolean
                          periods:
                            $ref: '#/components/schemas/item-periods'
                          price:
                            description: Цены на товар.
                            properties:
                              amount:
                                description: Цена товара со скидкой.
                                example: '2.9900'
                                type: string
                              amount_without_discount:
                                description: Цена товара.
                                example: '2.9900'
                                type: string
                              currency:
                                description: >-
                                  Валюта, в которой указана цена товара.
                                  Трехбуквенный код в соответствии со стандартом
                                  [ISO
                                  4217](https://en.wikipedia.org/wiki/ISO_4217).
                                example: USD
                                type: string
                            type: object
                          promotions:
                            $ref: '#/components/schemas/Catalog_item_promotions'
                          release_date:
                            description: Дата выпуска игры на платформе в формате ISO 8601.
                            example: '2020-08-11T10:00:00+03:00'
                            nullable: true
                            type: string
                          sku:
                            description: >-
                              Уникальный ID товара. Артикул может содержать
                              только строчные и заглавные латинские буквы,
                              цифры, точки, тире и подчеркивания.
                            example: game_01
                            type: string
                          type:
                            description: 'Тип товара: `game_key`.'
                            example: game_key
                            type: string
                          virtual_prices:
                            description: Виртуальные цены.
                            items:
                              description: Виртуальная цена.
                              properties:
                                amount:
                                  description: Цена товара со скидкой в виртуальной валюте.
                                  example: 100
                                  type: integer
                                amount_without_discount:
                                  description: Цена товара.
                                  example: 200
                                  type: integer
                                description:
                                  description: Описание виртуальной валюты.
                                  example: Big Rocket - description
                                  type: string
                                image_url:
                                  description: Изображение виртуальной валюты.
                                  example: http://image.png
                                  type: string
                                is_default:
                                  description: >-
                                    Является ли данная цена товара ценой по
                                    умолчанию.
                                  example: true
                                  type: boolean
                                name:
                                  description: Название виртуальной валюты.
                                  example: SHOTGUN FOR TRUE RAIDERS
                                  type: string
                                sku:
                                  description: Артикул виртуальной валюты.
                                  example: vc_test
                                  type: string
                                type:
                                  description: Тип виртуальной валюты.
                                  example: virtual_currency
                                  type: string
                              type: object
                            type: array
                          vp_rewards:
                            $ref: >-
                              #/components/schemas/client-item-value-point-reward
                        type: object
                      type: array
                    unit_type:
                      description: 'Тип: `game`.'
                      example: game
                      type: string
                  type: object
                type: array
            type: object
      description: Список игр успешно получен.
    Game-Keys_200-session-information:
      content:
        application/json:
          examples:
            response:
              value:
                count_skipped: 10
                count_total: 100
                count_uploaded: 0
                session_id: fc7105b6e8ee01339582970b37697242
                status: processing
          schema:
            properties:
              count_skipped:
                example: 10
                type: integer
              count_total:
                example: 100
                type: integer
              count_uploaded:
                example: 0
                type: integer
              session_id:
                example: fc7105b6e8ee01339582970b37697242
                type: string
              status:
                example: processing
                type: string
            type: object
      description: Информация о сеансе загрузки кодов успешно получена.
    Game-Keys_200-user-entitlement-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - description: Description of the greatest game in the world.
                    drm: drmfree
                    game_sku: com.xsolla.key_1
                    image_url: https://none
                    is_pre_order: false
                    name: The Greatest Game in the World
                    project_id: 30810
                total_items_count: 1
          schema:
            description: Объект с информацией об игре.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                items:
                  $ref: '#/components/schemas/Game-Keys_entitlement_item'
                type: array
              total_items_count:
                $ref: '#/components/schemas/Pagination_total-items-count'
            type: object
      description: Список игровых ключей, принадлежащих пользователю, успешно получен.
    Game-Keys_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Game-Keys_403-auth-header-not-sent:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 0
                errorMessage: Authorization header not sent
                statusCode: 403
          schema:
            properties:
              errorCode:
                example: 0
                type: integer
              errorMessage:
                example: Authorization header not sent.
                type: string
              statusCode:
                example: 403
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Заголовок Authorization не отправлен.
    Game-Keys_422-invalid-request:
      content:
        application/json:
          examples:
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            The property `drm_sku` is required:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `drm_sku` is
                  required
                statusCode: 422
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
          schema:
            $ref: '#/components/schemas/Game-Keys_422-invalid-request'
      description: Неверный запрос.
    Promotions_200-admin-get-bonus-promotion:
      content:
        application/json:
          examples:
            response:
              value:
                bonus:
                  - quantity: 1
                    sku: com.xsolla.elven_sword_1
                  - quantity: 2
                    sku: com.xsolla.elven_shield_1
                  - quantity: 2
                    sku: com.xsolla.elven_gloves_1
                condition:
                  - sku: com.xsolla.elven_boots_1
                  - sku: com.xsolla.elven_knife_1
                excluded_promotions:
                  - 23
                  - 45
                id: 1
                is_enabled: true
                limits:
                  per_item: null
                  per_user:
                    total: 10
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                name:
                  de-DE: Neujahrsbonus
                  en-US: New Year Bonus
                price_conditions:
                  - operator: gt
                    value: '10.0000'
                  - operator: lt
                    value: '50.0000'
                promotion_periods:
                  - date_from: '2020-04-15T18:16:00+05:00'
                    date_until: '2020-04-25T18:16:00+05:00'
          schema:
            $ref: '#/components/schemas/Promotions_200-get-bonus-promotion-model'
      description: Акция с бонусами успешно получена.
    Promotions_200-coupon-code-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-coupon-code-list'
          schema:
            properties:
              codes:
                items:
                  properties:
                    code:
                      $ref: '#/components/schemas/Promotions_coupon_code'
                  type: object
                type: array
              total_count:
                description: Общее количество кодов для купона.
                type: number
            type: object
      description: Список кодов для купона успешно получен.
    Promotions_200-coupon-redeemed:
      content:
        application/json:
          examples:
            response:
              value:
                items:
                  - attributes: []
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: true
                    name: Xsolla Booster Mega
                    price: null
                    quantity: 1
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
          schema:
            properties:
              items:
                example:
                  - attributes: []
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    name: Xsolla Booster Mega
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    quantity: 1
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                items:
                  properties:
                    attributes:
                      type: array
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_free:
                      type: boolean
                    name:
                      nullable: true
                      type: string
                    price:
                      description: Цены на товар.
                      nullable: true
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '2.9900'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '2.9900'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    virtual_item_type:
                      description: Тип виртуального предмета.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                      example: non-consumable
                      type: string
                      x-enumDescriptions:
                        consumable: >-
                          Предмет исчезает из инвентаря после использования
                          (например, патроны).
                        non_consumable: >-
                          Предмет остается в инвентаре в течение неограниченного
                          времени.
                        non_renewing_subscription: >-
                          Предмет с ограниченным сроком действия, который может
                          служить представлением доступа к сервисам или контенту
                          в течение ограниченного периода времени.
                    virtual_prices:
                      type: array
                  type: object
                type: array
            type: object
      description: Купон успешно погашен.
    Promotions_200-coupon-rewards:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-get-coupon-rewards'
          schema:
            properties:
              bonus:
                items:
                  $ref: '#/components/schemas/Promotions_200-coupon-bonus-reward'
                type: array
              discount:
                $ref: '#/components/schemas/Promotions_200-coupon-discount-reward'
              is_selectable:
                description: >-
                  Если `true`, то пользователь должен выбрать бонус перед
                  погашением купона.
                type: boolean
            type: object
      description: Список вознаграждений по купону успешно получен.
    Promotions_200-get-bonus-promotions:
      content:
        application/json:
          examples:
            response:
              value:
                active_promotions_count: 2
                inactive_promotions_count: 0
                promotions:
                  - bonus:
                      - quantity: 1
                        sku: com.xsolla.elven_sword_1
                      - quantity: 2
                        sku: com.xsolla.elven_shield_1
                      - quantity: 2
                        sku: com.xsolla.elven_gloves_1
                    condition:
                      - sku: com.xsolla.elven_boots_1
                      - sku: com.xsolla.elven_knife_1
                    id: 1
                    is_enabled: true
                    limits:
                      per_item: null
                      per_user: null
                      recurrent_schedule: null
                    name:
                      de-DE: Neujahrsbonus
                      en-US: New Year Bonus
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                      - date_from: '2020-05-15T18:16:00+05:00'
                        date_until: '2020-05-25T18:16:00+05:00'
                  - bonus:
                      - quantity: 100
                        sku: com.xsolla.diamonds_1
                    condition: null
                    excluded_promotions:
                      - 1
                    id: 2
                    is_enabled: true
                    limits:
                      per_item: null
                      per_user:
                        total: 10
                      recurrent_schedule:
                        per_user:
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    name:
                      de-DE: Sommersaison Bonus
                      en-US: Summer season bonus
                    price_conditions:
                      - operator: gt
                        value: '10.0000'
                      - operator: lt
                        value: '50.0000'
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                total_promotions_count: 2
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              promotions:
                items:
                  $ref: >-
                    #/components/schemas/Promotions_200-get-bonus-promotion-model
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список акций с бонусами успешно получен.
    Promotions_200-get-coupons:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-admin-coupons'
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              items:
                items:
                  $ref: >-
                    #/components/schemas/admin-promotions_200-get-coupon-promotion-model
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список купонов успешно получен.
    Promotions_200-get-item-promotions:
      content:
        application/json:
          examples:
            response:
              value:
                active_promotions_count: 4
                inactive_promotions_count: 0
                promotions:
                  - discount:
                      percent: '20.00'
                    id: 1
                    is_enabled: true
                    items:
                      - sku: com.xsolla.elven_sword_1
                    limits:
                      per_item: null
                      per_user: null
                      recurrent_schedule: null
                    name:
                      en-US: Promotion
                      ru-RU: Акция
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                      - date_from: '2020-05-15T18:16:00+05:00'
                        date_until: '2020-05-25T18:16:00+05:00'
                  - discount:
                      percent: '10.00'
                    excluded_promotions:
                      - 1
                      - 3
                    id: 2
                    is_enabled: true
                    items:
                      - sku: com.xsolla.elven_helmet_1
                      - sku: com.xsolla.elven_armor_1
                    limits:
                      per_item: null
                      per_user:
                        total: 10
                      recurrent_schedule:
                        per_user:
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    name:
                      en-US: Promotion
                      ru-RU: Акция
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                  - discount:
                      percent: '10.00'
                    id: 3
                    is_enabled: true
                    items:
                      - sku: com.xsolla.elven_helmet_2
                      - sku: com.xsolla.elven_armor_2
                    limits:
                      per_item: null
                      per_user:
                        total: 10
                      recurrent_schedule:
                        per_user:
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    name:
                      en-US: Promotion
                      ru-RU: Акция
                    price_conditions:
                      - operator: gt
                        value: '10.0000'
                      - operator: lt
                        value: '20.0000'
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                  - discount:
                      percent: '10.00'
                    id: 4
                    is_enabled: true
                    items: null
                    limits:
                      per_item: null
                      per_user:
                        total: 10
                      recurrent_schedule:
                        per_user:
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    name:
                      en-US: Promotion
                      ru-RU: Акция
                    price_conditions:
                      - operator: lt
                        value: '20.0000'
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                total_promotions_count: 4
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              promotions:
                items:
                  properties:
                    attribute_conditions:
                      $ref: >-
                        #/components/schemas/promotion_user-attribute_conditions_model-get
                    discount:
                      properties:
                        percent:
                          default: '10.00'
                          description: >-
                            Процент скидки. 

                            Цена товара будет уменьшена с использованием
                            значения, рассчитанного с использованием этого
                            процента.
                          nullable: true
                          type: string
                      type: object
                    excluded_promotions:
                      $ref: '#/components/schemas/excluded_promotions'
                    id:
                      description: >-
                        ID акции. Уникальный идентификатор акции в рамках
                        проекта.
                      type: integer
                    is_enabled:
                      $ref: '#/components/schemas/Promotions_is_enabled'
                    items:
                      items:
                        description: >-
                          Список товаров, на которые будет распространяться
                          скидка.
                        properties:
                          sku:
                            default: elven_sword
                            description: Артикул товара.
                            nullable: true
                            type: string
                        type: object
                      nullable: true
                      type: array
                    limits:
                      $ref: >-
                        #/components/schemas/Promotions_promotion_limits_response
                    name:
                      additionalProperties:
                        type: string
                      description: >-
                        Название акции. Данный параметр должен содержать пары
                        ключ/значение, где ключ — это локаль в формате
                        "^[a-z]{2}-[A-Z]{2}$", значение — строка.
                      example:
                        en-US: Promotion
                        ru-RU: Акция
                      type: object
                    price_conditions:
                      $ref: '#/components/schemas/price_conditions_discount'
                    promotion_periods:
                      $ref: '#/components/schemas/promotion_periods'
                  type: object
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список акций со скидками успешно получен.
    Promotions_200-get-promocodes:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-admin-promocodes'
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              items:
                items:
                  $ref: >-
                    #/components/schemas/Promotions_200-get-promocode-promotion-model
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список промокодов успешно получен.
    Promotions_200-get-promotions:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-admin-promotions'
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              promotions:
                items:
                  $ref: '#/components/schemas/Promotions_200-get-promotion-model'
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список акций успешно получен.
    Promotions_200-get-unique-catalog-offers:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-admin-unique-catalog-offers'
          schema:
            properties:
              active_promotions_count:
                $ref: '#/components/schemas/active_promotions_count'
              inactive_promotions_count:
                $ref: '#/components/schemas/inactive_promotions_count'
              items:
                items:
                  $ref: >-
                    #/components/schemas/Promotions_200-get-unique-catalog-offer-promotion-model
                type: array
              total_promotions_count:
                $ref: '#/components/schemas/total_promotions_count'
            type: object
      description: Список купонов был успешно получен.
    Promotions_200-promo-code-canceled:
      content:
        application/json:
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Xsolla Booster Mega
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
          schema:
            properties:
              cart_id:
                description: ID корзины.
                example: cart_id
                type: string
              is_free:
                $ref: '#/components/schemas/value-is_free'
              items:
                example:
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Xsolla Booster Mega
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                items:
                  properties:
                    attributes:
                      $ref: '#/components/schemas/client-attributes'
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      nullable: true
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    price:
                      description: Цены на товар.
                      nullable: true
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '2.9900'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '2.9900'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    virtual_item_type:
                      description: Тип виртуального предмета.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                      example: non-consumable
                      type: string
                      x-enumDescriptions:
                        consumable: >-
                          Предмет исчезает из инвентаря после использования
                          (например, патроны).
                        non_consumable: >-
                          Предмет остается в инвентаре в течение неограниченного
                          времени.
                        non_renewing_subscription: >-
                          Предмет с ограниченным сроком действия, который может
                          служить представлением доступа к сервисам или контенту
                          в течение ограниченного периода времени.
                    virtual_prices:
                      type: array
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
              price:
                description: Цена корзины.
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                nullable: true
                properties:
                  amount:
                    default: '50.0000000000000000'
                    type: string
                  amount_without_discount:
                    default: '100.0000000000000000'
                    type: string
                  currency:
                    default: USD
                    type: string
                type: object
            type: object
      description: Промокод успешно отменен.
    Promotions_200-promo-code-redeemed:
      content:
        application/json:
          examples:
            response:
              value:
                cart_id: cart_id
                is_free: false
                items:
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Xsolla Booster Mega
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: false
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes: []
                    can_be_bought: true
                    description: >-
                      Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja
                      Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully
                      Functional, Battle Ready - Black TPR, Steel Guard and
                      Pommel.
                    groups: []
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: true
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Sword Xsolla Skin
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price: []
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    quantity: 1
                    sku: com.xsolla.swords_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                price:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '12300.0000000000000000'
                  currency: USD
                rewards:
                  bonus:
                    - item:
                        description: >-
                          Honshu Boshin Wakizashi - Modern Tactical Samurai /
                          Ninja Sword - Hand Forged 1060 Carbon Steel - Full
                          Tang, Fully Functional, Battle Ready - Black TPR,
                          Steel Guard and Pommel.
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                        name: Sword Xsolla Skin
                        sku: com.xsolla.swords_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                      quantity: 1
                  discount:
                    percent: null
                  discounted_items:
                    - discount:
                        percent: '50.00'
                      sku: com.xsolla.booster_mega_1
                  is_selectable: false
          schema:
            properties:
              cart_id:
                description: ID корзины.
                example: cart_id
                type: string
              is_free:
                $ref: '#/components/schemas/value-is_free'
              items:
                example:
                  - attributes: []
                    can_be_bought:
                      $ref: ../schemas/Can_be_bought.yaml
                    description: >-
                      Take it, take it all! All of Xsolla's riches in one Mega
                      Booster.
                    groups:
                      - external_id: powerups
                        name: Power Ups
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png
                    is_free: false
                    limits:
                      $ref: ../schemas/Catalog_item_limits.yaml
                    name: Xsolla Booster Mega
                    periods:
                      $ref: ../schemas/item-periods.yaml
                    price:
                      amount: '50.0000000000000000'
                      amount_without_discount: '100.0000000000000000'
                      currency: USD
                    promotions:
                      $ref: ../schemas/Catalog_item_promotions.yaml
                    quantity: 123
                    sku: com.xsolla.booster_mega_1
                    type: virtual_good
                    virtual_item_type: consumable
                    virtual_prices: []
                    vp_rewards:
                      $ref: >-
                        ../schemas/reward-chain-client/client-item-value-point-reward.yaml
                items:
                  properties:
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    description:
                      type: string
                    groups:
                      items:
                        properties:
                          external_id:
                            type: string
                          name:
                            type: string
                        type: object
                      type: array
                    image_url:
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      nullable: true
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods'
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    quantity:
                      type: integer
                    sku:
                      type: string
                    type:
                      type: string
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
              price:
                description: Цена корзины.
                example:
                  amount: '6150.0000000000000000'
                  amount_without_discount: '6150.0000000000000000'
                  currency: USD
                nullable: true
                properties:
                  amount:
                    example: '50.0000000000000000'
                    type: string
                  amount_without_discount:
                    example: '100.0000000000000000'
                    type: string
                  currency:
                    example: USD
                    type: string
                type: object
              rewards:
                $ref: '#/components/schemas/Promo_code_rewards'
            type: object
      description: Промокод успешно погашен.
    Promotions_200-promocode-code-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-coupon-code-list'
          schema:
            properties:
              codes:
                items:
                  properties:
                    code:
                      $ref: '#/components/schemas/Promotions_coupon_code'
                  type: object
                type: array
              total_count:
                description: Общее количество кодов для промокода.
                type: number
            type: object
      description: Список кодов для промокода успешно получен.
    Promotions_200-promocode-rewards:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-get-promocode-rewards'
          schema:
            $ref: '#/components/schemas/Promo_code_rewards'
      description: Список вознаграждений по промокоду успешно получен.
    Promotions_200-unique-catalog-offer-code-list:
      content:
        application/json:
          examples:
            response:
              $ref: '#/components/examples/Promotions_200-coupon-code-list'
          schema:
            properties:
              codes:
                items:
                  properties:
                    code:
                      $ref: '#/components/schemas/Promotions_coupon_code'
                  type: object
                type: array
              total_count:
                description: Общее количество уникальных кодов предложений по каталогу.
                type: number
            type: object
      description: >-
        Список кодов для уникального предложения по каталогу был успешно
        получен.
    Promotions_200-verify-promo-code:
      content:
        application/json:
          examples:
            coupon info:
              value:
                code: WINTER2023
                rewards:
                  bonus:
                    - item:
                        description: Game description
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: com.xsolla.game_1
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam_key_1
                            is_free: false
                            name: Game name
                            sku: com.xsolla.game_key_01
                            type: game_key
                          - drm_name: Origin
                            drm_sku: origin_key_1
                            name: Game name
                            sku: com.xsolla.game_key_02
                            type: game_key
                      quantity: 1
                    - item:
                        description: Game description
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: com.xsolla.game_2
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam_key_1
                            name: Game name
                            sku: com.xsolla.game_key_01
                            type: game_key
                      quantity: 2
                  is_selectable: true
                type: coupon
            promocode info:
              value:
                code: SUMMER2023
                rewards:
                  bonus:
                    - item:
                        description: Game description
                        image_url: >-
                          https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                        name: Game name
                        sku: com.xsolla.game_2
                        type: unit
                        unit_items:
                          - drm_name: Steam
                            drm_sku: steam_key_1
                            name: Game name
                            sku: com.xsolla.game_key_01
                            type: game_key
                      quantity: 2
                  discount:
                    percent: '10.00'
                  discounted_items:
                    - description: sword
                      discount:
                        percent: '10.00'
                      image_url: null
                      name: Elven sword
                      sku: com.xsolla.elven_sword_1
                      type: virtual_good
                  is_selectable: true
                type: promocode
          schema:
            properties:
              code:
                $ref: '#/components/schemas/Promotions_coupon_code'
              rewards:
                oneOf:
                  - $ref: '#/components/schemas/Coupon_rewards'
                  - $ref: '#/components/schemas/Promo_code_rewards_verify'
              type:
                description: 'Тип кода: `promocode`/`coupon`.'
                type: string
            type: object
      description: Информация о коде.
    Promotions_201-coupon-promocode-code-created:
      content:
        application/json:
          examples:
            response:
              value:
                code: WINTER2021
          schema:
            properties:
              code:
                $ref: '#/components/schemas/Promotions_coupon_code'
            type: object
      description: Код успешно создан.
    Promotions_201-create-promotion:
      content:
        application/json:
          examples:
            response:
              value:
                promotion_id: 2384756
          schema:
            properties:
              promotion_id:
                description: ID акции. Уникальный идентификатор акции в рамках проекта.
                type: integer
            type: object
      description: Акция успешно создана.
    Promotions_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Promotions_401-invalid-client-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1501
                errorMessage: '[0401-1501]: Authorization failed: Provide authorization'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1501
                type: integer
              errorMessage:
                example: '[0401-1501]: Authorization failed: Provide authorization'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: Данные для аутентификации не переданы или ошибочны.
    Promotions_403-auth-header:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 0
                errorMessage: Authorization header not sent
                statusCode: 403
          schema:
            properties:
              errorCode:
                example: 0
                type: integer
              errorMessage:
                example: Authorization header not sent.
                type: string
              statusCode:
                example: 403
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Заголовок Authorization не отправлен.
    Promotions_404-admin-coupon:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-9802]: Coupon not found'
                type: string
              statusCode:
                example: 404
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Купон не найден. Убедитесь, что верно указали `external_id`.
    Promotions_404-admin-promocode:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-9802]: Promocode not found'
                type: string
              statusCode:
                example: 404
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Промокод не найден. Убедитесь, что `external_id` указан правильно.
    Promotions_404-admin-promotion:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9502
                errorMessage: >-
                  [0401-9502]: Can not find promotion with ID = 111425 in
                  project 59080
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 9502
                type: integer
              errorMessage:
                example: >-
                  [0401-9502]: Can not find promotion with ID = 111425 in
                  project 59080
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Акция не найдена. Убедитесь, что верно указали `promotion_id`.
    Promotions_404-coupon:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-9807]: Enter valid coupon code.'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Введите действительный код купона.
    Promotions_404-promo-code:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-9807]: Enter valid promo code.'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Введите действительный промокод.
    Promotions_404-verify-promo-code:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 9811
                type: integer
              errorMessage:
                example: '[0401-9811]: Code not found.'
                type: string
              statusCode:
                example: 404
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: >-
        Код не найден. Убедитесь, что указанное значение `code` является
        правильным.
    Promotions_422-activate-deactivate-promotion:
      content:
        application/json:
          examples:
            Error was occurred:
              $ref: '#/components/examples/422-activate-deactivate-promotion'
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-9505]: Error was occurred while promotion was being
                  updated
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: da145238620011eb8e24fe6913ff226a
                type: string
            type: object
      description: Неверный запрос.
    Promotions_422-admin-promotion-error:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 9502
                type: integer
              errorMessage:
                example: >-
                  [0401-9502]: Error occurred while receiving the promotion from
                  the promotion service
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Произошла ошибка при получении акции от сервиса продвижения.
    Promotions_422-admin-promotion-missed-bonus-property:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `bonus` is
                  required
                statusCode: 422
                transactionId: x-x-x-x-transactionId-mock-x-x-x
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-1102]:  Unprocessable Entity. The property `bonus` is
                  required
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Неверный запрос.
    Promotions_422-admin-promotion-missed-items-property:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `items` is
                  required
                statusCode: 422
                transactionId: x-x-x-x-transactionId-mock-x-x-x
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-1102]:  Unprocessable Entity. The property `items` is
                  required
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Неверный запрос.
    Promotions_422-cancel-promo-code:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `id` is
                  required
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-1102]: Unprocessable Entity. The property `id` is
                  required
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Неверный запрос.
    Promotions_422-coupon-promocode-same-code-exists:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9803
                errorMessage: '[0401-9803]: The code already exists.'
                statusCode: 422
                transactionId: x-x-x-x-transactionId-mock-x-x-x
          schema:
            properties:
              errorCode:
                example: 9803
                type: integer
              errorMessage:
                example: '[0401-9803]: The code already exists.'
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Неверный запрос. Код уже существует.
    Promotions_422-invalid-coupon:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `external_id`
                  is required
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-1102]: Unprocessable Entity. The property `external_id`
                  is required
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: Неверный запрос.
    Promotions_422-redeem-coupon:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1102
                errorMessage: >-
                  [0401-1102]: Unprocessable Entity. The property `coupon_code`
                  is required
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 1102
                type: integer
              errorMessage:
                example: >-
                  [0401-1102]: Unprocessable Entity. The property `coupon_code`
                  is required
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: Неверный запрос.
    Promotions_422-rewards:
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/Promotions_422_limit_error'
              - $ref: '#/components/schemas/Promotions_422_reglock_error'
      description: Неверный запрос.
    Promotions_422-verify-promo-code:
      content:
        application/json:
          examples:
            code redemption limit:
              value:
                errorCode: 9804
                errorMessage: '[0401-9804]: You have reached the coupon redemption limit.'
                statusCode: 422
            regionally restricted:
              value:
                errorCode: 9808
                errorMessage: '[0401-9808]: Coupon is not available in your region.'
                statusCode: 422
          schema:
            properties:
              errorCode:
                type: integer
              errorMessage:
                type: string
              statusCode:
                type: integer
            type: object
      description: Код акции недействителен.
    Upsell-200-get-client-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: true
                items:
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Quantity of items in the upsell set
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: Big Rocket - description
                    groups:
                      - external_id: accessory
                        name:
                          en: accessory
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Big Rocket
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                          - quantity: 1
                            sku: com.xsolla.phys_good_1
                            type: physical_good
                          - bundle_type: standard
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/9676f06265375087e607cb79c5283688.png
                            name: Super Lootbox with items
                            quantity: 1
                            sku: com.xsolla.SuperLootboxBundle_1
                            type: bundle
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount: null
                        name: Bonus promotion
                    sku: com.xsolla.big_rocket_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                    vp_rewards: []
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Quantity of items in the upsell set
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Items rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    can_be_bought: true
                    description: description
                    groups:
                      - external_id: hair
                        name:
                          en: hair
                    image_url: http://image.png
                    is_free: false
                    limits: null
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods:
                      - date_from: '2020-08-11T20:00:00+03:00'
                        date_until: null
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.shotgun_raider_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_2
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        description: description
                        image_url: http://image.png
                        is_default: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_3
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: description
                    groups: []
                    image_url: http://image.png
                    is_free: true
                    limits: null
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods: []
                    price: null
                    promotions: []
                    sku: com.xsolla.shotgun_raider_2
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices: []
                    vp_rewards: []
          schema:
            $ref: '#/components/schemas/Upsell_item-list'
      description: Список товаров для апселла успешно получен.
    Upsell-404-item-not-found:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 9901
                errorMessage: '[0401-4001]: Items weren''t found: sku1, sku2'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-4001]: Items weren''t found: sku1, sku2'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Товар не найден.
    Upsell-422-invalid-request:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Upsell-422-invalid-request'
      description: Неверный запрос.
    Virtual-Items-Currency_200-admin-get-item:
      content:
        application/json:
          example:
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            custom_attributes:
              attr: value
              purchased: 0
            description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            groups:
              - external_id: accessory
                name:
                  en: accessory
              - external_id: weapon
                name:
                  en: weapon
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png
            is_enabled: true
            is_free: false
            is_show_in_store: true
            limits:
              per_item: null
              per_user:
                limit_exceeded_visibility: show
                total: 5
              recurrent_schedule:
                per_user:
                  displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                  displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                  interval_type: daily
                  reset_next_date: 1677553200
                  time: 11:00:00+08:00
            long_description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            media_list: []
            name:
              en: Sword Xsolla Skin
            order: 1
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            prices:
              - amount: 4.99
                country_iso: US
                currency: USD
                is_default: true
                is_enabled: true
            regions: []
            sku: com.xsolla.swords_1
            type: virtual_good
            vc_prices: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_admin-virtual-item'
      description: Указанный виртуальный предмет успешно получен.
    Virtual-Items-Currency_200-admin-get-virtual-currencies:
      content:
        application/json:
          example:
            items:
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                custom_attributes:
                  attr: value
                  purchased: 0
                description:
                  en: Main in-game currency
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                is_enabled: true
                is_free: false
                is_hard: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: null
                media_list: []
                name:
                  en: Crystals
                  ru: Crystals
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 1
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.crystal_1
                type: virtual_currency
                vc_prices: []
              - attributes: []
                description:
                  en: Money for in-store purchases
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                is_enabled: true
                is_free: false
                is_hard: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Gold
                  ru: Gold
                order: 1
                periods: []
                prices:
                  - amount: 1
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.gold_1
                type: virtual_currency
                vc_prices: []
          schema:
            properties:
              items:
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-currency
                type: array
            type: object
      description: Список виртуальных валют успешно получен.
    Virtual-Items-Currency_200-admin-get-virtual-currency:
      content:
        application/json:
          example:
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            custom_attributes:
              attr: value
              purchased: 0
            description:
              en: Main in-game currency
            groups: []
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
            is_enabled: true
            is_free: false
            is_hard: false
            is_show_in_store: true
            limits:
              per_item: null
              per_user: null
              recurrent_schedule: null
            long_description: null
            media_list: []
            name:
              en: Crystals
              ru: Crystals
            order: 1
            periods: []
            prices:
              - amount: 1
                country_iso: US
                currency: USD
                is_default: true
                is_enabled: true
            regions: []
            sku: com.xsolla.crystal_1
            type: virtual_currency
            vc_prices: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_admin-virtual-currency'
      description: Указанная виртуальная валюта успешно получена.
    Virtual-Items-Currency_200-admin-get-virtual-currency-package:
      content:
        application/json:
          example:
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value:
                      en-US: VALUE
                  - external_id: val2
                    value:
                      en-US: VALUE2
            bundle_type: virtual_currency_package
            content:
              - description:
                  en: Main in-game currency
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                name:
                  en: Crystals
                  ru: Crystals
                quantity: 100
                sku: com.xsolla.crystal_1
                type: virtual_currency
            custom_attributes:
              attr: value
              purchased: 0
            description:
              en: Crystals x100
            groups: []
            image_url: >-
              https://cdn3.xsolla.com/img/misc/images/a8682cea328afda0bd127d59eb5b9077.png
            is_enabled: true
            is_free: false
            is_show_in_store: true
            limits:
              per_item: null
              per_user: null
              recurrent_schedule: null
            long_description: null
            media_list: []
            name:
              en: Small crystal pack
            order: 1
            periods: []
            prices:
              - amount: 5
                country_iso: US
                currency: USD
                is_default: true
                is_enabled: true
            regions: []
            sku: com.xsolla.crystal_pack_1
            type: bundle
            vc_prices: []
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_admin-virtual-currency-package
      description: Указанный пакет виртуальной валюты успешно получен.
    Virtual-Items-Currency_200-admin-get-virtual-currency-packages:
      content:
        application/json:
          example:
            items:
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    name:
                      en: Crystals
                      ru: Crystals
                    quantity: 100
                    sku: com.xsolla.crystal_1
                    type: virtual_currency
                custom_attributes:
                  attr: value
                  purchased: 0
                description:
                  en: Crystals x100
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/a8682cea328afda0bd127d59eb5b9077.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: null
                media_list: []
                name:
                  en: Small crystal pack
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 5
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.crystal_pack_1
                type: bundle
                vc_prices: []
              - attributes: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    name:
                      en: Crystals
                      ru: Crystals
                    quantity: 500
                    sku: com.xsolla.crystal_2
                    type: virtual_currency
                description:
                  en: Crystals x500
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/431a40dd8c99290dd761508964ddbacf.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Medium crystal pack
                order: 1
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 20
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.crystal_pack_2
                type: bundle
                vc_prices: []
              - attributes: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Main in-game currency
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    name:
                      en: Crystals
                      ru: Crystals
                    quantity: 1500
                    sku: com.xsolla.crystal_3
                    type: virtual_currency
                description:
                  en: Crystals x1500
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/1d67a1d2f92d69e021a97effa692dff3.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Massive crystal pack
                order: 1
                periods: []
                prices:
                  - amount: 50
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.crystal_pack_3
                type: bundle
                vc_prices: []
              - attributes: []
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    name:
                      en: Gold
                      ru: Gold
                    quantity: 100
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                description:
                  en: Gold x100
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/09984ff0a3ae6b367c9c886b31366950.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Small gold pack
                order: 1
                periods: []
                prices:
                  - amount: 5
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.gold_pack_1
                type: bundle
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    name:
                      en: Gold
                      ru: Gold
                    quantity: 500
                    sku: com.xsolla.gold_2
                    type: virtual_currency
                description:
                  en: Gold x500
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/b5d8130bdaf28aa55c43a68aa3ca0ef4.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Medium gold pack
                order: 1
                periods: []
                prices:
                  - amount: 20
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.gold_pack_2
                type: bundle
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                bundle_type: virtual_currency_package
                content:
                  - description:
                      en: Money for in-store purchases
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/bc1bf2bdeca78515d5d15e545d6884be.png
                    name:
                      en: Gold
                      ru: Gold
                    quantity: 1500
                    sku: com.xsolla.gold_3
                    type: virtual_currency
                description:
                  en: Gold x1500
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/dea74a3667807d5502a4acb8f4c879ca.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description: null
                media_list: []
                name:
                  en: Large gold pack
                order: 1
                periods: []
                prices:
                  - amount: 50
                    country_iso: US
                    currency: USD
                    is_default: true
                    is_enabled: true
                regions: []
                sku: com.xsolla.gold_pack_3
                type: bundle
                vc_prices: []
          schema:
            properties:
              items:
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-currency-package
                type: array
            type: object
      description: Список пакетов виртуальной валюты успешно получен.
    Virtual-Items-Currency_200-admin-get-virtual-items:
      content:
        application/json:
          example:
            items:
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                custom_attributes:
                  attr: value
                  purchased: 0
                description:
                  en: Suit up with flair showcasing your allegiance to Xsolla
                groups:
                  - external_id: featured
                    name:
                      en: featured
                  - external_id: Xsolla
                    name:
                      en: Xsolla
                  - external_id: Premium
                    name:
                      en: Premium
                  - external_id: NonConsumableGroupCode
                    name:
                      en: Non-consumable
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user: null
                  recurrent_schedule: null
                long_description:
                  en: >-
                    The metal coverings formerly worn by soldiers or warriors to
                    protect the body in battle.
                media_list: []
                name:
                  en: Maximum Armor Xsolla  Skin
                order: 1
                periods: []
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    country_iso: CZ
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_max_1
                type: virtual_good
                vc_prices: []
              - attributes: []
                description:
                  en: A strong armor forged to withstand heavy attacks.
                groups:
                  - children: []
                    description:
                      en: Equipment
                    external_id: all
                    id: 10
                    image_url: null
                    is_enabled: true
                    level: 0
                    name:
                      en: Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: equipment
                    external_id: equipment
                    id: 14
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Nice Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: '1'
                    external_id: Empire
                    id: 17
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Empire
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: null
                media_list: []
                name:
                  en: Empire Maximum Armor
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    country_iso: CZ
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_max_2
                type: virtual_good
                vc_prices: []
              - attributes: []
                description:
                  en: >-
                    Moderately protect yourself against the Empires barrage of
                    attacks
                groups:
                  - children: []
                    description:
                      en: Equipment
                    external_id: all
                    id: 10
                    image_url: null
                    is_enabled: true
                    level: 0
                    name:
                      en: Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: Xsolla
                    external_id: Xsolla
                    id: 12
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Xsolla
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: equipment
                    external_id: equipment
                    id: 14
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Nice Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png
                is_enabled: true
                is_free: false
                is_show_in_store: false
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description:
                  en: >-
                    Armor is a security-as-a-service company that provides cloud
                    security and compliance solutions for small businesses and
                    enterprises.
                media_list: []
                name:
                  en: Xsolla Medium Armor
                order: 1
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    country_iso: CZ
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_med_1
                type: virtual_good
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                description:
                  en: Provides moderate protection in battle.
                groups:
                  - children: []
                    description:
                      en: Equipment
                    external_id: all
                    id: 10
                    image_url: null
                    is_enabled: true
                    level: 0
                    name:
                      en: Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: equipment
                    external_id: equipment
                    id: 14
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Nice Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: '1'
                    external_id: Empire
                    id: 17
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Empire
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: A strong armor forged to withstand heavy attacks.
                media_list: []
                name:
                  en: Empire Medium Armor
                order: 1
                periods: []
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_med_2
                type: virtual_good
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                description:
                  en: Provides moderate protection in battle.
                groups:
                  - children: []
                    description:
                      en: Equipment
                    external_id: all
                    id: 10
                    image_url: null
                    is_enabled: true
                    level: 0
                    name:
                      en: Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: equipment
                    external_id: equipment
                    id: 14
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Nice Equipment
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                  - children: []
                    description:
                      en: '1'
                    external_id: Empire
                    id: 17
                    image_url: null
                    is_enabled: false
                    level: 0
                    name:
                      en: Empire
                    order: 1
                    parent_external_id: null
                    parent_group_id: null
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      hours_interval: 8
                      interval_type: hourly
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: null
                media_list: []
                name:
                  en: Empire Large Armor
                order: 1
                periods: []
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_large_3
                type: virtual_good
                vc_prices: []
          schema:
            properties:
              items:
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-item
                type: array
            type: object
      description: Список виртуальных предметов успешно получен.
    Virtual-Items-Currency_200-admin-get-virtual-items-by-group:
      content:
        application/json:
          example:
            items:
              - attributes: []
                custom_attributes:
                  attr: value
                  purchased: 0
                description:
                  en: A strong armor forged to withstand heavy attacks
                groups:
                  - external_id: hair
                    name:
                      en: Hair
                  - external_id: accessory
                    name:
                      en: Accessory
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      day_of_month: 28
                      day_of_week: null
                      displayable_reset_next_date: '2023-03-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: monthly
                      reset_next_date: 1679972400
                      time: 11:00:00+08:00
                long_description: null
                media_list: []
                name:
                  en: Empire Maximum Armor
                order: 1
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 12.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    country_iso: CZ
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_max_2
                type: virtual_good
                vc_prices: []
              - attributes: []
                description:
                  en: >-
                    Moderately protect yourself against the Empires barrage of
                    attacks
                groups:
                  - external_id: hair
                    name:
                      en: Hair
                  - external_id: accessory
                    name:
                      en: Accessory
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png
                is_enabled: true
                is_free: false
                is_show_in_store: false
                limits:
                  per_item: null
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description:
                  en: >-
                    Armor is a security-as-a-service company that provides cloud
                    security and compliance solutions for small businesses and
                    enterprises.
                media_list: []
                name:
                  en: Xsolla Medium Armor
                order: 1
                periods:
                  - date_from: null
                    date_until: '2020-08-11T20:00:00+03:00'
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    country_iso: CZ
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_med_1
                type: virtual_good
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                description:
                  en: Provides moderate protection in battle.
                groups:
                  - external_id: hair
                    name:
                      en: Hair
                  - external_id: accessory
                    name:
                      en: Accessory
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      interval_type: daily
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: A strong armor forged to withstand heavy attacks.
                media_list: []
                name:
                  en: Empire Medium Armor
                order: 1
                periods: []
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_med_2
                type: virtual_good
                vc_prices: []
              - attributes:
                  - external_id: attr_1
                    name:
                      en-US: OK
                    values:
                      - external_id: val1
                        value:
                          en-US: VALUE
                      - external_id: val2
                        value:
                          en-US: VALUE2
                description:
                  en: Provides moderate protection in battle.
                groups:
                  - external_id: hair
                    name:
                      en: Hair
                  - external_id: accessory
                    name:
                      en: Accessory
                image_url: >-
                  https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png
                is_enabled: true
                is_free: false
                is_show_in_store: true
                limits:
                  per_item:
                    available: 455
                    reserved: 5
                    sold: 40
                    total: 500
                  per_user:
                    limit_exceeded_visibility: show
                    total: 5
                  recurrent_schedule:
                    per_user:
                      displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                      displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                      hours_interval: 8
                      interval_type: hourly
                      reset_next_date: 1677553200
                      time: 11:00:00+08:00
                long_description: A strong armor forged to withstand heavy attacks.
                media_list: []
                name:
                  en: Empire Large Armor
                order: 1
                periods: []
                prices:
                  - amount: 4.99
                    currency: USD
                    is_default: true
                    is_enabled: true
                  - amount: 20.99
                    currency: CZK
                    is_default: false
                    is_enabled: true
                regions: []
                sku: com.xsolla.armor_lrg_2
                type: virtual_good
                vc_prices: []
          schema:
            properties:
              items:
                items:
                  $ref: >-
                    #/components/schemas/Virtual-Items-Currency_admin-virtual-item
                type: array
            type: object
      description: Список виртуальных предметов успешно получен.
    Virtual-Items-Currency_200-get-all-items-list:
      content:
        application/json:
          examples:
            response:
              value:
                items:
                  - description: Big Rocket - description
                    groups:
                      - external_id: accessory
                        name:
                          en: Accessory
                    name: Big Rocket
                    sku: com.xsolla.big_rocket_1
                  - description: description
                    groups:
                      - external_id: hair
                        name:
                          en: Hair
                    name: SHOTGUN FOR TRUE RAIDERS
                    sku: com.xsolla.shotgun_raider_1
                  - description: description
                    groups: []
                    name: SHOTGUN FOR TRUE RAIDERS
                    sku: com.xsolla.shotgun_raider_2
          schema:
            description: Объект с виртуальными предметами.
            properties:
              items:
                example:
                  - description: Big Rocket - description
                    groups:
                      - external_id: accessory
                        name:
                          en: accessory
                    name: Big Rocket
                    sku: com.xsolla.big_rocket_1
                  - description: description
                    groups:
                      - external_id: hair
                        name:
                          en: Hair
                    name: SHOTGUN FOR TRUE RAIDERS
                    sku: com.xsolla.shotgun_raider_1
                  - description: description
                    groups: []
                    name: SHOTGUN FOR TRUE RAIDERS
                    sku: com.xsolla.shotgun_raider_2
                items:
                  properties:
                    description:
                      description: Описание товара.
                      example: Big Rocket - description
                      type: string
                    groups:
                      properties:
                        external_id:
                          example: weapons
                          type: string
                        name:
                          additionalProperties:
                            nullable: true
                            type: string
                          type: object
                      type: array
                    name:
                      description: Название товара.
                      example: Big Rocket
                      type: string
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: com.xsolla.big_rocket_1
                      type: string
                  type: object
                type: array
            type: object
      description: Список всех виртуальных предметов успешно получен.
    Virtual-Items-Currency_200-get-item-by-sku:
      content:
        application/json:
          example:
            attributes:
              - external_id: attr_1
                name:
                  en-US: OK
                values:
                  - external_id: val1
                    value: VALUE
                  - external_id: val2
                    value: VALUE2
            can_be_bought: true
            custom_attributes:
              attr: value
              purchased: 0
            description:
              en: >-
                Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword
                - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional,
                Battle Ready - Black TPR, Steel Guard and Pommel
            groups:
              - external_id: weapons
                name: weapons
            image_url: >-
              https://cdn.xsolla.net/img/misc/images/8ab44fe99038a56de01950ba4a971b77.png
            is_free: false
            item_id: 488833
            limits:
              per_item: null
              per_user:
                available: 1
                limit_exceeded_visibility: show
                recurrent_schedule:
                  interval_type: weekly
                  reset_next_date: 1761840000
                total: 3
            name:
              en: Sword Xsolla Skin
            periods:
              - date_from: '2020-08-11T10:00:00+03:00'
                date_until: '2020-08-11T20:00:00+03:00'
            price:
              amount: '4.99'
              amount_without_discount: '4.99'
              currency: USD
            promotions: []
            sku: com.xsolla.swords_1
            type: virtual_good
            virtual_item_type: non_consumable
            virtual_prices: []
            vp_rewards: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_item'
      description: Виртуальный товар был успешно получен.
    Virtual-Items-Currency_200-get-items-by-group-id:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: Big Rocket - description
                    groups:
                      - external_id: weapons
                        item_order_in_group: 1
                        name: weapons
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Big Rocket
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.big_rocket_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    can_be_bought: true
                    description: description
                    groups:
                      - external_id: weapons
                        item_order_in_group: 2
                        name: weapons
                    image_url: http://image.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods: []
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.shotgun_raider_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        description: description
                        image_url: http://image.png
                        is_default: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_2
                        type: virtual_currency
                    vp_rewards: []
          schema:
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                example:
                  - attributes:
                      - external_id: stack_size
                        name: Stack size
                        values:
                          - value: '5'
                    can_be_bought: true
                    description: Big Rocket - description
                    groups:
                      - external_id: weapons
                        name: weapons
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    limits:
                      per_item: null
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Big Rocket
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.big_rocket_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                  - attributes:
                      - external_id: stack_size
                        name: Stack size
                        values:
                          - value: '5'
                      - external_id: rating
                        name: Rating
                        values:
                          - value: '3.9'
                      - external_id: genre
                        name: Genre
                        values:
                          - value: Strategy
                          - value: Tactical
                          - Turn-based
                    can_be_bought: true
                    description: description
                    groups:
                      - external_id: weapons
                        name:
                          en: weapons
                    image_url: http://image.png
                    is_free: false
                    limits: null
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods: []
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.shotgun_raider
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        description: description
                        image_url: http://image.png
                        is_default: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_2
                        type: virtual_currency
                items:
                  properties:
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    can_be_bought:
                      $ref: '#/components/schemas/Can_be_bought'
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    description:
                      description: Описание товара.
                      example: Big Rocket - description
                      type: string
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    image_url:
                      description: URL-адрес изображения.
                      example: >-
                        https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      description: Название товара.
                      example: Big Rocket
                      type: string
                    periods:
                      $ref: '#/components/schemas/item-periods-response'
                    price:
                      description: Цены на товар.
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '100.99'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '100.99'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: com.xsolla.big_rocket_1
                      type: string
                    type:
                      description: >-
                        Тип предмета:
                        `consumable`/`expiration`/`permanent`/`lootboxes`/`physical`.
                      example: virtual_good
                      type: string
                    virtual_item_type:
                      description: Тип виртуального предмета.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                      example: non_consumable
                      type: string
                      x-enumDescriptions:
                        consumable: >-
                          Предмет исчезает из инвентаря после использования
                          (например, патроны).
                        non_consumable: >-
                          Предмет остается в инвентаре в течение неограниченного
                          времени.
                        non_renewing_subscription: >-
                          Предмет с ограниченным сроком действия, который может
                          служить представлением доступа к сервисам или контенту
                          в течение ограниченного периода времени.
                    virtual_prices:
                      description: Виртуальные цены.
                      items:
                        description: Виртуальная цена.
                        properties:
                          amount:
                            description: Цена товара со скидкой в виртуальной валюте.
                            example: 100
                            type: integer
                          amount_without_discount:
                            description: Цена товара.
                            example: 200
                            type: integer
                          description:
                            description: Описание виртуальной валюты.
                            example: Big Rocket - description
                            type: string
                          image_url:
                            example: http://image.png
                            type: string
                          is_default:
                            description: Является ли данная цена товара ценой по умолчанию.
                            example: true
                            type: boolean
                          name:
                            description: Название виртуальной валюты.
                            example: SHOTGUN FOR TRUE RAIDERS
                            type: string
                          sku:
                            description: Артикул виртуальной валюты.
                            example: com.xsolla.vc_1
                            type: string
                          type:
                            description: Тип виртуальной валюты.
                            example: virtual_currency
                            type: string
                        type: object
                      type: array
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
            type: object
      description: Список предметов из указанной группы успешно получен.
    Virtual-Items-Currency_200-get-items-groups:
      content:
        application/json:
          examples:
            response:
              value:
                groups:
                  - children: []
                    description: Accessory
                    external_id: accessory
                    image_url: null
                    level: 0
                    name: Accessory
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Background
                    external_id: background
                    image_url: null
                    level: 0
                    name: Background
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Hair
                    external_id: hair
                    image_url: null
                    level: 0
                    name: Hair
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Outfit
                    external_id: outfit
                    image_url: null
                    level: 0
                    name: Outfit
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Body
                    external_id: body
                    image_url: null
                    level: 0
                    name: Body
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Body
                    external_id: delete_group
                    image_url: null
                    level: 0
                    name: Body
                    order: 1
                    parent_external_id: null
                  - children:
                      - children: []
                        description: Group description
                        external_id: test_group_secure
                        image_url: http://static.xsolla.com/img/xsolla-logo2.png
                        level: 1
                        name: Test group secure
                        order: 5
                        parent_external_id: very_cool_group
                    description: Very cool group
                    external_id: very_cool_group
                    image_url: null
                    level: 0
                    name: Very cool group
                    order: 1
                    parent_external_id: null
                  - children:
                      - children: []
                        description: Group description
                        external_id: test_group_split
                        image_url: http://static.xsolla.com/img/xsolla-logo2.png
                        level: 1
                        name: Test group secure
                        order: 1
                        parent_external_id: test_group_secure
                    description: Group description
                    external_id: test_group_secure
                    image_url: http://static.xsolla.com/img/xsolla-logo2.png
                    level: 0
                    name: Test group secure
                    order: 1
                    parent_external_id: null
          schema:
            properties:
              groups:
                example:
                  - children:
                      - children:
                          - children: []
                            description: Accessory
                            external_id: accessory
                            image_url: null
                            level: 2
                            name: Accessory
                            order: 1
                            parent_external_id: background
                        description: Background description
                        external_id: background
                        image_url: null
                        level: 1
                        name: Background
                        order: 1
                        parent_external_id: hair
                    description: Hair description
                    external_id: hair
                    image_url: null
                    level: 0
                    name: Hair
                    order: 1
                    parent_external_id: null
                  - children: []
                    description: Super description
                    external_id: group_external_id
                    image_url: null
                    level: 0
                    name: Super
                    order: 1
                    parent_external_id: null
                items:
                  properties:
                    children:
                      description: Дочерние группы.
                      example:
                        - children:
                            - children: []
                              description: Accessory
                              external_id: accessory
                              image_url: null
                              level: 2
                              name: Accessory
                              order: 1
                              parent_external_id: background
                          description: Background description
                          external_id: background
                          image_url: null
                          level: 1
                          name: Background
                          order: 1
                          parent_external_id: hair
                      items:
                        properties:
                          children:
                            description: Дочерние группы.
                            example:
                              - children: []
                                description: Accessory
                                external_id: accessory
                                image_url: null
                                level: 2
                                name: Accessory
                                order: 1
                                parent_external_id: background
                            items:
                              properties:
                                children:
                                  description: Дочерние группы.
                                  example: []
                                  items:
                                    type: string
                                  type: array
                                description:
                                  description: Описание группы.
                                  example: Accessory
                                  type: string
                                external_id:
                                  description: External ID группы.
                                  example: accessory
                                  type: string
                                image_url:
                                  description: URL-адрес изображения.
                                  example: null
                                  nullable: true
                                  type: string
                                level:
                                  description: Уровень вложенности группы.
                                  example: 2
                                  type: integer
                                name:
                                  description: Название группы.
                                  example: Accessory
                                  type: string
                                order:
                                  description: Определяет порядок расположения.
                                  example: 1
                                  type: integer
                                parent_external_id:
                                  description: Путь к каталогу (родительская папка группы).
                                  example: background
                                  nullable: true
                                  type: string
                              type: object
                            type: array
                          description:
                            description: Описание группы.
                            example: Background description
                            type: string
                          external_id:
                            description: External ID группы.
                            example: background
                            type: string
                          image_url:
                            description: URL-адрес изображения группы.
                            example: null
                            nullable: true
                            type: string
                          level:
                            description: Уровень вложенности группы.
                            example: 1
                            type: integer
                          name:
                            description: Название группы.
                            example: Background
                            type: string
                          order:
                            description: Определяет порядок расположения.
                            example: 1
                            type: integer
                          parent_external_id:
                            description: Путь к каталогу (родительская папка группы).
                            example: hair
                            nullable: true
                            type: string
                        type: object
                      type: array
                    description:
                      description: Описание группы.
                      example: Hair description
                      type: string
                    external_id:
                      description: External ID группы.
                      example: hair
                      type: string
                    image_url:
                      description: URL-адрес изображения.
                      example: null
                      nullable: true
                      type: string
                    level:
                      description: Уровень вложенности группы.
                      example: 0
                      type: integer
                    name:
                      description: Название группы.
                      example: Hair
                      type: string
                    order:
                      description: Определяет порядок расположения.
                      example: 1
                      type: integer
                    parent_external_id:
                      description: Путь к каталогу (родительская папка группы).
                      example: null
                      nullable: true
                      type: string
                  type: object
                type: array
            type: object
      description: Список групп успешно получен.
    Virtual-Items-Currency_200-get-items-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: true
                items:
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description:
                      en: Big Rocket - description
                    groups:
                      - external_id: accessory
                        item_order_in_group: 1
                        name: accessory
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name:
                      en: Big Rocket
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                          - quantity: 1
                            sku: com.xsolla.phys_good_1
                            type: physical_good
                          - bundle_type: standard
                            image_url: >-
                              https://cdn.xsolla.net/img/misc/images/9676f06265375087e607cb79c5283688.png
                            name: Super Lootbox with items
                            quantity: 1
                            sku: com.xsolla.SuperLootboxBundle_1
                            type: bundle
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount: null
                        name: Bonus promotion
                    sku: com.xsolla.big_rocket_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                    vp_rewards: []
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    can_be_bought: true
                    description:
                      en: description
                    groups:
                      - external_id: hair
                        item_order_in_group: 1
                        name: hair
                    image_url: http://image.png
                    is_free: false
                    limits: null
                    name:
                      en: SHOTGUN FOR TRUE RAIDERS
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.shotgun_raider_1
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_1
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        description: description
                        image_url: http://image.png
                        is_default: false
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.vc_2
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description:
                      en: description
                    groups: []
                    image_url: http://image.png
                    is_free: true
                    limits: null
                    name:
                      en: SHOTGUN FOR TRUE RAIDERS
                    periods: []
                    price: null
                    promotions: []
                    sku: com.xsolla.shotgun_raider_2
                    type: virtual_good
                    virtual_item_type: non_renewing_subscription
                    virtual_prices: []
                    vp_rewards: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_item-list'
      description: Список виртуальных предметов успешно получен.
    Virtual-Items-Currency_200-get-virtual-currency:
      content:
        application/json:
          examples:
            response:
              value:
                attributes:
                  - external_id: attr1
                    name:
                      en-US: Attribute
                    values:
                      - external_id: val1
                        value: Value
                      - external_id: val2
                        value: Value
                can_be_bought: true
                custom_attributes:
                  attr: value
                  purchased: 0
                description: Crystals - short description
                groups: []
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                is_free: false
                item_id: 451414
                limits: null
                name: Crystals
                periods:
                  - date_from: '2023-08-11T10:00:00+03:00'
                    date_until: '2023-08-11T20:00:00+03:00'
                price:
                  amount: '100'
                  amount_without_discount: '100'
                  currency: USD
                promotions: []
                sku: com.xsolla.crystal_1
                type: virtual_currency
                virtual_prices: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency'
      description: Виртуальная валюта была успешно получена.
    Virtual-Items-Currency_200-get-virtual-currency-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: Big Rocket - short description
                    groups:
                      - external_id: weapons
                        item_order_in_group: 1
                        name: weapons
                    image_url: >-
                      https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                    is_free: false
                    limits: null
                    name: Big Rocket
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '100.99'
                      amount_without_discount: '100.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.big_rocket_1
                    type: virtual_currency
                    virtual_prices:
                      - amount: 100
                        amount_without_discount: 100
                        description: description
                        image_url: http://image.png
                        is_default: true
                        name: SHOTGUN FOR TRUE RAIDERS
                        sku: com.xsolla.shotgun_raider_1
                        type: virtual_currency
                    vp_rewards: []
                  - attributes:
                      - external_id: stack_size
                        name:
                          en: Stack size
                        values:
                          - external_id: size_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '5'
                      - external_id: rating
                        name:
                          en: Rating
                        values:
                          - external_id: rating_e3364991f92e751689a68b96598a5a5a84010b85
                            value: '3.9'
                    can_be_bought: true
                    description: description
                    groups:
                      - external_id: weapons
                        item_order_in_group: 2
                        name: weapons
                    image_url: http://image.png
                    is_free: false
                    limits: null
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '101.0'
                      amount_without_discount: '101.0'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.shotgun_raider_2
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: description
                    groups: []
                    image_url: http://image.png
                    is_free: true
                    limits: null
                    name: SHOTGUN FOR TRUE RAIDERS
                    periods: []
                    price: null
                    promotions: []
                    sku: com.xsolla.shotgun_raider_3
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency-list'
      description: Список виртуальных валют успешно получен.
    Virtual-Items-Currency_200-get-virtual-currency-package:
      content:
        application/json:
          examples:
            response:
              value:
                attributes: []
                bundle_type: virtual_currency_package
                can_be_bought: true
                content:
                  - description: Crystal - short description
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/da33ab6cc1d7e5899cfdc5b6b6180fad.png
                    item_id: 488831
                    limits: null
                    name: Crystals
                    quantity: 10
                    sku: com.xsolla.crystals_1
                    type: virtual_currency
                custom_attributes:
                  attr: value
                  purchased: 0
                description: Crystal Pack Short Description
                groups: []
                image_url: http://vc_package_image.png
                is_free: false
                item_id: 488832
                limits:
                  per_item: null
                  per_user:
                    available: 1
                    limit_exceeded_visibility: show
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1690732800
                    total: 1
                name: Crystal Pack
                periods:
                  - date_from: '2020-08-11T10:00:00+03:00'
                    date_until: '2020-08-11T20:00:00+03:00'
                price:
                  amount: '100'
                  amount_without_discount: '100'
                  currency: USD
                promotions: []
                sku: com.xsolla.crystal_pack_1
                type: bundle
                virtual_prices: []
                vp_rewards: []
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-package
      description: Пакет виртуальной валюты был успешно получен.
    Virtual-Items-Currency_200-get-virtual-currency-packages-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: Big Rocket - short description
                        image_url: >-
                          https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                        name: Big Rocket
                        quantity: 100
                        sku: com.xsolla.big_rocket_1
                        type: virtual_currency
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: VC Short Package Description
                    groups:
                      - external_id: gift
                        item_order_in_group: 1
                        name: Gift
                    image_url: http://vc_package_image.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: VC Name first package
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '2.0000'
                      amount_without_discount: '2.0000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.vc_package_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: description
                        image_url: http://image.png
                        name: SHOTGUN FOR TRUE RAIDERS
                        quantity: 200
                        sku: com.xsolla.shotgun_raider_1
                        type: virtual_currency
                    description: VC Short Package Description
                    groups:
                      - external_id: gift
                        item_order_in_group: 2
                        name: Gift
                    image_url: http://vc_package_image.png
                    is_free: false
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: VC Name third package
                    periods:
                      - date_from: null
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '4.0000'
                      amount_without_discount: '4.0000'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.vc_package_3
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
          schema:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-packages
      description: Список пакетов виртуальной валюты успешно получен.
    Virtual-Items-Currency_200-quick-purchase:
      content:
        application/json:
          examples:
            response:
              value:
                order_id: 641
          schema:
            properties:
              order_id:
                description: ID заказа.
                type: integer
            type: object
      description: Успешная быстрая виртуальная покупка.
    Virtual-Items-Currency_201-created:
      content:
        application/json:
          examples:
            response:
              value:
                sku: com.xsolla.item_1
          schema:
            example:
              sku: com.xsolla.item_1
            properties:
              sku:
                example: new-sku
                type: string
            type: object
      description: Виртуальный предмет успешно создан.
    Virtual-Items-Currency_401-invalid-basic-auth:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1020
                errorMessage: '[0401-1020]: Error in Authentication method occurred'
                statusCode: 401
          schema:
            properties:
              errorCode:
                example: 1020
                type: integer
              errorMessage:
                example: '[0401-1020]: Error in Authentication method occurred'
                type: string
              statusCode:
                example: 401
                type: integer
            type: object
      description: >-
        Данные для базовой аутентификации не переданы или ошибочны. Убедитесь,
        что использовали базовую аутентификацию и проверьте правильность учетных
        данных.
    Virtual-Items-Currency_404-item:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: >-
                  [0401-4001]: Item with Project Id = 44056 and Sku =
                  booster_mega_12222 not found
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Товар не найден. Убедитесь, что верно указали `project_id` и `item_sku`.
    Virtual-Items-Currency_404-item-group:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 4403
                errorMessage: '[0401-4403]: Item group not found'
                statusCode: 404
          schema:
            properties:
              errorCode:
                example: 4403
                type: integer
              errorMessage:
                example: '[0401-4403]: Item group not found'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: >-
        Группа не найдена. Убедитесь, что верно указали `external_id` и группа
        не отключена и не удалена.
    Virtual-Items-Currency_422-invalid-request:
      content:
        application/json:
          examples:
            Custom attributes JSON can’t exceed 500 characters:
              $ref: '#/components/examples/422-custom-attributes-size-exceeded'
            Numbers of attribute values per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attribute-values-per-item-exceeded
            Numbers of attributes per item exceeded:
              $ref: >-
                #/components/examples/422-numbers-of-attributes-per-item-exceeded
            The property `sku` is required:
              $ref: '#/components/examples/422-property-sku-is-required'
            Value limit exceeded:
              $ref: '#/components/examples/422-value-limit-exceeded'
          schema:
            $ref: '#/components/schemas/Virtual-Items-Currency_422-invalid-request'
      description: Неверный запрос.
    Virtual-Items-Currency_422-not-enough-virtual-currency:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 5006
                errorMessage: '[0401-5006]: Not enough virtual currency'
                statusCode: 422
          schema:
            properties:
              errorCode:
                example: 5006
                type: integer
              errorMessage:
                example: '[0401-5006]: Not enough virtual currency'
                type: string
              statusCode:
                example: 422
                type: integer
            type: object
      description: Недостаточно виртуальной валюты.
    connector-422-validation-failed:
      content:
        application/json:
          examples:
            response:
              value:
                errorCode: 1803
                errorMessage: >-
                  [0410-1803]: File content-type doesn't allowed. Allowed
                  content types: application/json; current content type:
                  text/plain
                statusCode: 422
                transactionId: x-x-x-x-transactionId-mock-x-x-x
          schema:
            properties:
              errorCode:
                example: 1803
                type: integer
              errorMessage:
                example: >-
                  [0410-1803]: File content-type doesn't allowed. Allowed
                  content types: application/json; current content type:
                  text/plain
                type: string
              statusCode:
                example: 422
                type: integer
              transactionId:
                example: x-x-x-x-transactionId-mock-x-x-x
                type: string
            type: object
      description: >-
        Ошибка валидации, вызванная некорректными параметрами тела запроса,
        свойствами файла или содержимым файла.
    sellable-item-by-id_404:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-4001]: Item with id = 259774 not found'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Товар не найден. Убедитесь, что верно указали `project_id` и `item_id`.
    sellable-item-by-sku_404:
      content:
        application/json:
          schema:
            properties:
              errorCode:
                example: 4001
                type: integer
              errorMessage:
                example: '[0401-4001]: Item with sku = ''electric_shiel'' not found'
                type: string
              statusCode:
                example: 404
                type: integer
            type: object
      description: Товар не найден. Убедитесь, что верно указали `project_id` и `sku`.
    sellable_items_200-get-item-by-id:
      content:
        application/json:
          examples:
            response:
              value:
                attributes: []
                can_be_bought: true
                custom_attributes:
                  attr: value
                  purchased: 0
                description: Electric shield
                groups:
                  - external_id: armour
                    item_order_in_group: 10
                    name: Armour
                image_url: >-
                  https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                is_free: false
                item_id: 259774
                limits:
                  per_user:
                    available: 3
                    limit_exceeded_visibility: show
                    recurrent_schedule:
                      interval_type: weekly
                      reset_next_date: 1746057600
                    total: 5
                name: Electric shield
                price:
                  amount: '9.99'
                  amount_without_discount: '9.99'
                  currency: USD
                promotions:
                  - bonus:
                      - image_url: >-
                          https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                        name: Xsolla Minigun
                        quantity: 1
                        sku: com.xsolla.minigun_1
                        type: virtual_good
                    date_end: '2026-04-15T16:16:00+03:00'
                    date_start: '2020-04-15T16:16:00+03:00'
                    discount:
                      percent: '50.00'
                    name: Bonus promotion
                sku: com.xsolla.electric_shield_1
                type: virtual_good
                virtual_item_type: non_consumable
                virtual_prices:
                  - amount: 10
                    amount_without_discount: 10
                    calculated_price:
                      amount: '10.00'
                      amount_without_discount: '10.00'
                    description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    is_default: true
                    item_id: 259765
                    name: Gold
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                  - amount: 20
                    amount_without_discount: 20
                    calculated_price:
                      amount: '20.00'
                      amount_without_discount: '20.00'
                    description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    is_default: false
                    item_id: 259766
                    name: Silver
                    sku: com.xsolla.silver_1
                    type: virtual_currency
                  - amount: 200
                    amount_without_discount: 200
                    calculated_price:
                      amount: '200.00'
                      amount_without_discount: '200.00'
                    description: null
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    is_default: false
                    item_id: 259767
                    name: Bronze
                    sku: com.xsolla.bronze_1
                    type: virtual_currency
                vp_rewards:
                  - amount: 130
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    item_id: 175232
                    name: Value point
                    sku: com.xsolla.value_point_1
                  - amount: 50
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                    is_clan: true
                    item_id: 186321
                    name: Clan Reward VP 1
                    sku: com.xsolla.clan_value_point_1
          schema:
            description: Объект с продаваемым товаром.
            properties:
              attributes:
                $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
              can_be_bought:
                description: Если `true`, пользователь может купить товар.
                example: true
                type: boolean
              custom_attributes:
                $ref: '#/components/schemas/item-custom-attributes-response'
              description:
                description: Описание товара.
                example: Electric shield
                type: string
              groups:
                $ref: '#/components/schemas/items_client_groups_response'
              image_url:
                description: URL-адрес изображения.
                example: >-
                  https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                type: string
              is_free:
                $ref: '#/components/schemas/value-is_free'
              item_id:
                description: >-
                  Внутренний уникальный ID товара, который задается при создании
                  товара.
                example: 259774
                type: integer
              limits:
                $ref: '#/components/schemas/Catalog_item_limits'
              name:
                description: Название товара.
                example: Electric shield
                type: string
              price:
                description: Цены на товар.
                properties:
                  amount:
                    description: Цена товара со скидкой.
                    example: '9.99'
                    type: string
                  amount_without_discount:
                    description: Цена товара.
                    example: '9.99'
                    type: string
                  currency:
                    description: >-
                      Валюта, в которой указана цена товара. Трехбуквенный код в
                      соответствии со стандартом [ISO
                      4217](https://en.wikipedia.org/wiki/ISO_4217).
                    example: USD
                    type: string
                type: object
              promotions:
                $ref: '#/components/schemas/Catalog_item_promotions'
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: electric_shield
                type: string
              type:
                description: >-
                  Тип товара:
                  `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                enum:
                  - virtual_good
                  - virtual_currency
                  - bundle
                  - game_key
                  - physical_good
                example: virtual_good
                type: string
              virtual_item_type:
                description: Тип виртуального предмета.
                enum:
                  - consumable
                  - non_consumable
                  - non_renewing_subscription
                example: non-consumable
                type: string
                x-enumDescriptions:
                  consumable: >-
                    Предмет исчезает из инвентаря после использования (например,
                    патроны).
                  non_consumable: >-
                    Предмет остается в инвентаре в течение неограниченного
                    времени.
                  non_renewing_subscription: >-
                    Предмет с ограниченным сроком действия, который может
                    служить представлением доступа к сервисам или контенту в
                    течение ограниченного периода времени.
              virtual_prices:
                description: Виртуальные цены.
                items:
                  description: Виртуальная цена.
                  properties:
                    amount:
                      description: Цена товара со скидкой в виртуальной валюте.
                      example: 10
                      type: integer
                    amount_without_discount:
                      description: Цена товара.
                      example: 10
                      type: integer
                    calculated_price:
                      properties:
                        amount:
                          type: string
                        amount_without_discount:
                          type: string
                      type: object
                    description:
                      description: Описание виртуальной валюты.
                      example: null
                      nullable: true
                      type: string
                    image_url:
                      description: Изображение виртуальной валюты.
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                      type: string
                    is_default:
                      description: Является ли данная цена товара ценой по умолчанию.
                      example: true
                      type: boolean
                    item_id:
                      description: >-
                        Внутренний уникальный ID товара, который задается при
                        создании товара.
                      example: 259774
                      type: integer
                    name:
                      description: Название виртуальной валюты.
                      example: Gold
                      type: string
                    sku:
                      description: Артикул виртуальной валюты.
                      example: gold
                      type: string
                    type:
                      description: Тип виртуальной валюты.
                      example: virtual_currency
                      type: string
                  type: object
                type: array
              vp_rewards:
                $ref: '#/components/schemas/client-item-value-point-reward'
            type: object
      description: Продаваемый товар успешно получен.
    sellable_items_200-get-items-by-group-id:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: true
                items:
                  - attributes: []
                    can_be_bought: true
                    description: Electric shield
                    groups:
                      - external_id: armour
                        item_order_in_group: 1
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    is_free: false
                    item_id: 259774
                    name: Electric shield
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.electric_shields_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_1
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_1
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_1
                        type: virtual_currency
                  - attributes: []
                    can_be_bought: true
                    description: Royal shield
                    groups:
                      - external_id: armour
                        item_order_in_group: 2
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    is_free: false
                    item_id: 259775
                    name: Royal shield
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_1
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_1
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_1
                        type: virtual_currency
                  - attributes: []
                    can_be_bought: true
                    description: Ancient helmet
                    groups:
                      - external_id: armour
                        item_order_in_group: 3
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    is_free: false
                    item_id: 259776
                    name: Ancient helmet
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                      - amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                  - attributes: []
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: Wooden helmet
                    groups:
                      - external_id: armour
                        item_order_in_group: 4
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    is_free: false
                    item_id: 259777
                    limits:
                      per_user:
                        available: 3
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Wooden helmet
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.wooden_helmet_2
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_3
                        type: virtual_currency
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_3
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_3
                        type: virtual_currency
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
          schema:
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                example:
                  - attributes: []
                    can_be_bought: true
                    description: Electric shield
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    is_free: false
                    item_id: 259774
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Electric shield
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.electric_shield_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_1
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_1
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_1
                        type: virtual_currency
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: clan_value_point_sku_1
                  - attributes: []
                    can_be_bought: true
                    description: Royal shield
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    is_free: false
                    item_id: 259775
                    name: Royal shield
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Ancient helmet
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    is_free: false
                    item_id: 259776
                    name: Ancient helmet
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_3
                        type: virtual_currency
                      - amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_3
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_3
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Wooden helmet
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    is_free: false
                    item_id: 259777
                    name: Wooden helmet
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_4
                        type: virtual_currency
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_4
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_4
                        type: virtual_currency
                    vp_rewards: []
                items:
                  properties:
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    can_be_bought:
                      description: Если `true`, пользователь может купить товар.
                      example: true
                      type: boolean
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    description:
                      description: Описание товара.
                      example: Electric shield
                      nullable: true
                      type: string
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    image_url:
                      description: URL-адрес изображения.
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    item_id:
                      description: >-
                        Внутренний уникальный ID товара, который задается при
                        создании товара.
                      example: 259774
                      type: integer
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      description: Название товара.
                      example: Electric shield
                      type: string
                    price:
                      description: Цены на товар.
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '9.99'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '9.99'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: com.xsolla.electric_shield_1
                      type: string
                    type:
                      description: >-
                        Тип товара:
                        `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                      enum:
                        - virtual_good
                        - virtual_currency
                        - bundle
                        - game_key
                        - physical_good
                      example: virtual_good
                      type: string
                    virtual_item_type:
                      description: Тип виртуального предмета.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                      example: non_consumable
                      type: string
                      x-enumDescriptions:
                        consumable: >-
                          Предмет исчезает из инвентаря после использования
                          (например, патроны).
                        non_consumable: >-
                          Предмет остается в инвентаре в течение неограниченного
                          времени.
                        non_renewing_subscription: >-
                          Предмет с ограниченным сроком действия, который может
                          служить представлением доступа к сервисам или контенту
                          в течение ограниченного периода времени.
                    virtual_prices:
                      description: Виртуальные цены.
                      items:
                        description: Виртуальная цена.
                        properties:
                          amount:
                            description: Цена товара со скидкой в виртуальной валюте.
                            example: 10
                            type: integer
                          amount_without_discount:
                            description: Цена товара.
                            example: 10
                            type: integer
                          calculated_price:
                            properties:
                              amount:
                                type: string
                              amount_without_discount:
                                type: string
                            type: object
                          description:
                            description: Описание виртуальной валюты.
                            example: null
                            nullable: true
                            type: string
                          image_url:
                            example: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            type: string
                          is_default:
                            description: Является ли данная цена товара ценой по умолчанию.
                            example: true
                            type: boolean
                          item_id:
                            description: >-
                              Внутренний уникальный ID товара, который задается
                              при создании товара.
                            example: 259774
                            type: integer
                          name:
                            description: Название виртуальной валюты.
                            example: Gold
                            type: string
                          sku:
                            description: Артикул виртуальной валюты.
                            example: com.xsolla.gold_1
                            type: string
                          type:
                            description: Тип виртуальной валюты.
                            example: virtual_currency
                            type: string
                        type: object
                      type: array
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
            type: object
      description: Список продаваемых товаров из указанной группы успешно получен.
    sellable_items_200-get-items-list:
      content:
        application/json:
          examples:
            response:
              value:
                has_more: false
                items:
                  - attributes: []
                    can_be_bought: true
                    custom_attributes:
                      attr: value
                      purchased: 0
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    is_free: false
                    item_id: 259765
                    limits: null
                    name: Gold
                    price:
                      amount: '1.00'
                      amount_without_discount: '1.00'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes: []
                    can_be_bought: true
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    is_free: false
                    item_id: 259766
                    name: Silver
                    price:
                      amount: '0.50'
                      amount_without_discount: '0.50'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.silver_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    is_free: false
                    item_id: 259767
                    name: Bronze
                    price:
                      amount: '0.10'
                      amount_without_discount: '0.10'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.bronze_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        name: Gold
                        quantity: 10
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                    description: Chest of gold
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/61b8d0785093017ce1f50ebed55c42a9.png
                    is_free: false
                    item_id: 259768
                    name: Chest of gold
                    price:
                      amount: '7.99'
                      amount_without_discount: '7.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.gold_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        name: Silver
                        quantity: 50
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                    description: Chest of silver
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                    is_free: false
                    item_id: 259769
                    name: Chest of silver
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.silver_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        name: Bronze
                        quantity: 100
                        sku: com.xsolla.bronze_1
                        type: virtual_currency
                    description: Chest of bronze
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                    is_free: false
                    item_id: 259770
                    name: Chest of bronze
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.bronze_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Sword
                    groups:
                      - external_id: swords
                        item_order_in_group: 1
                        name: Swords
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/a558727a420cad609556e4449b9ecb12.png
                    is_free: false
                    item_id: 259771
                    name: Sword
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.sword_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                      - amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                      - amount: 50
                        amount_without_discount: 50
                        calculated_price:
                          amount: '50.00'
                          amount_without_discount: '50.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Saber
                    groups:
                      - external_id: swords
                        item_order_in_group: 2
                        name: Swords
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                    is_free: false
                    item_id: 259772
                    name: Saber
                    price:
                      amount: '3.99'
                      amount_without_discount: '3.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.saber_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 3
                        amount_without_discount: 3
                        calculated_price:
                          amount: '3.00'
                          amount_without_discount: '3.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_3
                        type: virtual_currency
                      - amount: 7
                        amount_without_discount: 7
                        calculated_price:
                          amount: '7.00'
                          amount_without_discount: '7.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_3
                        type: virtual_currency
                      - amount: 70
                        amount_without_discount: 70
                        calculated_price:
                          amount: '70.00'
                          amount_without_discount: '70.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_3
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Bow
                    groups:
                      - external_id: bows
                        item_order_in_group: 1
                        name: Bows
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/3bb3b0a5254ad15134c891108898363f.png
                    is_free: false
                    item_id: 259773
                    name: Bow
                    price:
                      amount: '4.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.bow_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_4
                        type: virtual_currency
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_4
                        type: virtual_currency
                      - amount: 100
                        amount_without_discount: 100
                        calculated_price:
                          amount: '100.00'
                          amount_without_discount: '100.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_5
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Electric shield
                    groups:
                      - external_id: armour
                        item_order_in_group: 1
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    is_free: false
                    item_id: 259774
                    name: Electric shield
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.electric_shield_2
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_5
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_5
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_5
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Royal shield
                    groups:
                      - external_id: armour
                        item_order_in_group: 2
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    is_free: false
                    item_id: 259775
                    name: Royal shield
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.royal_shield_2
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_6
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_6
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_6
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Ancient helmet
                    groups:
                      - external_id: armour
                        item_order_in_group: 3
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    is_free: false
                    item_id: 259776
                    name: Ancient helmet
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    promotions: []
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_7
                        type: virtual_currency
                      - amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_7
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_7
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Wooden helmet
                    groups:
                      - external_id: armour
                        item_order_in_group: 4
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    is_free: false
                    item_id: 259777
                    name: Wooden helmet
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_8
                        type: virtual_currency
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_8
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_8
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    bundle_type: standard
                    can_be_bought: true
                    content:
                      - attributes: []
                        can_be_bought: true
                        description: Electric shield
                        groups:
                          - external_id: armour
                            name: Armour
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                        is_free: false
                        item_id: 259774
                        name: Electric shield
                        price:
                          amount: '9.99'
                          amount_without_discount: '9.99'
                          currency: USD
                        promotions:
                          - bonus:
                              - image_url: >-
                                  https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                                name: Xsolla Minigun
                                quantity: 1
                                sku: com.xsolla.minigun_1
                                type: virtual_good
                            date_end: '2026-04-15T16:16:00+03:00'
                            date_start: '2020-04-15T16:16:00+03:00'
                            discount:
                              percent: '50.00'
                            name: Bonus promotion
                        quantity: 1
                        sku: com.xsolla.electric_shield_2
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 10
                            amount_without_discount: 10
                            calculated_price:
                              amount: '10.00'
                              amount_without_discount: '10.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_10
                            type: virtual_currency
                          - amount: 20
                            amount_without_discount: 20
                            calculated_price:
                              amount: '20.00'
                              amount_without_discount: '20.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_10
                            type: virtual_currency
                          - amount: 200
                            amount_without_discount: 200
                            calculated_price:
                              amount: '200.00'
                              amount_without_discount: '200.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_10
                            type: virtual_currency
                      - attributes: []
                        can_be_bought: true
                        description: Ancient helmet
                        groups:
                          - external_id: armour
                            name: Armour
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                        is_free: false
                        item_id: 259776
                        name: Ancient helmet
                        price:
                          amount: '1.99'
                          amount_without_discount: '1.99'
                          currency: USD
                        promotions:
                          - bonus:
                              - image_url: >-
                                  https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                                name: Xsolla Minigun
                                quantity: 1
                                sku: com.xsolla.minigun_1
                                type: virtual_good
                            date_end: '2026-04-15T16:16:00+03:00'
                            date_start: '2020-04-15T16:16:00+03:00'
                            discount:
                              percent: '50.00'
                            name: Bonus promotion
                        quantity: 1
                        sku: com.xsolla.ancient_helmet_2
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 2
                            amount_without_discount: 2
                            calculated_price:
                              amount: '2.00'
                              amount_without_discount: '2.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_11
                            type: virtual_currency
                          - amount: 4
                            amount_without_discount: 4
                            calculated_price:
                              amount: '4.00'
                              amount_without_discount: '4.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_11
                            type: virtual_currency
                          - amount: 40
                            amount_without_discount: 40
                            calculated_price:
                              amount: '40.00'
                              amount_without_discount: '40.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_11
                            type: virtual_currency
                    description: Chest of armour
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/5212202f9b8c9dbd254652d6cbeba03e.png
                    is_free: false
                    item_id: 259778
                    name: Chest of armor
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.armor_chest_1
                    total_content_price:
                      amount: '11.98'
                      amount_without_discount: '11.98'
                      currency: USD
                    type: bundle
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_9
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_9
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_9
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    bundle_type: standard
                    can_be_bought: true
                    content:
                      - attributes: []
                        can_be_bought: true
                        description: Saber
                        groups:
                          - external_id: swords
                            name: Swords
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                        is_free: false
                        item_id: 259772
                        name: Saber
                        price:
                          amount: '3.99'
                          amount_without_discount: '3.99'
                          currency: USD
                        quantity: 1
                        sku: com.xsolla.saber_1
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 3
                            amount_without_discount: 3
                            calculated_price:
                              amount: '3.00'
                              amount_without_discount: '3.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_13
                            type: virtual_currency
                          - amount: 7
                            amount_without_discount: 7
                            calculated_price:
                              amount: '7.00'
                              amount_without_discount: '7.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_13
                            type: virtual_currency
                          - amount: 70
                            amount_without_discount: 70
                            calculated_price:
                              amount: '70.00'
                              amount_without_discount: '70.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_13
                            type: virtual_currency
                      - attributes: []
                        bundle_type: virtual_currency_package
                        can_be_bought: true
                        content:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            name: Silver
                            quantity: 50
                            sku: com.xsolla.silver_13
                            type: virtual_currency
                        description: Chest of silver
                        groups: []
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                        is_free: false
                        item_id: 259769
                        name: Chest of silver
                        price:
                          amount: '19.99'
                          amount_without_discount: '19.99'
                          currency: USD
                        promotions: []
                        quantity: 10
                        sku: com.xsolla.silver_chest_2
                        type: bundle
                        virtual_prices: []
                      - attributes: []
                        bundle_type: virtual_currency_package
                        can_be_bought: true
                        content:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            name: Bronze
                            quantity: 100
                            sku: com.xsolla.bronze_13
                            type: virtual_currency
                        description: Chest of bronze
                        groups: []
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                        is_free: false
                        item_id: 259770
                        name: Chest of bronze
                        price:
                          amount: '5.99'
                          amount_without_discount: '5.99'
                          currency: USD
                        promotions: []
                        quantity: 100
                        sku: com.xsolla.bronze_chest_2
                        type: bundle
                        virtual_prices: []
                    description: Treasure Chest
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/7b1c0136d91398f9ab17924deee5eeec.png
                    is_free: false
                    item_id: 259779
                    name: Treasure Chest
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    promotions:
                      - bonus:
                          - image_url: >-
                              https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png
                            name: Xsolla Minigun
                            quantity: 1
                            sku: com.xsolla.minigun_1
                            type: virtual_good
                        date_end: '2026-04-15T16:16:00+03:00'
                        date_start: '2020-04-15T16:16:00+03:00'
                        discount:
                          percent: '50.00'
                        name: Bonus promotion
                    sku: com.xsolla.treasure_chest_1
                    total_content_price:
                      amount: '802.89'
                      amount_without_discount: '802.89'
                      currency: USD
                    type: bundle
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_12
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_12
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_12
                        type: virtual_currency
                    vp_rewards: []
          schema:
            description: Объект с продаваемыми товарами.
            properties:
              has_more:
                $ref: '#/components/schemas/Pagination_has-more'
              items:
                example:
                  - attributes: []
                    can_be_bought: true
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                    is_free: false
                    item_id: 259765
                    limits:
                      per_user:
                        available: 3
                        limit_exceeded_visibility: show
                        recurrent_schedule:
                          interval_type: weekly
                          reset_next_date: 1746057600
                        total: 5
                    name: Gold
                    price:
                      amount: '1.00'
                      amount_without_discount: '1.00'
                      currency: USD
                    sku: com.xsolla.gold_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards:
                      - amount: 130
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        item_id: 175232
                        name: Value point
                        sku: com.xsolla.value_point_1
                      - amount: 50
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                        is_clan: true
                        item_id: 186321
                        name: Clan Reward VP 1
                        sku: com.xsolla.clan_value_point_1
                  - attributes: []
                    can_be_bought: true
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                    is_free: false
                    item_id: 259766
                    limits: null
                    name: Silver
                    price:
                      amount: '0.50'
                      amount_without_discount: '0.50'
                      currency: USD
                    sku: com.xsolla.silver_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: ''
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                    is_free: false
                    item_id: 259767
                    limits: null
                    name: Bronze
                    price:
                      amount: '0.10'
                      amount_without_discount: '0.10'
                      currency: USD
                    sku: com.xsolla.bronze_1
                    type: virtual_currency
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: null
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        item_id: 259765
                        name: Gold
                        quantity: 10
                        sku: com.xsolla.gold_1
                        type: virtual_currency
                    description: Chest of gold
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/61b8d0785093017ce1f50ebed55c42a9.png
                    is_free: false
                    item_id: 259768
                    limits: null
                    name: Chest of gold
                    price:
                      amount: '7.99'
                      amount_without_discount: '7.99'
                      currency: USD
                    sku: com.xsolla.gold_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        item_id: 259766
                        name: Silver
                        quantity: 50
                        sku: com.xsolla.silver_1
                        type: virtual_currency
                    description: Chest of silver
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                    is_free: false
                    item_id: 259769
                    limits: null
                    name: Chest of silver
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    sku: com.xsolla.silver_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    bundle_type: virtual_currency_package
                    can_be_bought: true
                    content:
                      - description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        item_id: 259767
                        name: Bronze
                        quantity: 100
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                    description: Chest of bronze
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                    is_free: false
                    item_id: 259770
                    limits: null
                    name: Chest of bronze
                    price:
                      amount: '5.99'
                      amount_without_discount: '5.99'
                      currency: USD
                    sku: com.xsolla.bronze_chest_1
                    type: bundle
                    virtual_prices: []
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Sword
                    groups:
                      - external_id: swords
                        name: Swords
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/a558727a420cad609556e4449b9ecb12.png
                    is_free: false
                    item_id: 259771
                    limits: null
                    name: Sword
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    sku: com.xsolla.sword_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_2
                        type: virtual_currency
                      - amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_2
                        type: virtual_currency
                      - amount: 50
                        amount_without_discount: 50
                        calculated_price:
                          amount: '50.00'
                          amount_without_discount: '50.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_2
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Saber
                    groups:
                      - external_id: swords
                        name: Swords
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                    is_free: false
                    item_id: 259772
                    limits: null
                    name: Saber
                    price:
                      amount: '3.99'
                      amount_without_discount: '3.99'
                      currency: USD
                    sku: com.xsolla.saber_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 3
                        amount_without_discount: 3
                        calculated_price:
                          amount: '3.00'
                          amount_without_discount: '3.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_3
                        type: virtual_currency
                      - amount: 7
                        amount_without_discount: 7
                        calculated_price:
                          amount: '7.00'
                          amount_without_discount: '7.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_3
                        type: virtual_currency
                      - amount: 70
                        amount_without_discount: 70
                        calculated_price:
                          amount: '70.00'
                          amount_without_discount: '70.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_3
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Bow
                    groups:
                      - external_id: bows
                        name: Bows
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/3bb3b0a5254ad15134c891108898363f.png
                    is_free: false
                    item_id: 259773
                    limits: null
                    name: Bow
                    price:
                      amount: '4.99'
                      amount_without_discount: '4.99'
                      currency: USD
                    sku: com.xsolla.bow_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 5
                        amount_without_discount: 5
                        calculated_price:
                          amount: '5.00'
                          amount_without_discount: '5.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_4
                        type: virtual_currency
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_4
                        type: virtual_currency
                      - amount: 100
                        amount_without_discount: 100
                        calculated_price:
                          amount: '100.00'
                          amount_without_discount: '100.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_4
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Electric shield
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                    is_free: false
                    item_id: 259774
                    name: Electric shield
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    sku: com.xsolla.electric_shield_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_5
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_5
                        type: virtual_currency
                      - amount: 200
                        amount_without_discount: 200
                        calculated_price:
                          amount: '200.00'
                          amount_without_discount: '200.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_5
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Royal shield
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png
                    is_free: false
                    item_id: 259775
                    name: Royal shield
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    sku: com.xsolla.royal_shield_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_6
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_6
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_6
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Ancient helmet
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                    is_free: false
                    item_id: 259776
                    name: Ancient helmet
                    price:
                      amount: '1.99'
                      amount_without_discount: '1.99'
                      currency: USD
                    sku: com.xsolla.ancient_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_7
                        type: virtual_currency
                      - amount: 4
                        amount_without_discount: 4
                        calculated_price:
                          amount: '4.00'
                          amount_without_discount: '4.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_7
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_7
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    can_be_bought: true
                    description: Wooden helmet
                    groups:
                      - external_id: armour
                        name: Armour
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png
                    is_free: false
                    item_id: 259777
                    name: Wooden helmet
                    price:
                      amount: '0.99'
                      amount_without_discount: '0.99'
                      currency: USD
                    sku: com.xsolla.wooden_helmet_1
                    type: virtual_good
                    virtual_item_type: non_consumable
                    virtual_prices:
                      - amount: 1
                        amount_without_discount: 1
                        calculated_price:
                          amount: '1.00'
                          amount_without_discount: '1.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_8
                        type: virtual_currency
                      - amount: 2
                        amount_without_discount: 2
                        calculated_price:
                          amount: '2.00'
                          amount_without_discount: '2.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_8
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_8
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    bundle_type: standard
                    can_be_bought: true
                    content:
                      - attributes: []
                        can_be_bought: true
                        description: Electric shield
                        groups:
                          - external_id: armour
                            name: Armour
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                        is_free: false
                        item_id: 259774
                        name: Electric shield
                        price:
                          amount: '9.99'
                          amount_without_discount: '9.99'
                          currency: USD
                        quantity: 1
                        sku: com.xsolla.electric_shield_2
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 10
                            amount_without_discount: 10
                            calculated_price:
                              amount: '10.00'
                              amount_without_discount: '10.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_10
                            type: virtual_currency
                          - amount: 20
                            amount_without_discount: 20
                            calculated_price:
                              amount: '20.00'
                              amount_without_discount: '20.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_10
                            type: virtual_currency
                          - amount: 200
                            amount_without_discount: 200
                            calculated_price:
                              amount: '200.00'
                              amount_without_discount: '200.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_10
                            type: virtual_currency
                      - attributes: []
                        can_be_bought: true
                        description: Ancient helmet
                        groups:
                          - external_id: armour
                            name: Armour
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png
                        is_free: false
                        item_id: 259776
                        name: Ancient helmet
                        price:
                          amount: '1.99'
                          amount_without_discount: '1.99'
                          currency: USD
                        quantity: 1
                        sku: com.xsolla.ancient_helmet_2
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 2
                            amount_without_discount: 2
                            calculated_price:
                              amount: '2.00'
                              amount_without_discount: '2.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_11
                            type: virtual_currency
                          - amount: 4
                            amount_without_discount: 4
                            calculated_price:
                              amount: '4.00'
                              amount_without_discount: '4.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_11
                            type: virtual_currency
                          - amount: 40
                            amount_without_discount: 40
                            calculated_price:
                              amount: '40.00'
                              amount_without_discount: '40.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_11
                            type: virtual_currency
                    description: Chest of armour
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/5212202f9b8c9dbd254652d6cbeba03e.png
                    is_free: false
                    item_id: 259778
                    name: Chest of armor
                    price:
                      amount: '19.99'
                      amount_without_discount: '19.99'
                      currency: USD
                    sku: com.xsolla.armor_chest_1
                    total_content_price:
                      amount: '11.98'
                      amount_without_discount: '11.98'
                      currency: USD
                    type: bundle
                    virtual_prices:
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_9
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_9
                        type: virtual_currency
                      - amount: 400
                        amount_without_discount: 400
                        calculated_price:
                          amount: '400.00'
                          amount_without_discount: '400.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_9
                        type: virtual_currency
                    vp_rewards: []
                  - attributes: []
                    bundle_type: standard
                    can_be_bought: true
                    content:
                      - attributes: []
                        can_be_bought: true
                        description: Saber
                        groups:
                          - external_id: swords
                            name: Swords
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/edd914d60301d77b94926478d253fcb6.png
                        is_free: false
                        item_id: 259772
                        name: Saber
                        price:
                          amount: '3.99'
                          amount_without_discount: '3.99'
                          currency: USD
                        quantity: 1
                        sku: com.xsolla.saber_2
                        type: virtual_good
                        virtual_item_type: non_consumable
                        virtual_prices:
                          - amount: 3
                            amount_without_discount: 3
                            calculated_price:
                              amount: '3.00'
                              amount_without_discount: '3.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            is_default: true
                            item_id: 259765
                            name: Gold
                            sku: com.xsolla.gold_13
                            type: virtual_currency
                          - amount: 7
                            amount_without_discount: 7
                            calculated_price:
                              amount: '7.00'
                              amount_without_discount: '7.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            is_default: false
                            item_id: 259766
                            name: Silver
                            sku: com.xsolla.silver_13
                            type: virtual_currency
                          - amount: 70
                            amount_without_discount: 70
                            calculated_price:
                              amount: '70.00'
                              amount_without_discount: '70.00'
                            description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            is_default: false
                            item_id: 259767
                            name: Bronze
                            sku: com.xsolla.bronze_13
                            type: virtual_currency
                      - attributes: []
                        bundle_type: virtual_currency_package
                        can_be_bought: true
                        content:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                            item_id: 259766
                            name: Silver
                            quantity: 50
                            sku: com.xsolla.silver_14
                            type: virtual_currency
                        description: Chest of silver
                        groups: []
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/f0b59a3370404e8881107249051b70bd.png
                        is_free: false
                        item_id: 259769
                        name: Chest of silver
                        price:
                          amount: '19.99'
                          amount_without_discount: '19.99'
                          currency: USD
                        quantity: 10
                        sku: com.xsolla.silver_chest_2
                        type: bundle
                        virtual_prices: []
                      - attributes: []
                        bundle_type: virtual_currency_package
                        can_be_bought: true
                        content:
                          - description: ''
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                            item_id: 259767
                            name: Bronze
                            quantity: 100
                            sku: com.xsolla.bronze_11
                            type: virtual_currency
                        description: Chest of bronze
                        groups: []
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b32eb5b1f4f0c202ea6ac4e21c2eae18.png
                        is_free: false
                        item_id: 259770
                        name: Chest of bronze
                        price:
                          amount: '5.99'
                          amount_without_discount: '5.99'
                          currency: USD
                        quantity: 100
                        sku: com.xsolla.bronze_chest_2
                        type: bundle
                        virtual_prices: []
                    description: Treasure Chest
                    groups: []
                    image_url: >-
                      https://cdn3.xsolla.com/img/misc/images/7b1c0136d91398f9ab17924deee5eeec.png
                    is_free: false
                    item_id: 259779
                    name: Treasure Chest
                    price:
                      amount: '9.99'
                      amount_without_discount: '9.99'
                      currency: USD
                    sku: com.xsolla.treasure_chest_1
                    total_content_price:
                      amount: '802.89'
                      amount_without_discount: '802.89'
                      currency: USD
                    type: bundle
                    virtual_prices:
                      - amount: 10
                        amount_without_discount: 10
                        calculated_price:
                          amount: '10.00'
                          amount_without_discount: '10.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                        is_default: true
                        item_id: 259765
                        name: Gold
                        sku: com.xsolla.gold_12
                        type: virtual_currency
                      - amount: 20
                        amount_without_discount: 20
                        calculated_price:
                          amount: '20.00'
                          amount_without_discount: '20.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png
                        is_default: false
                        item_id: 259766
                        name: Silver
                        sku: com.xsolla.silver_12
                        type: virtual_currency
                      - amount: 40
                        amount_without_discount: 40
                        calculated_price:
                          amount: '40.00'
                          amount_without_discount: '40.00'
                        description: ''
                        image_url: >-
                          https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png
                        is_default: false
                        item_id: 259767
                        name: Bronze
                        sku: com.xsolla.bronze_12
                        type: virtual_currency
                    vp_rewards: []
                items:
                  properties:
                    attributes:
                      $ref: >-
                        #/components/schemas/Virtual-Items-Currency_client-attributes
                    bundle_type:
                      description: >-
                        Тип бандла. Возвращается, если тип элемента является
                        бандлом.
                      enum:
                        - standard
                        - virtual_currency_package
                      type: string
                    can_be_bought:
                      description: Если `true`, пользователь может купить товар.
                      example: true
                      type: boolean
                    content:
                      items:
                        items:
                          $ref: '#/components/schemas/Bundles_client_content'
                        type: object
                      type: array
                    custom_attributes:
                      $ref: '#/components/schemas/item-custom-attributes-response'
                    description:
                      description: Описание товара.
                      example: Electric shield
                      type: string
                    groups:
                      $ref: '#/components/schemas/items_client_groups_response'
                    image_url:
                      description: URL-адрес изображения.
                      example: >-
                        https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png
                      type: string
                    is_free:
                      $ref: '#/components/schemas/value-is_free'
                    item_id:
                      description: >-
                        Внутренний уникальный ID товара, который задается при
                        создании товара.
                      example: 259774
                      type: integer
                    limits:
                      $ref: '#/components/schemas/Catalog_item_limits'
                    name:
                      description: Название товара.
                      example: Electric shield
                      type: string
                    price:
                      description: Цены на товар.
                      properties:
                        amount:
                          description: Цена товара со скидкой.
                          example: '9.99'
                          type: string
                        amount_without_discount:
                          description: Цена товара.
                          example: '9.99'
                          type: string
                        currency:
                          description: >-
                            Валюта, в которой указана цена товара. Трехбуквенный
                            код в соответствии со стандартом [ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217).
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        Уникальный ID товара. Артикул может содержать только
                        строчные и заглавные латинские буквы, цифры, точки, тире
                        и подчеркивания.
                      example: com.xsolla.electric_shield_1
                      type: string
                    total_content_price:
                      $ref: '#/components/schemas/Bundles_total_content_price'
                    type:
                      description: >-
                        Тип товара:
                        `virtual_good`/`virtual_currency`/`bundle`/`game_key`/`physical_good`.
                      enum:
                        - virtual_good
                        - virtual_currency
                        - bundle
                        - game_key
                        - physical_good
                      example: virtual_good
                      type: string
                    virtual_item_type:
                      description: Тип виртуального предмета.
                      enum:
                        - consumable
                        - non_consumable
                        - non_renewing_subscription
                      example: non-consumable
                      type: string
                      x-enumDescriptions:
                        consumable: >-
                          Предмет исчезает из инвентаря после использования
                          (например, патроны).
                        non_consumable: >-
                          Предмет остается в инвентаре в течение неограниченного
                          времени.
                        non_renewing_subscription: >-
                          Предмет с ограниченным сроком действия, который может
                          служить представлением доступа к сервисам или контенту
                          в течение ограниченного периода времени.
                    virtual_prices:
                      description: Виртуальные цены.
                      items:
                        description: Виртуальная цена.
                        properties:
                          amount:
                            description: Цена товара со скидкой в виртуальной валюте.
                            example: 10
                            type: integer
                          amount_without_discount:
                            description: Цена товара.
                            example: 10
                            type: integer
                          calculated_price:
                            properties:
                              amount:
                                type: string
                              amount_without_discount:
                                type: string
                            type: object
                          description:
                            description: Описание виртуальной валюты.
                            example: null
                            nullable: true
                            type: string
                          image_url:
                            description: Изображение виртуальной валюты.
                            example: >-
                              https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png
                            type: string
                          is_default:
                            description: Является ли данная цена товара ценой по умолчанию.
                            example: true
                            type: boolean
                          item_id:
                            description: >-
                              Внутренний уникальный ID товара, который задается
                              при создании товара.
                            example: 259774
                            type: integer
                          name:
                            description: Название виртуальной валюты.
                            example: Gold
                            type: string
                          sku:
                            description: Артикул виртуальной валюты.
                            example: com.xsolla.gold_1
                            type: string
                          type:
                            description: Тип виртуальной валюты.
                            example: virtual_currency
                            type: string
                        type: object
                      type: array
                    vp_rewards:
                      $ref: '#/components/schemas/client-item-value-point-reward'
                  type: object
                type: array
            type: object
      description: Список продаваемых товаров успешно получен.
  schemas:
    404-not-found:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: '[0000-0000]: Entity not found'
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    422-invalid-request:
      properties:
        errorCode:
          description: Код ошибки.
          example: 1102
          type: number
        errorMessage:
          description: Удобочитаемое сообщение об ошибке.
          example: >-
            [0401-1102]: Unprocessable Entity. The property `external_id` is
            required
          type: string
        statusCode:
          description: Код статуса ответа.
          example: 422
          type: number
        transactionId:
          description: Уникальный ID запроса.
          example: da145238620011eb8e24fe6913ff226a
          type: string
      type: object
    422-rc-vp-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Bundles_422-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        errorMessageExtended:
          type: array
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Bundles_admin-attributes:
      description: Список атрибутов.
      items:
        $ref: '#/components/schemas/attribute'
      type: array
    Bundles_admin-post-put-attributes:
      description: >-
        Список атрибутов.

        <div class="notice"><strong>Внимание.</strong> Для товара
        <strong>невозможно указать более 20 атрибутов</strong>. Любые попытки
        превысить данное ограничение вызовут ошибку.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
      maxItems: 20
      type: array
    Bundles_admin-regions:
      items:
        properties:
          id:
            example: 1
            minimum: 1
            type: integer
        type: object
      type: array
    Bundles_admin-response-virtual_price:
      properties:
        amount:
          $ref: '#/components/schemas/Bundles_amount'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_default:
          $ref: '#/components/schemas/Bundles_currency-is_default'
        name:
          $ref: '#/components/schemas/name-localization-object'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        type:
          $ref: '#/components/schemas/Bundles_vc-type'
      type: object
    Bundles_admin_bundle_request:
      description: Указанный бандл.
      properties:
        attributes:
          $ref: '#/components/schemas/Bundles_admin-post-put-attributes'
        bundle_type:
          $ref: '#/components/schemas/Bundles_bundle_type'
        content:
          $ref: '#/components/schemas/Bundles_admin_content_request'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Bundles_groups_request'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_enabled:
          $ref: '#/components/schemas/Bundles_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Bundles_is_show_in_store'
        limits:
          $ref: '#/components/schemas/bundle-item-limit'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          allOf:
            - $ref: '#/components/schemas/Bundles_media_list'
            - nullable: true
              type: array
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Bundles_order'
        periods:
          $ref: '#/components/schemas/item-periods'
        prices:
          $ref: '#/components/schemas/Bundles_prices'
        regions:
          $ref: '#/components/schemas/Bundles_admin-regions'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        vc_prices:
          allOf:
            - $ref: '#/components/schemas/Bundles_vc_prices'
            - nullable: true
              type: array
      required:
        - sku
        - name
        - description
      type: object
    Bundles_admin_bundle_response:
      description: Указанный бандл.
      properties:
        attributes:
          $ref: '#/components/schemas/Bundles_admin-attributes'
        bundle_type:
          $ref: '#/components/schemas/bundle_type'
        content:
          items:
            $ref: '#/components/schemas/Bundles_admin_content_response'
          type: array
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Bundles_groups_response'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_enabled:
          $ref: '#/components/schemas/Bundles_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Bundles_is_show_in_store'
        item_id:
          $ref: '#/components/schemas/Bundles_item_id'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          allOf:
            - $ref: '#/components/schemas/Bundles_media_list'
            - nullable: true
              type: array
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Bundles_order'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        prices:
          $ref: '#/components/schemas/Bundles_prices'
        regions:
          $ref: '#/components/schemas/Bundles_admin-regions'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        total_content_price:
          $ref: '#/components/schemas/Bundles_total_content_price'
        type:
          $ref: '#/components/schemas/Bundles_type'
        virtual_prices:
          items:
            $ref: '#/components/schemas/Bundles_admin-response-virtual_price'
          type: array
      type: object
    Bundles_admin_content_request:
      items:
        example:
          quantity: 1
          sku: com.xsolla.kg_1
        properties:
          quantity:
            default: 1
            description: Количество выбранных товаров в бандле.
            minimum: 1
            type: integer
          sku:
            $ref: '#/components/schemas/Bundles_sku'
        required:
          - sku
        type: object
      minItems: 1
      type: array
    Bundles_admin_content_response:
      properties:
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        name:
          $ref: '#/components/schemas/name-localization-object'
        quantity:
          default: 1
          description: Количество единиц товара данного типа в бандле.
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        type:
          $ref: '#/components/schemas/Bundles_type'
      type: object
    Bundles_amount:
      description: Цена товара со скидкой.
      example: '100.99'
      pattern: ^\d*\.?\d*$
      type: string
    Bundles_amount_without_discount:
      description: Цена товара.
      example: '100.99'
      pattern: ^\d*\.?\d*$
      type: string
    Bundles_bundle_type:
      default: standard
      description: >-
        Тип бандла. Используйте `standard`, чтобы создать бандл с товарами и
        указать артикулы товаров, которые содержатся в бандле.

        Используйте `partner_side_content`, чтобы создать пустой бандл и
        добавить в него товары на своей стороне с помощью
        [вебхука](https://developers.xsolla.com/ru/webhooks/operation/personalized-partner-catalog/).
        Используется только для [персонализации каталога товаров на стороне
        партнера](https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
      enum:
        - standard
        - partner_side_content
      example: standard
      type: string
    Bundles_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих товару. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Bundles_client_bundle:
      description: Указанный бандл.
      properties:
        attributes:
          $ref: '#/components/schemas/Bundles_client-attributes'
        bundle_type:
          $ref: '#/components/schemas/Bundles_bundle_type'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        content:
          $ref: '#/components/schemas/Bundles_client_content'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          $ref: '#/components/schemas/Bundles_client_description'
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        image_url:
          $ref: '#/components/schemas/Bundles_image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          $ref: '#/components/schemas/Bundles_item_id'
        limits:
          $ref: '#/components/schemas/Catalog_item_limits_with_hourly'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Bundles_media_list'
        name:
          $ref: '#/components/schemas/Bundles_client_name'
        order:
          $ref: '#/components/schemas/Bundles_order'
        periods:
          $ref: '#/components/schemas/item-periods'
        price:
          $ref: '#/components/schemas/Bundles_price'
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          $ref: '#/components/schemas/Bundles_sku'
        total_content_price:
          $ref: '#/components/schemas/Bundles_total_content_price'
        type:
          $ref: '#/components/schemas/Bundles_type'
        virtual_prices:
          $ref: '#/components/schemas/Bundles_virtual_prices'
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
      type: object
    Bundles_client_content:
      description: Содержимое бандла.
      example:
        - attributes: []
          description: Big Rocket - short description.
          groups: []
          image_url: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          is_free: false
          name: Big Rocket
          price:
            amount: '10.99'
            amount_without_discount: '10.99'
            currency: USD
          quantity: 100
          sku: com.xsolla.big_rocket_1
          type: virtual_currency
      items:
        description: Товар в пакете.
        properties:
          attributes:
            $ref: '#/components/schemas/Bundles_client-attributes'
          description:
            description: Описание товара.
            example: Big Rocket - description
            type: string
          groups:
            $ref: '#/components/schemas/Bundles_groups_response'
          image_url:
            description: URL-адрес изображения.
            example: >-
              https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
            type: string
          is_free:
            $ref: '#/components/schemas/value-is_free'
          limits:
            $ref: '#/components/schemas/Catalog_item_limits_with_hourly'
          name:
            description: Название товара.
            example: Big Rocket
            type: string
          price:
            description: Цены на товар.
            nullable: true
            properties:
              amount:
                description: Цена товара со скидкой.
                example: '100.99'
                type: string
              amount_without_discount:
                description: Цена товара.
                example: '100.99'
                type: string
              currency:
                description: >-
                  Валюта, в которой указана цена товара. Трехбуквенный код в
                  соответствии с [ISO
                  4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                  информацию о [валютах, поддерживаемых Xsolla, смотрите в
                  документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
                example: USD
                type: string
            type: object
          quantity:
            description: Количество товара в пакете.
            example: 250
            type: integer
          sku:
            description: >-
              Уникальный ID товара. Артикул может содержать только строчные и
              заглавные латинские буквы, цифры, точки, тире и подчеркивания.
            example: com.xsolla.big_rocket_1
            type: string
          type:
            description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
            example: virtual_currency
            type: string
          virtual_item_type:
            description: Тип виртуального предмета.
            enum:
              - consumable
              - non_consumable
              - non_renewing_subscription
            example: non-consumable
            type: string
            x-enumDescriptions:
              consumable: >-
                Предмет исчезает из инвентаря после использования (например,
                патроны).
              non_consumable: Предмет остается в инвентаре в течение неограниченного времени.
              non_renewing_subscription: >-
                Предмет с ограниченным сроком действия, который может служить
                представлением доступа к сервисам или контенту в течение
                ограниченного периода времени.
          virtual_prices:
            description: Виртуальные цены.
            items:
              description: Виртуальная цена.
              properties:
                amount:
                  description: Цена товара в виртуальной валюте со скидкой.
                  example: 100
                  type: integer
                amount_without_discount:
                  description: Цена товара.
                  example: 200
                  type: integer
                description:
                  description: Описание виртуальной валюты.
                  example: Big Rocket - description
                  type: string
                image_url:
                  description: Изображение виртуальной валюты.
                  example: http://image.png
                  type: string
                is_default:
                  description: Является ли данная цена товара ценой по умолчанию.
                  example: true
                  type: boolean
                name:
                  description: Название виртуальной валюты.
                  example: SHOTGUN FOR TRUE RAIDERS
                  type: string
                sku:
                  description: Артикул виртуальной валюты.
                  example: vc_test
                  type: string
                type:
                  description: Тип виртуальной валюты.
                  example: virtual_currency
                  type: string
              type: object
            type: array
        type: object
      type: array
    Bundles_client_description:
      description: Описание товара.
      example: Big Rocket - description.
      nullable: true
      type: string
    Bundles_client_name:
      description: Название товара.
      example: Big Rocket
      type: string
    Bundles_currency:
      description: >-
        Валюта, в которой указана цена товара. Трехбуквенный код в соответствии
        со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
      example: USD
      type: string
    Bundles_currency-is_default:
      description: Является ли данная цена товара ценой по умолчанию.
      example: true
      type: boolean
    Bundles_groups_request:
      default: []
      description: >-
        Группы, к которым принадлежит элемент.

        <div class="note"><strong>Примечание.</strong> Строковое значение
        относится к группе `external_id`.</div>
      example:
        - honor
      items:
        type: string
      type: array
    Bundles_groups_response:
      default: []
      description: Группы, к которым принадлежит товар.
      example:
        - external_id: horror
          name:
            en: Horror
      items:
        properties:
          external_id:
            example: horror
            type: string
          name:
            additionalProperties:
              type: string
            default:
              en: Horror
            description: >-
              Название элемента. Должно содержать пары ключ/значение, 

              где ключ — это языковой стандарт в {2}формате "^[a-z]", значение —
              строка.
            example:
              de: Horror
              en: Horror
            type: object
        type: object
      type: array
    Bundles_image_url:
      description: URL-адрес изображения.
      example: https://image.example.com
      nullable: true
      type: string
    Bundles_is_enabled:
      default: true
      description: Если этот параметр отключен, товар не может быть найден и приобретен.
      example: true
      type: boolean
    Bundles_is_show_in_store:
      default: false
      description: Товар доступен для покупки.
      example: true
      type: boolean
    Bundles_item_id:
      description: Внутренний уникальный ID виртуального предмета или валюты.
      example: 1
      maxLength: 255
      minLength: 1
      type: integer
    Bundles_media_list:
      description: Дополнительные ассеты бандла.
      example:
        - type: image
          url: >-
            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
      items:
        properties:
          type:
            description: 'Тип медиа: `image`/`video`.'
            enum:
              - image
              - video
            example: image
            type: string
          url:
            description: Ссылка на файл.
            example: >-
              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
            type: string
        type: object
      type: array
    Bundles_order:
      default: 1
      description: Приоритет заказа бандла в списке.
      example: 1
      type: integer
    Bundles_price:
      description: Цена товара.
      nullable: true
      properties:
        amount:
          $ref: '#/components/schemas/Bundles_amount'
        amount_without_discount:
          $ref: '#/components/schemas/Bundles_amount_without_discount'
        currency:
          $ref: '#/components/schemas/Bundles_currency'
      required:
        - amount
        - amount_without_discount
        - currency
      type: object
    Bundles_prices:
      description: Цены в реальных валютах.
      items:
        properties:
          amount:
            $ref: '#/components/schemas/Bundles_amount_without_discount'
          country_iso:
            description: >-
              Страна, где доступна эта цена. Двухбуквенный код в соответствии с
              [ISO 3166-1 alpha
              2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
            example: US
            nullable: true
            type: string
          currency:
            $ref: '#/components/schemas/Bundles_currency'
          is_default:
            description: >-
              Цена по умолчанию используется для построения каталога, если цена
              в валюте пользователя не указана.
            type: boolean
          is_enabled:
            description: Цена включена.
            type: boolean
        required:
          - amount
          - currency
          - is_default
          - is_enabled
        type: object
      type: array
    Bundles_sku:
      description: >-
        Уникальный ID товара. Артикул может содержать только строчные и
        заглавные латинские буквы, цифры, точки, тире и подчеркивания.
      example: bundle_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9_\-–.]*$
      type: string
    Bundles_total_content_price:
      description: Сумма цен содержимого бандла.
      nullable: true
      properties:
        amount:
          description: Сумма цен содержимого бандла со скидкой.
          example: '100.99'
          type: string
        amount_without_discount:
          description: Сумма цен содержимого бандла.
          example: '100.99'
          type: string
        currency:
          $ref: '#/components/schemas/Bundles_currency'
      type: object
    Bundles_type:
      description: Тип товара.
      example: bundle
      type: string
    Bundles_vc-type:
      description: Тип виртуальной валюты.
      example: virtual_currency
      type: string
    Bundles_vc_prices:
      items:
        properties:
          amount:
            type: integer
          is_default:
            type: boolean
          is_enabled:
            type: boolean
          sku:
            description: >-
              Уникальный ID товара. Артикул может содержать только строчные и
              заглавные латинские буквы, цифры, точки, тире и подчеркивания.
            example: gold
            type: string
        required:
          - amount
          - currency
          - is_default
          - is_enabled
        type: object
      type: array
    Bundles_virtual_prices:
      description: Виртуальные цены.
      items:
        description: Виртуальная цена.
        properties:
          amount:
            description: Цена товара в виртуальной валюте со скидкой.
            example: 100
            type: integer
          amount_without_discount:
            description: Цена товара в виртуальной валюте.
            example: 200
            type: integer
          description:
            description: Описание виртуальной валюты.
            example: Most popular gold
            nullable: true
            type: string
          image_url:
            description: Изображение виртуальной валюты.
            example: http://image.png
            nullable: true
            type: string
          is_default:
            description: Является ли данная цена товара ценой по умолчанию.
            example: true
            type: boolean
          name:
            description: Название виртуальной валюты.
            example: Gold
            type: string
          sku:
            description: Артикул виртуальной валюты.
            example: gold
            type: string
          type:
            description: Тип виртуальной валюты.
            example: virtual_currency
            type: string
        type: object
      type: array
    Can_be_bought:
      description: Если `true`, пользователь может купить товар.
      example: true
      type: boolean
    Cart:
      additionalProperties: false
      properties:
        country:
          description: >-
            Двухбуквенное обозначение страны в верхнем регистре согласно
            стандарту [ISO 3166-1
            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Список
            стран, поддерживаемых Xsolla, [приведен в
            документации](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/).
            <br>Пример: `country=US`
          example: US
          maxLength: 2
          minLength: 2
          type: string
        currency:
          description: >-
            Валюта, в которой указаны цены товаров в корзине. Трехбуквенный код
            в соответствии с [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
            Подробную информацию о [валютах, поддерживаемых Xsolla, смотрите в
            документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
          example: USD
          maxLength: 3
          minLength: 3
          type: string
        items:
          items:
            properties:
              quantity:
                description: Количество товара.
                example: 2
                minimum: 1
                type: number
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: t-shirt
                minLength: 1
                type: string
            required:
              - sku
              - quantity
            type: object
          minItems: 1
          type: array
      required:
        - items
      type: object
    Cart-Payment_admin-user-request-body:
      additionalProperties: false
      properties:
        age:
          description: Возраст пользователя.
          type: integer
        country:
          properties:
            allow_modify:
              default: false
              description: Может ли пользователь изменить страну в платежном интерфейсе.
              example: false
              type: boolean
            value:
              description: >-
                Двухбуквенный код страны в верхнем регистре согласно стандарту
                [ISO 3166-1
                alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
                Параметр обязательный, если в заголовке `X-User-Ip`не передан
                IP-адрес. Список стран, поддерживаемых Xsolla, приведен [в
                документации](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/).
                <br>Пример: `country=US`
              example: US
              type: string
          type: object
        email:
          properties:
            value:
              description: >-
                Email-адрес пользователя. Должен быть валидным в соответствии с
                протоколом RFC 822.
              format: email
              maxLength: 255
              minLength: 3
              type: string
          type: object
        id:
          properties:
            value:
              description: >-
                ID пользователя. При тестировании вы можете передать в параметре
                любые символы. Для приема реальных платежей передайте в
                параметре ID пользователя из вашей системы. Этот ID будет
                передаваться в вебхуке
                [](https://developers.xsolla.com/ru/webhooks/operation/user-validation/).
              maxLength: 255
              minLength: 1
              type: string
          type: object
        is_legal:
          description: Является ли пользователь юридическим лицом.
          type: boolean
        legal:
          description: >-
            Объект с реквизитами юридического лица. Объект и все его параметры
            обязательны, если `user.is_legal` имеет значение `true`.
          properties:
            address:
              description: Полный юридический адрес.
              type: string
            country:
              description: >-
                Страна регистрации. Используется двухбуквенный код страны в
                верхнем регистре согласно [ISO 3166-1
                alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
              type: string
            name:
              description: Полное юридическое наименование.
              type: string
            vat_id:
              description: Индивидуальный идентификатор налогоплательщика.
              type: string
          type: object
        name:
          properties:
            value:
              description: Никнейм пользователя.
              maxLength: 255
              minLength: 1
              type: string
          type: object
        phone:
          properties:
            allow_modify:
              default: false
              description: >-
                Может ли пользователь изменить номер телефона в пользовательском
                интерфейсе оплаты. Если `phone.value` передается в токене, по
                умолчанию значение равно `false`.
              example: false
              type: boolean
            hidden:
              default: true
              example: false
              type: boolean
            value:
              description: Номер телефона пользователя.
              type: string
          required:
            - value
          type: object
        steam_id:
          properties:
            value:
              description: Steam ID.
              maxLength: 17
              minLength: 17
              pattern: ^\d{17}$
              type: string
          required:
            - value
          type: object
        tracking_id:
          properties:
            value:
              description: >-
                Уникальный идентификатор отслеживания (используется в
                маркетинговых кампаниях).
              maxLength: 32
              minLength: 32
              pattern: ^[A-Za-z0-9]{32}$
              type: string
          required:
            - value
          type: object
      required:
        - id
      type: object
    Cart-Payment_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих товару. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Cart-Payment_custom_parameters:
      additionalProperties:
        oneOf:
          - type: string
          - type: integer
          - type: number
          - type: boolean
          - type: array
          - type: object
      description: >-
        Ваши пользовательские параметры представлены в виде допустимого набора
        пар ключ-значение в формате JSON.<br>

        Вы можете передать дополнительные параметры через это поле для настройки
        фильтров защиты от мошенничества. [Смотрите документацию Pay
        Station](https://developers.xsolla.com/ru/doc/pay-station/features/antifraud/).
      example:
        custom_parameters:
          bool_param: true
          int_param: 100
          null_param: null
          string_param: example
      maxProperties: 200
      minProperties: 1
      nullable: true
      type: object
    Cart-Payment_redirect_policy:
      properties:
        delay:
          description: >-
            Задержка, по истечении которой пользователь будет автоматически
            перенаправлен на return URL.
          example: 0
          type: integer
        redirect_button_caption:
          description: Локализованные надписи на кнопке редиректа.
          example: Text button
          type: string
        redirect_conditions:
          description: >-
            Статус платежа, при котором происходит перенаправление пользователя
            на return URL.
          enum:
            - none
            - successful
            - successful_or_canceled
            - any
          example: none
          type: string
        status_for_manual_redirection:
          description: >-
            Статус платежа, при котором появляется кнопка для возврата на return
            URL.
          enum:
            - none
            - vc
            - successful
            - successful_or_canceled
            - any
          example: none
          type: string
      type: object
    Cart-Payment_settings_currency:
      description: >-
        Предпочитаемая валюта платежа. Трехбуквенный код валюты в соответствии с
        [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Список валют,
        поддерживаемых Xsolla, [приведен в
        документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
      type: string
    Cart-Payment_settings_external_id:
      description: External ID транзакции.
      maxLength: 255
      minLength: 1
      type: string
    Cart-Payment_settings_locale:
      description: >-
        Язык интерфейса. Двухбуквенный [код
        языка](https://developers.xsolla.com/ru/doc/pay-station/features/localization/)
        в нижнем регистре.
      type: string
    Cart-Payment_settings_payment_method:
      description: >-
        ID платежного метода. Влияет на отображение валюты в платежном
        интерфейсе, так как некоторые платежные методы могут поддерживать только
        определенные валюты.
      minimum: 1
      type: integer
    Cart-Payment_settings_return_url:
      description: >-
        Пользователь будет перенаправлен на данную страницу после совершения
        платежа. Параметры `user_id`, `foreigninvoice`, `invoice_id` и `status`
        будут автоматически добавлены к ссылке.
      format: uri
      maxLength: 1000
      type: string
    Cart-Payment_settings_sandbox:
      default: false
      description: >-
        Передайте значение `true`, чтобы провести тестовые платежи. Обратите
        внимание, что URL для страницы оплаты будет
        https://sandbox-secure.xsolla.com.
      type: boolean
    Cart-Payment_settings_ui:
      additionalProperties: false
      description: Объект с настройками интерфейса.
      properties:
        currency_format:
          description: >-
            Передайте значение `code`, чтобы в платежном интерфейсе отображалось
            трехбуквенное обозначение валюты по [ISO
            4217](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
            По умолчанию вместо трехбуквенного обозначения валюты отображается
            значок валюты.
          type: string
        desktop:
          additionalProperties: false
          description: Объект с настройками интерфейса для настольной версии.
          properties:
            header:
              additionalProperties: false
              description: Объект с настройками хедера.
              properties:
                close_button:
                  default: false
                  description: >-
                    Показывать ли кнопку **Закрыть** в платежном интерфейсе.
                    Нажатие на кнопку закрывает платежный интерфейс и
                    перенаправляет пользователя на адрес, указанный в параметре
                    `settings.return_url`. `false` по умолчанию.
                  type: boolean
                is_visible:
                  description: Показывать ли хедер в платежном интерфейсе.
                  type: boolean
                type:
                  default: normal
                  description: >-
                    Внешний вид хедера. Может принимать значения `compact` (в
                    хедере не будут показываться название игры и ID
                    пользователя) или `normal`.
                  enum:
                    - compact
                    - normal
                  type: string
                visible_logo:
                  description: >-
                    Если `true`, логотип будет отображаться в хедере. Чтобы
                    загрузить изображение, откройте свой проект в [Личном
                    кабинете](https://publisher.xsolla.com/) и перейдите в
                    раздел <b>Pay Station > Настройки</b>.
                  type: boolean
                visible_name:
                  description: Показывать ли в хедере название проекта.
                  type: boolean
                visible_purchase:
                  default: true
                  description: >-
                    Показывать ли в хедере описание покупки
                    (`purchase.description.value`). По умолчанию `true`.
                  type: boolean
              type: object
          type: object
        header:
          properties:
            visible_virtual_currency_balance:
              additionalProperties: false
              default: true
              description: Должен ли этот элемент быть видимым в интерфейсе оплаты.
              type: boolean
          type: object
        is_cart_open_by_default:
          default: false
          description: >-
            Отображение списка товаров в корзине при открытии мобильной версии
            платежного интерфейса. Если передано значение `true`, список
            отображается в развернутом виде. Если передано значение `false` (по
            умолчанию) или параметр не передан — список отображается в свернутом
            виде.
          type: boolean
        is_independent_windows:
          default: false
          description: >-
            Осуществляется ли переход из встроенного браузера лаунчера (WebView)
            во внешний браузер для совершения покупки.
          type: boolean
        is_payment_methods_list_mode:
          default: false
          description: >-
            Отображается ли список способов оплаты, доступных в стране игрока,
            при открытии платежного интерфейса. ​​Если передано значение `false`
            (по умолчанию), отображается способ оплаты, переданный в параметре
            `settings.payment_method` или способ, выбранный [алгоритмом
            PayRank](https://developers.xsolla.com/ru/solutions/payments/payment-ui-management/top-payment-methods-management/).
          type: boolean
        is_prevent_external_link_open:
          default: false
          description: >-
            Отключение перехода по внешним ссылкам. При нажатии на внешнюю
            ссылку отправляется событие `external-link-open` с помощью механизма
            `postMessage`. В параметре `url` передается адрес, по которому
            выполняется переход.
          type: boolean
        is_show_close_widget_warning:
          default: true
          description: >-
            Показывать ли предупреждение об обработке транзакции при наведении
            на значок **×** перед закрытием страницы оплаты. Если передано
            значение `false` или параметр не передан, предупреждение не
            показывается.
          type: boolean
        is_three_ds_independent_windows:
          default: false
          description: >-
            Откроется ли проверка 3-D Secure в новом окне браузера. Если в вашей
            программе настройки применяется политика безопасности содержимого
            (CSP), установите значение `true`.
          type: boolean
        layout:
          description: >-
            Расположение основных элементов платежного интерфейса. Вы можете
            открыть платежный интерфейс внутри вашей игры и/или поменять местами
            колонки с информацией о заказе и способах оплаты. Подробная
            информация представлена в [инструкции по
            кастомизации](https://developers.xsolla.com/ru/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_layout).
          enum:
            - embed
            - column_reverse
            - embed_column_reverse
          type: string
        mobile:
          properties:
            header:
              additionalProperties: false
              properties:
                close_button:
                  default: false
                  description: >-
                    Показывать ли кнопку **Закрыть** в платежном интерфейсе.
                    Нажатие на кнопку закрывает платежный интерфейс и
                    перенаправляет пользователя на адрес, указанный в параметре
                    `settings.return_url`.
                  type: boolean
              type: object
          type: object
        mode:
          description: >-
            Платежный интерфейс в режиме Личного кабинета. Принимает значение
            `user_account`. Header содержит только навигационное меню Личного
            кабинета; исключается возможность выбора предмета и оплата покупки;
            режим Личного кабинета доступен только в desktop-режиме.
          enum:
            - user_account
          type: string
        theme:
          default: 63295a9a2e47fab76f7708e1
          description: >-
            Тема платежного интерфейса. Может принимать значения
            `63295a9a2e47fab76f7708e1` для светлой темы (по умолчанию) или
            `63295aab2e47fab76f7708e3` для темной темы. Вы также можете [создать
            собственную
            тему](https://developers.xsolla.com/ru/doc/pay-station/features/ui-theme-customization/#pay_station_ui_theme_customization_in_token)
            и передать ID темы в этом параметре.
          enum:
            - 63295a9a2e47fab76f7708e1
            - 63295aab2e47fab76f7708e3
          type: string
        user_account:
          additionalProperties: false
          description: Объект с данными об учетной записи пользователя.
          properties:
            info:
              additionalProperties: false
              description: Страница **Мой аккаунт**.
              properties:
                enable:
                  default: false
                  description: Показывать ли вкладку в меню. По умолчанию `false`.
                  type: boolean
                order:
                  description: >-
                    Расположение раздела в раскрывающемся меню в платежном
                    интерфейсе.
                  minimum: 1
                  type: integer
              required:
                - enable
                - order
              type: object
            payment_accounts:
              additionalProperties: false
              description: Страница **Сохраненные платежные аккаунты**.
              properties:
                enable:
                  default: false
                  description: Показывать ли вкладку в меню. По умолчанию `false`.
                  type: boolean
              required:
                - enable
              type: object
            subscriptions:
              additionalProperties: false
              description: Страница **Управление подписками**.
              properties:
                enable:
                  default: false
                  description: Показывать ли вкладку в меню. По умолчанию `false`.
                  type: boolean
                order:
                  description: >-
                    Расположение раздела в раскрывающемся меню в платежном
                    интерфейсе.
                  minimum: 1
                  type: integer
              required:
                - enable
                - order
              type: object
          type: object
      type: object
    Cart_admin_payment:
      additionalProperties: false
      properties:
        items:
          items:
            properties:
              quantity:
                description: Количество товара.
                example: 2
                minimum: 1
                type: number
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: t-shirt
                minLength: 1
                type: string
            required:
              - sku
              - quantity
            type: object
          minItems: 1
          type: array
      required:
        - items
      type: object
    Catalog_cart_promotions:
      description: >-
        Примененные ко всей корзине акции. Массив возвращается, если:


        * Акция влияет на общую стоимость корзины при использовании промокода с
        настройкой **Скидка на покупку**.


        * К корзине добавляются бонусные товары.


        Если акции на уровне заказа не применялись, возвращается пустой массив.
      items:
        properties:
          bonus:
            items:
              properties:
                bundle_type:
                  description: >-
                    Тип товара бонусного бандла. Доступно только для бонусного
                    товара типа `bundle`.
                  enum:
                    - standard
                    - virtual_currency_package
                  type: string
                image_url:
                  description: >-
                    URL-адрес изображения бонусного бандла. Недоступно для типа
                    бонусного товара `physical_good`.
                  type: string
                name:
                  description: >-
                    Название бонусного товара. Недоступно для типа бонусного
                    товара `physical_good`.
                  type: string
                quantity:
                  type: integer
                sku:
                  type: string
                type:
                  description: Тип бонусного товара.
                  enum:
                    - virtual_good
                    - virtual_currency
                    - bundle
                    - physical_good
                    - game_key
                    - nft
                  type: string
              type: object
            type: array
          date_end:
            format: date-time
            nullable: true
            type: string
          date_start:
            format: date-time
            nullable: true
            type: string
          discount:
            nullable: true
            properties:
              percent:
                nullable: true
                type: string
              value:
                nullable: true
                type: string
            type: object
          limits:
            properties:
              per_user:
                properties:
                  available:
                    type: integer
                  total:
                    type: integer
                type: object
            type: object
          name:
            type: string
        type: object
      type: array
    Catalog_item_limits:
      description: Ограничения на продажу товара.
      nullable: true
      properties:
        per_item:
          description: Ограничения на продажу для конкретного товара.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое могут приобрести все
                пользователи.
              example: 3
              type: integer
            total:
              description: >-
                Максимальное количество товара, которое могут приобрести все
                пользователи.
              example: 5
              type: integer
          type: object
        per_user:
          description: Ограничения на продажу товара для пользователя.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое может приобрести текущий
                пользователь.
              example: 3
              type: integer
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            recurrent_schedule:
              description: >-
                Период обновления ограничений на продажу товара для
                пользователя.
              properties:
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - daily
                    - weekly
                    - monthly
                    - hourly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: >-
                Максимальное количество товара, которое может приобрести один
                пользователь.
              example: 5
              type: integer
          type: object
      type: object
    Catalog_item_limits_with_hourly:
      description: Ограничения на продажу товара.
      nullable: true
      properties:
        per_item:
          description: Ограничения на продажу для конкретного товара.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое могут приобрести все
                пользователи.
              example: 3
              type: integer
            total:
              description: >-
                Максимальное количество товара, которое могут приобрести все
                пользователи.
              example: 5
              type: integer
          type: object
        per_user:
          description: Ограничения на продажу товара для пользователя.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое может приобрести текущий
                пользователь.
              example: 3
              type: integer
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            recurrent_schedule:
              description: >-
                Период обновления ограничений на продажу товара для
                пользователя.
              properties:
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - daily
                    - weekly
                    - monthly
                    - hourly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: >-
                Максимальное количество товара, которое может приобрести один
                пользователь.
              example: 5
              type: integer
          type: object
      type: object
    Catalog_item_promotions:
      description: >-
        Примененные акции для отдельных товаров в корзине. Массив возвращается,
        если:


        * Скидочная акция настроена для отдельного товара.


        * Используется промокод с настройкой **Скидка на выбранные товары**.


        Если акции на уровне отдельных товаров не применялись, возвращается
        пустой массив.
      items:
        properties:
          bonus:
            items:
              properties:
                bundle_type:
                  description: >-
                    Тип товара бонусного бандла. Доступно только для бонусного
                    товара типа `bundle`.
                  enum:
                    - standard
                    - virtual_currency_package
                  type: string
                image_url:
                  description: >-
                    URL-адрес изображения бонусного бандла. Недоступно для типа
                    бонусного товара `physical_good`.
                  type: string
                name:
                  description: >-
                    Название бонусного товара. Недоступно для типа бонусного
                    товара `physical_good`.
                  type: string
                quantity:
                  type: integer
                sku:
                  type: string
                type:
                  description: Тип бонусного товара.
                  enum:
                    - virtual_good
                    - virtual_currency
                    - bundle
                    - physical_good
                    - game_key
                    - nft
                  type: string
              type: object
            type: array
          date_end:
            format: date-time
            nullable: true
            type: string
          date_start:
            format: date-time
            nullable: true
            type: string
          discount:
            nullable: true
            properties:
              percent:
                nullable: true
                type: string
              value:
                nullable: true
                type: string
            type: object
          limits:
            properties:
              per_user:
                properties:
                  available:
                    type: integer
                  total:
                    type: integer
                type: object
            type: object
          name:
            type: string
        type: object
      type: array
    Code-limit-promo-code:
      properties:
        code:
          $ref: '#/components/schemas/Promotions_coupon_code'
        per_code:
          properties:
            available:
              description: Оставшееся количество использований промокода.
              type: integer
            reserved:
              description: Сколько раз резервировался промокод.
              type: integer
            total:
              description: Максимальное количество использований промокода.
              type: integer
            used:
              description: Сколько раз использовался промокод.
              type: integer
          type: object
      type: object
    Common_admin-image_url:
      description: URL-адрес изображения.
      example: https://image.example.com
      type: string
    Coupon_rewards:
      properties:
        bonus:
          items:
            $ref: '#/components/schemas/Promotions_200-coupon-bonus-reward'
          type: array
        is_selectable:
          description: >-
            Если `true`, то пользователь должен выбрать бонус перед погашением
            купона.
          type: boolean
      type: object
    Game-Keys_422-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Game-Keys_admin-attribute-external_id:
      description: >-
        Уникальный ID атрибута. `external_id` может содержать только строчные и
        заглавные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9-_]+$
      type: string
    Game-Keys_admin-attributes:
      description: Список атрибутов.
      items:
        $ref: '#/components/schemas/attribute'
      type: array
    Game-Keys_admin-post-put-attributes:
      description: >-
        Список атрибутов.

        <div class="notice"><strong>Внимание.</strong> Для товара
        <strong>невозможно указать более 20 атрибутов</strong>. Любые попытки
        превысить данное ограничение вызовут ошибку.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
      maxItems: 20
      type: array
    Game-Keys_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих игре.


        <div class="notice"><strong>Внимание.</strong> Эта часть ответа доступна
        только при отправке параметра запроса
        `additional_fields[]=attributes`.</div>
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/Game-Keys_admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/Game-Keys_value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Game-Keys_client_name:
      description: Название игрового пакета.
      example: The Greatest Game in the World
      type: string
    Game-Keys_description:
      description: Описание игрового пакета.
      example: Description of the greatest game in the world.
      type: string
    Game-Keys_drm_sku:
      description: Уникальный ID платформы.
      enum:
        - steam
        - playstation
        - xbox
        - uplay
        - origin
        - drmfree
        - gog
        - epicgames
        - nintendo_eshop
        - discord_game_store
        - oculus
        - rockstar
        - viveport
        - stadia
      example: steam
      type: string
    Game-Keys_entitlement_item:
      properties:
        attributes:
          $ref: '#/components/schemas/Game-Keys_client-attributes'
        description:
          $ref: '#/components/schemas/Game-Keys_description'
        drm:
          $ref: '#/components/schemas/Game-Keys_drm_sku'
        game_sku:
          $ref: '#/components/schemas/Game-Keys_game_sku'
        image_url:
          $ref: '#/components/schemas/Game-Keys_image_url'
        is_pre_order:
          description: Находится ли игра в статусе предзаказа.
          example: false
          type: boolean
        name:
          $ref: '#/components/schemas/Game-Keys_client_name'
        project_id:
          $ref: '#/components/schemas/Game-Keys_project_id'
      type: object
    Game-Keys_game_sku:
      description: Уникальный ID пакета ключей.
      example: theGreatestGameSku
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9_\-–.]*$
      type: string
    Game-Keys_image_url:
      description: URL-адрес изображения.
      example: https://none
      type: string
    Game-Keys_project_id:
      description: >-
        ID проекта. Вы можете найти этот параметр в [Личном
        кабинете](https://publisher.xsolla.com/) рядом с названием проекта.
      example: 44056
      type: integer
    Game-Keys_regions:
      items:
        properties:
          id:
            example: 1
            type: integer
        type: object
      type: array
    Game-Keys_schemas-client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих товару. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Game-Keys_value-external_id:
      description: >-
        Уникальный ID значения атрибута. `external_id` может содержать только
        строчные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_value
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
    Game-key-item-limit:
      description: Ограничения на продажу товара.
      properties:
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        recurrent_schedule:
          $ref: '#/components/schemas/game_key_recurrent_schedule'
      type: object
    Pagination_has-more:
      description: Используется как индикатор того, что остались еще страницы.
      example: true
      type: boolean
    Pagination_total-items-count:
      description: Общее количество игр, которыми владеет пользователь.
      example: 10
      type: integer
    Promo_code_rewards:
      properties:
        bonus:
          items:
            $ref: '#/components/schemas/Promotions_200-promo-code-bonus-reward'
          type: array
        discount:
          $ref: '#/components/schemas/Promotions_200-coupon-discount-reward'
        discounted_items:
          $ref: '#/components/schemas/Promotions_discounted_items'
        is_selectable:
          description: >-
            Если `true`, пользователь должен выбрать бонус перед погашением
            промокода.
          type: boolean
      type: object
    Promo_code_rewards_verify:
      properties:
        bonus:
          items:
            $ref: '#/components/schemas/Promotions_200-promo-code-bonus-reward'
          type: array
        discount:
          $ref: '#/components/schemas/Promotions_200-coupon-discount-reward'
        discounted_items:
          $ref: '#/components/schemas/Promotions_discounted_items_verify'
        is_selectable:
          description: >-
            Если `true`, пользователь должен выбрать бонус перед погашением
            промокода.
          type: boolean
      type: object
    Promotions_200-coupon-bonus-reward:
      properties:
        item:
          properties:
            bundle_type:
              description: Тип бандла. Возвращается, если тип элемента является бандлом.
              enum:
                - standard
                - virtual_currency_package
              type: string
            content:
              type: array
            description:
              description: Описание товара.
              example: Game description
              nullable: true
              type: string
            image_url:
              description: URL-адрес изображения.
              example: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              nullable: true
              type: string
            name:
              description: Название товара.
              example:
                en: Game name
              type: object
            sku:
              description: >-
                Уникальный ID товара. Артикул может содержать только строчные и
                заглавные латинские буквы, цифры, точки, тире и подчеркивания.
              example: game_01
              type: string
            type:
              description: >-
                Тип товара:
                `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
              example: unit
              type: string
            unit_items:
              description: >-
                Если товар имеет тип unit, он включает в себя все товары в
                юните. В большинстве случаев пользователь должен выбрать один из
                них в качестве бонуса по купону.
              items:
                properties:
                  drm_name:
                    description: Название платформы.
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      Уникальный ID платформы. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: steam
                    type: string
                  is_free:
                    type: boolean
                  name:
                    description: Название товара.
                    example: Game name
                    type: string
                  sku:
                    description: >-
                      Уникальный ID товара. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: game_01
                    type: string
                  type:
                    description: 'Тип товара: `game_key`.'
                    example: game_key
                    type: string
                type: object
              type: array
          type: object
        quantity:
          default: 1
          description: Количество товаров.
          type: number
      type: object
    Promotions_200-coupon-discount-reward:
      description: >-
        Процент скидки. 

        Цена корзины будет уменьшена с использованием значения, рассчитанного с
        использованием этого процента, а затем округлена до 2 знаков после
        запятой.
      nullable: true
      properties:
        percent:
          example: '10.00'
          type: string
      type: object
    Promotions_200-get-bonus-promotion-model:
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/promotion_user-attribute_conditions_model-get'
        bonus:
          items:
            description: >-
              Список товаров, которые будут добавлены в покупку пользователя в
              качестве бонуса.
            properties:
              quantity:
                default: 1
                description: Количество товаров.
                type: number
              sku:
                default: elven_shield
                description: Артикул товара.
                type: string
            type: object
          nullable: true
          type: array
        condition:
          description: >-
            Набор товаров, которые необходимо включить в покупку для применения
            акции. Если этот параметр равен `null`, акция будет применена к
            любым покупкам в рамках проекта.
          items:
            properties:
              sku:
                default: elven_sword
                description: Артикул товара.
                type: string
            type: object
          nullable: true
          type: array
        excluded_promotions:
          $ref: '#/components/schemas/excluded_promotions'
        id:
          description: ID акции. Уникальный идентификатор акции в рамках проекта.
          type: integer
        is_enabled:
          default: true
          type: boolean
        limits:
          $ref: '#/components/schemas/Promotions_promotion_limits_response'
        name:
          additionalProperties:
            type: string
          description: >-
            Название акции. Данный параметр должен содержать пары
            ключ/значение, 

            где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение —
            строка.
          example:
            de-DE: Sommersaison Bonus
            en-US: Summer season bonus
          type: object
        price_conditions:
          $ref: '#/components/schemas/price_conditions_bonus'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
      type: object
    Promotions_200-get-promocode-promotion-model:
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/promotion_user-attribute_conditions_model-get'
        bonus:
          $ref: '#/components/schemas/Promotions_coupon_bonus'
        discount:
          example:
            discount:
              percent: '10.99'
          nullable: true
          properties:
            percent:
              $ref: '#/components/schemas/Promotions_promotion_discount_percent'
          type: object
        discounted_items:
          $ref: '#/components/schemas/Promotions_discounted_items'
        excluded_promotions:
          $ref: '#/components/schemas/excluded_promotions'
        external_id:
          $ref: '#/components/schemas/Promotions_coupon-external_id'
        is_enabled:
          $ref: '#/components/schemas/Promotions_coupon-is_enabled'
        item_price_conditions:
          $ref: '#/components/schemas/item_price_conditions_promocode'
        name:
          $ref: '#/components/schemas/Promotions_coupon_name'
        price_conditions:
          $ref: '#/components/schemas/price_conditions_promocode'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
        redeem_code_limit:
          $ref: '#/components/schemas/Promotions_redeem_code_limit'
        redeem_total_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
        redeem_user_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
        total_limit_state:
          $ref: '#/components/schemas/Promotions_promocode_total_limit_state'
      type: object
    Promotions_200-get-promotion-model:
      properties:
        bonus:
          items:
            $ref: '#/components/schemas/Promotions_200-coupon-bonus-reward'
          type: array
        condition:
          $ref: '#/components/schemas/Promotions_promotion_condition'
        discount:
          example:
            discount:
              percent: '10.99'
          nullable: true
          properties:
            percent:
              $ref: '#/components/schemas/Promotions_promotion_discount_percent'
          type: object
        id:
          $ref: '#/components/schemas/Promotions_promotion_id'
        is_enabled:
          $ref: '#/components/schemas/Promotions_coupon-is_enabled'
        limits:
          $ref: '#/components/schemas/Promotions_promotion_limits_response'
        name:
          $ref: '#/components/schemas/Promotions_coupon_name'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
        type:
          $ref: '#/components/schemas/Promotions_promotion_type'
      type: object
    Promotions_200-get-unique-catalog-offer-promotion-model:
      properties:
        external_id:
          $ref: '#/components/schemas/Promotions_coupon-external_id'
        is_enabled:
          $ref: '#/components/schemas/Promotions_coupon-is_enabled'
        items:
          $ref: '#/components/schemas/Promotions_unique_catalog_offer_items'
        name:
          $ref: '#/components/schemas/Promotions_coupon_name'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
        redeem_code_limit:
          $ref: '#/components/schemas/Promotions_redeem_code_limit'
        redeem_total_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
        redeem_user_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
        total_limit_state:
          $ref: '#/components/schemas/Promotions_coupon_total_limit_state'
      type: object
    Promotions_200-promo-code-bonus-reward:
      properties:
        item:
          properties:
            description:
              description: Описание товара.
              example: Game description
              type: string
            image_url:
              description: URL-адрес изображения.
              example: >-
                https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
              type: string
            name:
              description: Название товара.
              example: Game name
              type: string
            sku:
              description: >-
                Уникальный ID товара. Артикул может содержать только строчные и
                заглавные латинские буквы, цифры, точки, тире и подчеркивания.
              example: game_01
              type: string
            type:
              description: >-
                Тип товара:
                `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
              example: unit
              type: string
            unit_items:
              description: >-
                Если товар имеет тип unit, он включает в себя все товары в
                юните. В большинстве случаев пользователь должен выбрать один из
                них в качестве бонуса по промокоду.
              items:
                properties:
                  drm_name:
                    description: Название платформы.
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      Уникальный ID платформы. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: steam
                    type: string
                  is_free:
                    $ref: '#/components/schemas/value-is_free'
                  name:
                    description: Название товара.
                    example: Game name
                    type: string
                  sku:
                    description: >-
                      Уникальный ID товара. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: game_01
                    type: string
                  type:
                    description: 'Тип товара: `game_key`.'
                    example: game_key
                    type: string
                type: object
              type: array
          type: object
        quantity:
          default: 1
          description: Количество товаров.
          type: number
      type: object
    Promotions_422_limit_error:
      description: Достигнут лимит погашения.
      example:
        errorCode: 9804
        errorMessage: '[0401-9804]: You have reached the coupon redemption limit.'
        statusCode: 422
      properties:
        errorCode:
          example: 9804
          type: integer
        errorMessage:
          example: '[0401-9804]: You have reached the coupon redemption limit.'
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Promotions_422_reglock_error:
      description: Купон недоступен в регионе пользователя.
      example:
        errorCode: 9804
        errorMessage: '[0401-9804]: You have reached the coupon redemption limit.'
        statusCode: 422
      properties:
        errorCode:
          example: 9808
          type: integer
        errorMessage:
          example: '[0401-9808]: Coupon is not available in your region.'
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Promotions_cart_item_discount:
      default: '10.00'
      description: |-
        Процент скидки. 

        Цена товара в корзине будет уменьшена с использованием значения, 
        рассчитанного с использованием этого процента, а затем округлена 
        до 2 знаков после запятой.
      example: '10.00'
      nullable: false
      type: string
    Promotions_coupon-external_id:
      default: coupon_external_id
      description: >-
        Уникальный ID акции. `external_id` может содержать только строчные и
        заглавные латинские буквы, цифры, тире и подчеркивания.
      example: coupon_external_id
      type: string
    Promotions_coupon-generate-count:
      example: 10
      maximum: 100000
      minimum: 1
      type: integer
    Promotions_coupon-is_enabled:
      default: true
      type: boolean
    Promotions_coupon-redeem_total_limit:
      default: 10
      description: Ограничивает общее количество купонов.
      example: 10
      nullable: true
      type: integer
    Promotions_coupon-redeem_user_limit:
      default: 10
      description: Ограничивает общее количество купонов, погашаемых одним пользователем.
      example: 10
      nullable: true
      type: integer
    Promotions_coupon_bonus:
      items:
        description: >-
          Список товаров, которые будут добавлены в покупку пользователя в
          качестве бонуса.
        properties:
          quantity:
            default: 1
            description: Количество товаров.
            type: number
          sku:
            default: elven_shield
            description: Артикул товара.
            type: string
        type: object
      nullable: true
      type: array
    Promotions_coupon_code:
      default: WINTER2021
      description: Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
      example: WINTER2021
      maxLength: 128
      minLength: 1
      pattern: ^[a-zA-Z0-9]+$
      type: string
    Promotions_coupon_date_end:
      default: '2020-04-15T18:16:00+05:00'
      description: >-
        Дата, когда ваша акция будет завершена. Может быть `null`. Если
        `date_end` равно `null`, акция будет неограниченна по времени.
      format: date-time
      nullable: true
      type: string
    Promotions_coupon_date_start:
      default: '2020-04-15T18:16:00+05:00'
      description: Дата, когда начнется ваша акция.
      format: date-time
      nullable: true
      type: string
    Promotions_coupon_name:
      additionalProperties:
        type: string
      default:
        de-DE: Gutscheintitel
        en-US: Coupon title
      description: >-
        Название акции. Данный параметр должен содержать пары ключ/значение, 

        где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение —
        строка.
      example:
        de-DE: Gutscheintitel
        en-US: Coupon title
      type: object
    Promotions_coupon_total_limit_state:
      description: Ограничения для каждого уникального кода купона.
      nullable: true
      properties:
        available:
          description: Оставшееся количество использований купона.
          example: 3
          type: integer
        reserved:
          description: Зарезервированное количество купонов.
          example: 3
          type: integer
        used:
          description: Сколько раз использовался купон.
          example: 5
          type: integer
      type: object
    Promotions_discounted_items:
      description: Список товаров, на которые действует скидка по промокоду.
      items:
        description: Скидка на определенные товары в корзине.
        minItems: 1
        properties:
          discount:
            nullable: false
            properties:
              percent:
                $ref: '#/components/schemas/Promotions_cart_item_discount'
            required:
              - percent
            type: object
          sku:
            default: elven_shield
            description: Артикул товара.
            type: string
        required:
          - sku
          - discount
        type: object
      nullable: true
      type: array
    Promotions_discounted_items_verify:
      description: Список товаров, на которые действует скидка по промокоду.
      items:
        description: Скидка на определенные товары.
        properties:
          description:
            description: Описание товара.
            example: Game description
            type: string
          discount:
            nullable: false
            properties:
              percent:
                $ref: '#/components/schemas/Promotions_cart_item_discount'
            type: object
          image_url:
            description: URL-адрес изображения.
            example: >-
              https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
            type: string
          name:
            description: Название товара.
            example: Game name
            type: string
          sku:
            description: >-
              Уникальный ID товара. Артикул может содержать только строчные и
              заглавные латинские буквы, цифры, точки, тире и подчеркивания.
            example: game_01
            type: string
          type:
            description: >-
              Тип товара:
              `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
            example: unit
            type: string
          unit_items:
            description: >-
              Если товар имеет тип unit, он включает в себя все товары в юните.
              В большинстве случаев пользователь должен выбрать один из них в
              качестве бонуса по промокоду.
            items:
              properties:
                drm_name:
                  description: Название платформы.
                  example: Steam
                  type: string
                drm_sku:
                  description: >-
                    Уникальный ID платформы. Артикул может содержать только
                    строчные и заглавные латинские буквы, цифры, точки, тире и
                    подчеркивания.
                  example: steam
                  type: string
                name:
                  description: Название товара.
                  example: Game name
                  type: string
                sku:
                  description: >-
                    Уникальный ID товара. Артикул может содержать только
                    строчные и заглавные латинские буквы, цифры, точки, тире и
                    подчеркивания.
                  example: game_01
                  type: string
                type:
                  description: 'Тип товара: `game_key`.'
                  example: game_key
                  type: string
              type: object
            type: array
        type: object
      nullable: true
      type: array
    Promotions_is_enabled:
      description: Активирована ли акция.
      example: true
      type: boolean
    Promotions_name:
      additionalProperties:
        type: string
      default:
        de-DE: Artikeltitel
        en-US: Item title
      description: >-
        Название товара. Данный параметр должен содержать пары ключ/значение, 

        где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение —
        строка.
      example:
        de-DE: Artikeltitel
        en-US: Item title
      type: object
    Promotions_promocode_total_limit_state:
      description: Лимиты для каждого уникального промокода.
      nullable: true
      properties:
        available:
          description: Оставшееся количество использований промокода.
          example: 3
          type: integer
        reserved:
          description: Зарезервированное количество промокодов.
          example: 3
          type: integer
        used:
          description: Сколько раз использовался промокод.
          example: 5
          type: integer
      type: object
    Promotions_promotion_condition:
      items:
        description: Список товаров, за которые пользователь получил бонус.
        properties:
          item:
            properties:
              description:
                description: Описание товара.
                example: Game description
                nullable: true
                type: string
              external_id:
                description: >-
                  External ID акции. Уникальный идентификатор акции в рамках
                  проекта.
                maxLength: 255
                minLength: 1
                pattern: ^[-_.\d\w]+$
                type: string
              image_url:
                description: URL-адрес изображения.
                example: >-
                  https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                nullable: true
                type: string
              is_enabled:
                type: boolean
              name:
                $ref: '#/components/schemas/Promotions_name'
              redeem_code_limit:
                $ref: '#/components/schemas/Promotions_redeem_code_limit'
              redeem_total_limit:
                nullable: true
                type: integer
              redeem_user_limit:
                nullable: true
                type: integer
              sku:
                $ref: '#/components/schemas/Promotions_sku'
              type:
                $ref: '#/components/schemas/Promotions_type'
            type: object
        type: object
      nullable: true
      type: array
    Promotions_promotion_discount_percent:
      default: '10.00'
      description: >-
        Процент скидки. 

        Цена корзины будет уменьшена с использованием значения, рассчитанного с
        использованием этого процента, а затем округлена до 2 знаков после
        запятой.
      example: '10.00'
      nullable: true
      type: string
    Promotions_promotion_id:
      description: ID акции. Уникальный идентификатор акции в рамках проекта.
      example: 1
      type: integer
    Promotions_promotion_limits:
      description: Ограничения акции.
      properties:
        per_user:
          description: Ограничение количества использований акций отдельным пользователем.
          nullable: true
          type: integer
        recurrent_schedule:
          $ref: '#/components/schemas/promotion_recurrent_schedule_response'
      type: object
    Promotions_promotion_limits_response:
      description: Ограничения акции.
      properties:
        per_item:
          description: Глобальное ограничение товара.
          example: 10
          nullable: true
          type: integer
        per_user:
          description: Ограничение количества использований акций отдельным пользователем.
          nullable: true
          properties:
            total:
              description: >-
                Общее количество единиц товара, которое может купить
                пользователь. Вы можете установить данное значение в Личном
                кабинете или использовать методы администратора для сущностей
                магазина (объект limits).
              example: 5
              type: integer
          type: object
        recurrent_schedule:
          $ref: '#/components/schemas/promotion_recurrent_schedule_response'
      type: object
    Promotions_promotion_type:
      description: Тип акции.
      example: item_discount
      type: string
    Promotions_redeem_code_limit:
      default: 10
      description: Количество погашений по коду.
      example: 10
      nullable: true
      type: integer
    Promotions_selected_unit_items:
      additionalProperties:
        type: string
      description: >-
        Награда, выбранная пользователем.

        Ключ объекта — это артикул юнита, а значение — артикул одного из товаров
        в юните.
      example:
        game_1: game_1_steam
        game_2: game_2_playstation
      type: object
    Promotions_sku:
      description: >-
        Уникальный ID товара. Артикул может содержать только строчные и
        заглавные латинские буквы, цифры, точки, тире и подчеркивания.
      example: booster_mega_1
      type: string
    Promotions_type:
      description: >-
        Тип товара:
        `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
      type: string
    Promotions_unique_catalog_offer_items:
      description: >-
        Список артикулов товаров, которые доступны после использования
        уникального предложения по каталогу.
      items:
        $ref: '#/components/schemas/sku'
      type: array
    Regions_200-region-model:
      example:
        value:
          countries:
            - JP
            - CN
            - VN
          id: 44
          name:
            de-DE: Asien
            en-US: Asia
      properties:
        countries:
          $ref: '#/components/schemas/Regions_countries'
        id:
          $ref: '#/components/schemas/Regions_region_id'
        name:
          $ref: '#/components/schemas/Regions_name'
      type: object
    Regions_200-region-short-model:
      properties:
        id:
          $ref: '#/components/schemas/Regions_region_id'
        name:
          $ref: '#/components/schemas/Regions_name'
      type: object
    Regions_countries:
      description: >-
        Список стран, которые необходимо добавить в регион.

        <br>Двухбуквенное обозначение страны в верхнем регистре согласно
        стандарту [ISO 3166-1
        alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

        Список стран, поддерживаемых Xsolla, приведен [в
        документации](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/).

        <br>Пример: `["JP", "CN", "VN"]`
      items:
        type: string
      type: array
    Regions_name:
      additionalProperties:
        type: string
      default:
        de-DE: Asien
        en-US: Asia
      description: >-
        Название региона. Данный параметр должен содержать пары ключ/значение,
        где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение —
        строка.
      example:
        de-DE: Asien
        en-US: Asia
      type: object
    Regions_region_id:
      description: ID региона. Уникальный идентификатор региона в рамках проекта.
      example: 42
      type: integer
    Upsell-422-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable entity. The property `is_enabled` is
            required
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Upsell-model:
      description: Тип апселла.
      properties:
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        items:
          default: null
          description: Массив артикулов товаров
          example:
            - game_sku
          items:
            type: string
          type: array
        type:
          enum:
            - fixed_list
          example: true
          type: string
      required:
        - is_enabled
        - type
        - items
      type: object
    Upsell-model-not-fixed-list:
      description: Тип апселла.
      properties:
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        items:
          default: null
          description: Пустой массив артикулов товаров.
          example:
            - null
          items:
            type: string
          type: array
        type:
          enum:
            - most_sellable
            - only_promotions
          example: true
          type: string
      required:
        - is_enabled
        - type
      type: object
    Upsell_item:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          description: Описание товара.
          example: Big Rocket - description
          type: string
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        image_url:
          description: URL-адрес изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        is_free:
          $ref: '#/components/schemas/value-is_free'
        limits:
          $ref: '#/components/schemas/Catalog_item_limits'
        name:
          description: Название товара.
          example: Big Rocket
          type: string
        periods:
          $ref: '#/components/schemas/item-periods-response'
        price:
          description: Цены на товар.
          nullable: true
          properties:
            amount:
              description: Цена товара со скидкой.
              example: '100.99'
              type: string
            amount_without_discount:
              description: Цена товара.
              example: '100.99'
              type: string
            currency:
              description: >-
                Валюта, в которой указана цена товара. Трехбуквенный код в
                соответствии со стандартом [ISO
                4217](https://en.wikipedia.org/wiki/ISO_4217).
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_good
          type: string
        virtual_item_type:
          description: Тип виртуального предмета.
          enum:
            - consumable
            - non_consumable
            - non_renewing_subscription
          example: non-consumable
          type: string
          x-enumDescriptions:
            consumable: >-
              Предмет исчезает из инвентаря после использования (например,
              патроны).
            non_consumable: Предмет остается в инвентаре в течение неограниченного времени.
            non_renewing_subscription: >-
              Предмет с ограниченным сроком действия, который может служить
              представлением доступа к сервисам или контенту в течение
              ограниченного периода времени.
        virtual_prices:
          description: Виртуальные цены.
          items:
            description: Виртуальная цена.
            properties:
              amount:
                description: Цена товара со скидкой в виртуальной валюте.
                example: 100
                type: integer
              amount_without_discount:
                description: Цена товара.
                example: 200
                type: integer
              description:
                description: Описание виртуальной валюты.
                example: Big Rocket - description
                type: string
              image_url:
                description: Изображение виртуальной валюты.
                example: http://image.png
                type: string
              is_default:
                description: Является ли данная цена товара ценой по умолчанию.
                example: true
                type: boolean
              name:
                description: Название виртуальной валюты.
                example: SHOTGUN FOR TRUE RAIDERS
                type: string
              sku:
                description: Артикул виртуальной валюты.
                example: vc_test
                type: string
              type:
                description: Тип виртуальной валюты.
                example: virtual_currency
                type: string
            type: object
          type: array
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
      type: object
    Upsell_item-list:
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          items:
            $ref: '#/components/schemas/Upsell_item'
          type: array
      type: object
    User-limit-coupon:
      properties:
        per_user:
          properties:
            available:
              description: Оставшееся количество использований купона пользователем.
              example: 9
              type: integer
            total:
              description: Максимальное количество использований купона для пользователя.
              example: 10
              type: integer
          type: object
      type: object
    User-limit-item:
      properties:
        per_user:
          properties:
            available:
              description: >-
                Оставшееся количество товаров, доступных пользователю для
                покупки.
              example: 9
              type: integer
            total:
              description: >-
                Максимальное количество товаров, которые пользователь может
                купить.
              example: 10
              type: integer
          type: object
      type: object
    User-limit-promo-code:
      properties:
        per_user:
          properties:
            available:
              description: Оставшееся количество использований промокода пользователем.
              example: 9
              type: integer
            total:
              description: >-
                Максимальное количество использований промокода для
                пользователя.
              example: 10
              type: integer
          type: object
      type: object
    User-limit-promotion:
      properties:
        per_user:
          properties:
            available:
              description: >-
                Оставшееся количество раз, когда пользователь может
                воспользоваться акцией.
              example: 9
              type: integer
            total:
              description: >-
                Максимальное количество раз, которое пользователь может
                использовать акцию.
              example: 10
              type: integer
          type: object
      type: object
    User-limit_available:
      description: >-
        Оставшееся количество товаров для продажи или доступных акций для
        пользователя в пределах установленных ограничений.
      minimum: 1
      type: integer
    User-limit_available_flexible:
      description: >-
        Оставшееся количество товаров для продажи или доступных акций для
        пользователя в пределах установленных ограничений.
      minimum: 0
      type: integer
    User-limit_user:
      properties:
        user_external_id:
          $ref: '#/components/schemas/User-limit_user-external-id'
      required:
        - user_external_id
      type: object
    User-limit_user-external-id:
      description: External ID пользователя.
      minLength: 1
      pattern: ^\S+$
      type: string
    User-limit_user_flexible:
      nullable: true
      properties:
        user_external_id:
          $ref: '#/components/schemas/User-limit_user-external-id'
      type: object
    Value-point-item-model:
      properties:
        can_delete:
          description: "Может ли призовой балл быть удален. Если `false`\_вы не можете удалить призовой балл, так как есть одна или несколько цепочек наград, в которой он используется. Чтобы удалить призовой балл, сначала [удалите](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-delete-reward-chain/) все все цепочки наград с ним.\n\nЕсли `true`, призовой балл не используется ни в одной цепочке наград и вы можете [удалить](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-delete-value-point/) его."
          type: boolean
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          type: string
        is_clan:
          $ref: '#/components/schemas/is_clan'
        is_enabled:
          type: boolean
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          description: >-
            Дополнительные ассеты предмета, такие как скриншоты, видео игрового
            процесса и так далее.
          example:
            - type: image
              url: >-
                https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
          items:
            properties:
              type:
                description: 'Тип медиа: `image`/`video`.'
                enum:
                  - image
                  - video
                example: image
                type: string
              url:
                description: Ссылка на файл.
                example: >-
                  https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                type: string
            type: object
          type: array
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          description: Определяет порядок расположения.
          example: 1
          type: integer
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: booster_mega_1
          maxLength: 255
          minLength: 1
          pattern: ^[a-zA-Z0-9_\-–.]*$
          type: string
        type:
          description: Тип товара.
          type: string
      type: object
    Value-points-item-model:
      properties:
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          type: string
        is_clan:
          $ref: '#/components/schemas/is_clan'
        is_enabled:
          type: boolean
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          description: >-
            Дополнительные ассеты предмета, такие как скриншоты, видео игрового
            процесса и так далее.
          example:
            - type: image
              url: >-
                https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
          items:
            properties:
              type:
                description: 'Тип медиа: `image`/`video`.'
                enum:
                  - image
                  - video
                example: image
                type: string
              url:
                description: Ссылка на файл.
                example: >-
                  https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
                type: string
            type: object
          type: array
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          description: Определяет порядок расположения.
          example: 1
          type: integer
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: booster_mega_1
          maxLength: 255
          minLength: 1
          pattern: ^[a-zA-Z0-9_\-–.]*$
          type: string
        type:
          description: Тип товара.
          type: string
      type: object
    Virtual-Currency-Package-item-limit:
      description: Ограничения на продажу товара.
      properties:
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_currency_package_recurrent_schedule'
      type: object
    Virtual-Currency-item-limit:
      description: Ограничения на продажу товара.
      properties:
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_currency_recurrent_schedule'
      type: object
    Virtual-Item-item-limit:
      description: Ограничения на продажу товара.
      properties:
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        recurrent_schedule:
          $ref: '#/components/schemas/virtual_item_recurrent_schedule'
      type: object
    Virtual-Items-Currency_422-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        errorMessageExtended:
          type: array
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    Virtual-Items-Currency_admin-attributes:
      allOf:
        - $ref: '#/components/schemas/Virtual-Items-Currency_schemas-admin-attributes'
        - description: Список атрибутов.
    Virtual-Items-Currency_admin-create-vc_prices:
      items:
        example:
          amount: 10
          is_default: true
          is_enabled: true
          sku: com.xsolla.gold_1
        properties:
          amount:
            type: integer
          is_default:
            default: false
            type: boolean
          is_enabled:
            default: false
            description: Цена включена.
            type: boolean
          sku:
            $ref: '#/components/schemas/Virtual-Items-Currency_schemas-sku'
        required:
          - amount
          - currency
          - is_default
          - is_enabled
        type: object
      type: array
    Virtual-Items-Currency_admin-create-virtual-currency:
      properties:
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_deleted:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_deleted'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_hard:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_hard'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/Virtual-Currency-item-limit'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods'
        pre_order:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-pre_order'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
      required:
        - sku
        - name
      type: object
    Virtual-Items-Currency_admin-create-virtual-currency-package:
      anyOf:
        - required:
            - prices
        - required:
            - vc_prices
      properties:
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        content:
          description: >-
            Пакет виртуальной валюты должен содержать только 1 позицию
            виртуальной валюты.
          items:
            properties:
              quantity:
                type: integer
              sku:
                $ref: '#/components/schemas/Virtual-Items-Currency_sku'
            type: object
          maxLength: 1
          minLength: 1
          type: array
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-create'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_deleted:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_deleted'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/Virtual-Currency-Package-item-limit'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods'
        pre_order:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-pre_order'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
      required:
        - sku
        - name
        - description
        - content
      type: object
    Virtual-Items-Currency_admin-create-virtual-item:
      properties:
        attributes:
          $ref: >-
            #/components/schemas/Virtual-Items-Currency_admin-post-put-attributes
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-create'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_schemas-admin-image_url'
        is_deleted:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_deleted'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/Virtual-Item-item-limit'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods'
        pre_order:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-pre_order'
        prices:
          $ref: '#/components/schemas/Virtual-Items_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-create-vc_prices'
      type: object
    Virtual-Items-Currency_admin-get-vc_prices:
      items:
        example:
          amount: 10
          is_default: true
          sku: com.xsolla.gold_1
        properties:
          amount:
            description: Сумма.
            exclusiveMinimum: true
            minimum: 0
            type: number
          is_default:
            default: false
            type: boolean
          sku:
            $ref: '#/components/schemas/Virtual-Items-Currency_schemas-sku'
        required:
          - sku
          - amount
        type: object
      type: array
    Virtual-Items-Currency_admin-groups-create:
      description: >-
        Группы, к которым принадлежит элемент.

        <div class="note"><strong>Примечание.</strong> Строковое значение
        относится к группе `external_id`.</div>
      items:
        properties:
          external_id:
            example: accessory
            type: string
          name:
            example: Accessory
            type: string
        type: string
      type: array
    Virtual-Items-Currency_admin-groups-response:
      default: []
      description: Группы, к которым принадлежит товар.
      example:
        - external_id: horror
          name:
            en: Horror
      items:
        properties:
          external_id:
            example: horror
            type: string
          name:
            additionalProperties:
              type: string
            default:
              en: Horror
            description: >-
              Название элемента. Должно содержать пары ключ/значение, 

              где ключ — это языковой стандарт в {2}формате "^[a-z]", значение —
              строка.
            example:
              de: Horror
              en: Horror
            type: object
        type: object
      type: array
    Virtual-Items-Currency_admin-image_url:
      type: string
    Virtual-Items-Currency_admin-media_list:
      description: >-
        Дополнительные ассеты предмета, такие как скриншоты, видео игрового
        процесса и так далее.
      example:
        - type: image
          url: >-
            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
      items:
        properties:
          type:
            description: 'Тип медиа: `image`/`video`.'
            enum:
              - image
              - video
            example: image
            type: string
          url:
            description: Ссылка на файл.
            example: >-
              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
            type: string
        type: object
      type: array
    Virtual-Items-Currency_admin-post-put-attributes:
      description: >-
        Список атрибутов.

        <div class="notice"><strong>Внимание.</strong> Для товара
        <strong>невозможно указать более 20 атрибутов</strong>. Любые попытки
        превысить данное ограничение вызовут ошибку.</div>
      items:
        $ref: '#/components/schemas/admin-post-put-attribute-item'
      maxItems: 20
      type: array
    Virtual-Items-Currency_admin-pre_order:
      properties:
        description:
          nullable: true
          type: string
        is_enabled:
          type: boolean
        release_date:
          format: date-time
          nullable: true
          type: string
      required:
        - release_date
        - is_enabled
      type: object
    Virtual-Items-Currency_admin-prices:
      items:
        example:
          amount: 10.5
          country_iso: US
          currency: USD
          is_default: true
          is_enabled: true
        properties:
          amount:
            description: Сумма.
            exclusiveMinimum: true
            minimum: 0
            type: number
          country_iso:
            description: >-
              Страна, где доступна эта цена. Двухбуквенный код в соответствии с
              [ISO 3166-1 alpha
              2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
            example: US
            nullable: true
            type: string
          currency:
            description: >-
              Валюта, в которой указана цена товара. Трехбуквенный код в
              соответствии с [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
              Подробную информацию о [валютах, поддерживаемых Xsolla, смотрите в
              документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
            example: USD
            type: string
          is_default:
            default: false
            type: boolean
          is_enabled:
            default: true
            type: boolean
        required:
          - amount
          - currency
        type: object
      type: array
    Virtual-Items-Currency_admin-regions:
      items:
        properties:
          id:
            example: 1
            minimum: 1
            type: integer
        type: object
      type: array
    Virtual-Items-Currency_admin-virtual-currency:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_hard:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_hard'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
      type: object
    Virtual-Items-Currency_admin-virtual-currency-package:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        bundle_type:
          default: virtual_currency_package
          example: virtual_currency_package
          type: string
        content:
          items:
            properties:
              image_url:
                $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
              name:
                $ref: '#/components/schemas/name-localization-object'
              quantity:
                type: integer
              sku:
                $ref: '#/components/schemas/Virtual-Items-Currency_sku'
            type: object
          type: array
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
      type: object
    Virtual-Items-Currency_admin-virtual-item:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-attributes'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          $ref: '#/components/schemas/description-localization-object'
        groups:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-groups-response'
        image_url:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-image_url'
        is_enabled:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_enabled'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        is_show_in_store:
          $ref: '#/components/schemas/Virtual-Items-Currency_is_show_in_store'
        limits:
          $ref: '#/components/schemas/admin-item-limit-response'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/Virtual-Items-Currency_order'
        periods:
          $ref: '#/components/schemas/item-periods-response'
        prices:
          $ref: '#/components/schemas/Virtual-Items_admin-prices'
        regions:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-regions'
        sku:
          $ref: '#/components/schemas/Virtual-Items-Currency_sku'
        type:
          $ref: '#/components/schemas/Virtual-Items-Currency_type'
        vc_prices:
          $ref: '#/components/schemas/Virtual-Items-Currency_admin-get-vc_prices'
      type: object
    Virtual-Items-Currency_client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих товару. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            additionalProperties:
              nullable: true
              type: string
            description: Название атрибута.
            example: Genre
            type: object
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    Virtual-Items-Currency_is_deleted:
      type: boolean
    Virtual-Items-Currency_is_enabled:
      type: boolean
    Virtual-Items-Currency_is_hard:
      type: boolean
    Virtual-Items-Currency_is_show_in_store:
      type: boolean
    Virtual-Items-Currency_item:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          additionalProperties:
            nullable: true
            type: string
          description: Описание товара.
          example: Big Rocket - description
          type: object
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        image_url:
          description: URL-адрес изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          description: ID предмета (артикул).
          type: number
        limits:
          $ref: '#/components/schemas/client-item-limit-response'
        name:
          additionalProperties:
            nullable: true
            type: string
          description: Название товара.
          example: Big Rocket
          type: object
        periods:
          $ref: '#/components/schemas/item-periods-response'
        price:
          description: Цены на товар.
          nullable: true
          properties:
            amount:
              description: Цена товара со скидкой.
              example: '100.99'
              type: string
            amount_without_discount:
              description: Цена товара.
              example: '100.99'
              type: string
            currency:
              description: >-
                Валюта, в которой указана цена товара. Трехбуквенный код в
                соответствии с [ISO
                4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                информацию о [валютах, поддерживаемых Xsolla, смотрите в
                документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_good
          type: string
        virtual_item_type:
          description: Тип виртуального предмета.
          enum:
            - consumable
            - non_consumable
            - non_renewing_subscription
          example: non-consumable
          type: string
          x-enumDescriptions:
            consumable: >-
              Предмет исчезает из инвентаря после использования (например,
              патроны).
            non_consumable: Предмет остается в инвентаре в течение неограниченного времени.
            non_renewing_subscription: >-
              Предмет с ограниченным сроком действия, который может служить
              представлением доступа к сервисам или контенту в течение
              ограниченного периода времени.
        virtual_prices:
          description: Виртуальные цены.
          items:
            description: Виртуальная цена.
            properties:
              amount:
                description: Цена товара со скидкой в виртуальной валюте.
                example: 100
                type: integer
              amount_without_discount:
                description: Цена товара.
                example: 200
                type: integer
              description:
                description: Описание виртуальной валюты.
                example: Big Rocket - description
                type: string
              image_url:
                description: Изображение виртуальной валюты.
                example: http://image.png
                type: string
              is_default:
                description: Является ли данная цена товара ценой по умолчанию.
                example: true
                type: boolean
              name:
                description: Название виртуальной валюты.
                example: SHOTGUN FOR TRUE RAIDERS
                type: string
              sku:
                description: Артикул виртуальной валюты.
                example: vc_test
                type: string
              type:
                description: Тип виртуальной валюты.
                example: virtual_currency
                type: string
            type: object
          type: array
        vp_rewards:
          $ref: '#/components/schemas/client-item-value-point-reward'
      type: object
    Virtual-Items-Currency_item-list:
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          items:
            $ref: '#/components/schemas/Virtual-Items-Currency_item'
          type: array
      type: object
    Virtual-Items-Currency_order:
      description: Определяет порядок расположения.
      example: 1
      type: integer
    Virtual-Items-Currency_schemas-admin-attributes:
      description: Список атрибутов.
      items:
        $ref: '#/components/schemas/attribute'
      type: array
    Virtual-Items-Currency_schemas-admin-image_url:
      description: URL-адрес изображения.
      example: https://image.example.com
      type: string
    Virtual-Items-Currency_schemas-sku:
      description: >-
        Уникальный ID товара. Артикул может содержать только строчные и
        заглавные латинские буквы, цифры, точки, тире и подчеркивания.
      example: bundle_1
      type: string
    Virtual-Items-Currency_sku:
      description: >-
        Уникальный ID товара. Артикул может содержать только строчные и
        заглавные латинские буквы, цифры, точки, тире и подчеркивания.
      example: booster_mega_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9_\-–.]*$
      type: string
    Virtual-Items-Currency_type:
      description: >-
        Тип товара:
        `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
      type: string
    Virtual-Items-Currency_virtual-currency:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          description: Описание товара.
          example: Crystals - description
          type: string
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        image_url:
          description: URL-адрес изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          type: integer
        limits:
          $ref: '#/components/schemas/Catalog_item_limits'
        name:
          description: Название товара.
          example: Big Rocket
          type: string
        periods:
          $ref: '#/components/schemas/item-periods-response'
        price:
          description: Цены на товар.
          nullable: true
          properties:
            amount:
              description: Цена товара со скидкой.
              example: '100.99'
              type: string
            amount_without_discount:
              description: Цена товара.
              example: '100.99'
              type: string
            currency:
              description: >-
                Валюта, в которой указана цена товара. Трехбуквенный код в
                соответствии с [ISO
                4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                информацию о [валютах, поддерживаемых Xsolla, смотрите в
                документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: big_rocket
          type: string
        type:
          description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
          example: virtual_currency
          type: string
        virtual_prices:
          description: Виртуальные цены.
          example:
            - amount: 100
              amount_without_discount: 100
              image_url: http://image.png
              is_default: true
              sku: com.xsolla.crystals_1
          items:
            description: Виртуальная цена.
            properties:
              amount:
                description: Цена товара со скидкой в виртуальной валюте.
                example: 100
                type: integer
              amount_without_discount:
                description: Цена товара.
                example: 200
                type: integer
              description:
                description: Описание виртуальной валюты.
                example: Crystals - description
                type: string
              image_url:
                description: Изображение виртуальной валюты.
                example: http://image.png
                type: string
              is_default:
                description: Является ли данная цена товара ценой по умолчанию.
                example: true
                type: boolean
              name:
                description: Название виртуальной валюты.
                example: Crystals
                type: string
              sku:
                description: Артикул виртуальной валюты.
                example: com.xsolla.vc_1
                type: string
              type:
                description: Тип виртуальной валюты.
                example: virtual_currency
                type: string
            type: object
          type: array
        vp_rewards:
          type: array
      type: object
    Virtual-Items-Currency_virtual-currency-list:
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          items:
            $ref: '#/components/schemas/Virtual-Items-Currency_virtual-currency'
          type: array
      type: object
    Virtual-Items-Currency_virtual-currency-package:
      properties:
        attributes:
          $ref: '#/components/schemas/Virtual-Items-Currency_client-attributes'
        bundle_type:
          description: 'Тип бандла: `standard`/`virtual_currency_package`.'
          example: virtual_currency_package
          type: string
        can_be_bought:
          $ref: '#/components/schemas/Can_be_bought'
        content:
          description: Содержимое пакета виртуальной валюты.
          example:
            - description: Crystal Pack - short description
              image_url: >-
                https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
              name: Crystal Pack
              quantity: 100
              sku: com.xsolla.crystal_pack_1
              type: virtual_currency
          items:
            description: Виртуальная валюта в пакете.
            properties:
              description:
                description: Описание товара.
                example: Big Rocket - description
                type: string
              image_url:
                description: URL-адрес изображения.
                example: >-
                  https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
                type: string
              item_id:
                type: integer
              limits:
                $ref: '#/components/schemas/Catalog_item_limits'
              name:
                description: Название товара.
                example: Big Rocket
                type: string
              quantity:
                description: Количество виртуальной валюты в пакете.
                example: 250
                type: integer
              sku:
                description: >-
                  Уникальный ID товара. Артикул может содержать только строчные
                  и заглавные латинские буквы, цифры, точки, тире и
                  подчеркивания.
                example: com.xsolla.big_rocket_1
                type: string
              type:
                description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
                example: virtual_currency
                type: string
            type: object
          type: array
        custom_attributes:
          $ref: '#/components/schemas/item-custom-attributes-response'
        description:
          description: Описание товара.
          example: Crystal Pack Description
          type: string
        groups:
          $ref: '#/components/schemas/items_client_groups_response'
        image_url:
          description: URL-адрес изображения.
          example: >-
            https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png
          type: string
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          type: integer
        limits:
          $ref: '#/components/schemas/Catalog_item_limits'
        name:
          description: Название товара.
          example: Crystal Pack
          type: string
        periods:
          $ref: '#/components/schemas/item-periods-response'
        price:
          description: Цены на товар.
          properties:
            amount:
              description: Цена товара со скидкой.
              example: '100.99'
              type: string
            amount_without_discount:
              description: Цена товара.
              example: '100.99'
              type: string
            currency:
              description: >-
                Валюта, в которой указана цена товара. Трехбуквенный код в
                соответствии с [ISO
                4217](https://en.wikipedia.org/wiki/ISO_4217). Подробную
                информацию о [валютах, поддерживаемых Xsolla, смотрите в
                документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: >-
            Уникальный ID товара. Артикул может содержать только строчные и
            заглавные латинские буквы, цифры, точки, тире и подчеркивания.
          example: crystal-pack
          type: string
        type:
          description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`.'
          example: bundle
          type: string
        virtual_prices:
          description: Виртуальные цены.
          items:
            description: Виртуальная цена.
            properties:
              amount:
                description: Цена товара со скидкой в виртуальной валюте.
                example: 100
                type: integer
              amount_without_discount:
                description: Цена товара.
                example: 200
                type: integer
              description:
                description: Описание виртуальной валюты.
                example: Big Rocket - description
                type: string
              image_url:
                description: Изображение виртуальной валюты.
                example: http://image.png
                type: string
              is_default:
                description: Является ли данная цена товара ценой по умолчанию.
                example: true
                type: boolean
              name:
                description: Название виртуальной валюты.
                example: SHOTGUN FOR TRUE RAIDERS
                type: string
              sku:
                description: Артикул виртуальной валюты.
                example: vc_test
                type: string
              type:
                description: Тип виртуальной валюты.
                example: virtual_currency
                type: string
            type: object
          type: array
        vp_rewards:
          type: array
      type: object
    Virtual-Items-Currency_virtual-currency-packages:
      properties:
        has_more:
          $ref: '#/components/schemas/Pagination_has-more'
        items:
          items:
            $ref: >-
              #/components/schemas/Virtual-Items-Currency_virtual-currency-package
          type: array
      type: object
    Virtual-Items_admin-prices:
      items:
        example:
          amount: 10.5
          currency: USD
          is_default: true
          is_enabled: true
        properties:
          amount:
            description: Сумма.
            exclusiveMinimum: true
            minimum: 0
            type: number
          country_iso:
            description: >-
              Двухбуквенное обозначение страны в верхнем регистре согласно
              стандарту [ISO 3166-1
              alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Список
              стран, поддерживаемых Xsolla, [приведен в
              документации](https://developers.xsolla.com/ru/doc/shop-builder/references/supported-countries/).
              <br>Пример: `country=US`
            example: US
            type: string
          currency:
            description: >-
              Валюта, в которой указана цена товара. Трехбуквенный код в
              соответствии с [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
              Подробную информацию о [валютах, поддерживаемых Xsolla, смотрите в
              документации](https://developers.xsolla.com/ru/doc/pay-station/references/supported-currencies/).
            example: USD
            type: string
          is_default:
            default: false
            type: boolean
          is_enabled:
            default: true
            type: boolean
        required:
          - amount
          - currency
        type: object
      type: array
    active_promotions_count:
      description: Количество активных акций.
      type: integer
    admin-attribute-external_id:
      description: >-
        Уникальный ID атрибута. `external_id` может содержать только строчные и
        заглавные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9-_]+$
      type: string
    admin-attribute-name:
      additionalProperties:
        type: string
      default:
        de: Genre
        en: Genre
      description: >-
        Объект с локализациями для названия атрибута. Ключи для обозначения
        стран указаны в стандарте ISO 3166-1.
      example:
        de: Genre
        en: Genre
      type: object
    admin-calendar-hard-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/calendar-hard-daily-chain-base'
        - description: >-
            Ежедневная награда с типом calendar_hard в запросах для
            администрирования.
          properties:
            date_end:
              $ref: '#/components/schemas/daily_chain_date_end'
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/admin-daily-chain-step-model'
              type: array
          type: object
    admin-calendar-hard-daily-chain-short-model:
      allOf:
        - $ref: '#/components/schemas/calendar-hard-daily-chain-base'
        - description: Ежедневная награда с типом `calendar_hard` (краткая версия).
          properties:
            date_end:
              $ref: '#/components/schemas/daily_chain_date_end'
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
          type: object
    admin-daily-chain-item-model:
      properties:
        description:
          $ref: '#/components/schemas/long-description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        item_id:
          $ref: '#/components/schemas/item_id'
        name:
          $ref: '#/components/schemas/two-letter-locale'
        quantity:
          description: Количество товара.
          example: 1
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
        type:
          $ref: '#/components/schemas/item_type'
      type: object
    admin-daily-chain-long-model:
      discriminator:
        mapping:
          calendar_hard: '#/components/schemas/admin-calendar-hard-daily-chain-model'
          rolling_skippable: '#/components/schemas/admin-rolling-skippable-daily-chain-model'
          rolling_unskippable: '#/components/schemas/admin-rolling-unskippable-daily-chain-model'
        propertyName: type
      oneOf:
        - $ref: '#/components/schemas/admin-calendar-hard-daily-chain-model'
        - $ref: '#/components/schemas/admin-rolling-skippable-daily-chain-model'
        - $ref: '#/components/schemas/admin-rolling-unskippable-daily-chain-model'
    admin-daily-chain-short-model:
      discriminator:
        mapping:
          calendar_hard: '#/components/schemas/admin-calendar-hard-daily-chain-short-model'
          rolling_skippable: '#/components/schemas/admin-rolling-skippable-daily-chain-short-model'
          rolling_unskippable: >-
            #/components/schemas/admin-rolling-unskippable-daily-chain-short-model
        propertyName: type
      oneOf:
        - $ref: '#/components/schemas/admin-calendar-hard-daily-chain-short-model'
        - $ref: '#/components/schemas/admin-rolling-skippable-daily-chain-short-model'
        - $ref: >-
            #/components/schemas/admin-rolling-unskippable-daily-chain-short-model
    admin-daily-chain-step-model:
      description: Уровень ежедневной награды.
      properties:
        items:
          items:
            $ref: '#/components/schemas/admin-daily-chain-item-model'
          type: array
        step_id:
          $ref: '#/components/schemas/daily_chain_step_id'
        step_number:
          $ref: '#/components/schemas/daily_chain_step_number'
      type: object
    admin-get-reward-chain-item-basic-model:
      description: Цепочка наград.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-get'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        is_reset_after_end:
          $ref: '#/components/schemas/is_reset_after_end'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        periods:
          $ref: '#/components/schemas/periods'
        recurrent_schedule:
          $ref: '#/components/schemas/admin_recurrent_schedule'
        reward_chain_id:
          $ref: '#/components/schemas/reward_chain_id'
        value_point:
          properties:
            amount:
              $ref: '#/components/schemas/value-point-amount'
            description:
              $ref: '#/components/schemas/value-point-description'
            image_url:
              $ref: '#/components/schemas/Common_admin-image_url'
            is_clan:
              $ref: '#/components/schemas/is_clan'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            long_description:
              $ref: '#/components/schemas/value-point-long-description'
            media_list:
              $ref: '#/components/schemas/media_list'
            name:
              $ref: '#/components/schemas/value-point-name'
            order:
              $ref: '#/components/schemas/order'
            sku:
              $ref: '#/components/schemas/value-point-sku'
            type:
              example: value_point
              type: string
          type: object
      type: object
    admin-get-reward-chain-item-clan-basic-model:
      allOf:
        - $ref: '#/components/schemas/admin-get-reward-chain-item-basic-model'
        - description: Цепочка наград для клана.
          properties:
            clan_type:
              $ref: '#/components/schemas/clan_type'
            popup_header:
              $ref: '#/components/schemas/popup_header-two-letter-locale'
            popup_image_url:
              $ref: '#/components/schemas/popup_image_url'
            popup_instruction:
              $ref: '#/components/schemas/popup_instruction-two-letter-locale'
            value_point:
              description: Призовой балл для цепочки наград для клана.
              properties:
                amount:
                  $ref: '#/components/schemas/value-point-amount'
                description:
                  $ref: '#/components/schemas/value-point-description'
                image_url:
                  $ref: '#/components/schemas/Common_admin-image_url'
                is_clan:
                  $ref: '#/components/schemas/is_clan'
                is_enabled:
                  $ref: '#/components/schemas/is_enabled'
                long_description:
                  $ref: '#/components/schemas/value-point-long-description'
                media_list:
                  $ref: '#/components/schemas/media_list'
                name:
                  $ref: '#/components/schemas/value-point-name'
                order:
                  $ref: '#/components/schemas/order'
                sku:
                  $ref: '#/components/schemas/value-point-sku'
                type:
                  example: value_point
                  type: string
              required:
                - sku
              type: object
          type: object
    admin-get-reward-chain-item-clan-full-model:
      allOf:
        - $ref: '#/components/schemas/admin-get-reward-chain-item-full-model'
        - description: Цепочка наград для клана.
          properties:
            clan_type:
              $ref: '#/components/schemas/clan_type'
            popup_header:
              $ref: '#/components/schemas/popup_header-two-letter-locale'
            popup_image_url:
              $ref: '#/components/schemas/popup_image_url'
            popup_instruction:
              $ref: '#/components/schemas/popup_instruction-two-letter-locale'
            top_contributors:
              $ref: '#/components/schemas/top_contributors'
            value_point:
              description: Призовой балл для цепочки наград для клана.
              properties:
                description:
                  $ref: '#/components/schemas/description-localization-object'
                image_url:
                  $ref: '#/components/schemas/image_url'
                is_clan:
                  $ref: '#/components/schemas/is_clan'
                is_enabled:
                  $ref: '#/components/schemas/is_enabled'
                long_description:
                  $ref: '#/components/schemas/long-description-localization-object'
                media_list:
                  $ref: '#/components/schemas/media_list'
                name:
                  $ref: '#/components/schemas/name-localization-object'
                order:
                  $ref: '#/components/schemas/order'
                sku:
                  $ref: '#/components/schemas/sku'
                type:
                  type: string
              required:
                - sku
              type: object
          type: object
    admin-get-reward-chain-item-full-model:
      description: Цепочка наград.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-get'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        is_reset_after_end:
          $ref: '#/components/schemas/is_reset_after_end'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        periods:
          $ref: '#/components/schemas/periods'
        recurrent_schedule:
          $ref: '#/components/schemas/admin_recurrent_schedule'
        reward_chain_id:
          $ref: '#/components/schemas/reward_chain_id'
        steps:
          items:
            $ref: '#/components/schemas/reward_step_short'
          type: array
        value_point:
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            image_url:
              $ref: '#/components/schemas/image_url'
            is_clan:
              $ref: '#/components/schemas/is_clan'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            long_description:
              $ref: '#/components/schemas/long-description-localization-object'
            media_list:
              $ref: '#/components/schemas/media_list'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            sku:
              $ref: '#/components/schemas/sku'
            type:
              type: string
          type: object
      type: object
    admin-item-limit-response:
      description: Ограничения на продажу товара.
      nullable: true
      properties:
        per_item:
          description: Глобальное ограничение товара.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое могут приобрести все
                пользователи.
              type: integer
            reserved:
              type: integer
            sold:
              type: integer
            total:
              description: >-
                Максимальное количество товара, которое могут приобрести все
                пользователи.
              type: integer
          type: object
        per_user:
          description: Ограничение количества товара для отдельного пользователя.
          nullable: true
          properties:
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            total:
              description: >-
                Максимальное количество товара, которое может приобрести один
                пользователь.
              type: integer
          type: object
        recurrent_schedule:
          $ref: '#/components/schemas/admin_recurrent_schedule_response'
      type: object
    admin-item-value-point-reward:
      properties:
        amount:
          description: Количество призовых баллов.
          type: integer
        image_url:
          $ref: '#/components/schemas/Common_admin-image_url'
        item_id:
          $ref: '#/components/schemas/item_id'
        name:
          $ref: '#/components/schemas/name-localization-object'
        sku:
          $ref: '#/components/schemas/sku'
      type: object
    admin-offer-chain-item-model:
      properties:
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          $ref: '#/components/schemas/item_id'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        quantity:
          description: Количество товара.
          example: 1
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
        type:
          $ref: '#/components/schemas/item_type'
      type: object
    admin-offer-chain-long-model:
      description: Цепочка предложений.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-get'
        date_end:
          $ref: '#/components/schemas/offer_chain_date_end'
        date_start:
          $ref: '#/components/schemas/offer_chain_date_start'
        description:
          $ref: '#/components/schemas/description-localization-object'
        id:
          $ref: '#/components/schemas/offer_chain_id'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        recurrent_schedule:
          $ref: '#/components/schemas/offer_chain_recurrent_schedule'
        steps:
          items:
            $ref: '#/components/schemas/admin-offer-chain-step-model'
          type: array
      type: object
    admin-offer-chain-short-model:
      description: Цепочка предложений.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-get'
        date_end:
          $ref: '#/components/schemas/offer_chain_date_end'
        date_start:
          $ref: '#/components/schemas/offer_chain_date_start'
        description:
          $ref: '#/components/schemas/description-localization-object'
        id:
          $ref: '#/components/schemas/offer_chain_id'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        recurrent_schedule:
          $ref: '#/components/schemas/offer_chain_recurrent_schedule'
      type: object
    admin-offer-chain-step-model:
      description: Уровень цепочки предложений.
      properties:
        is_free:
          $ref: '#/components/schemas/offer_chain_is_free'
        items:
          items:
            $ref: '#/components/schemas/admin-offer-chain-item-model'
          type: array
        step_id:
          $ref: '#/components/schemas/offer_chain_step_id'
        step_number:
          $ref: '#/components/schemas/offer_chain_step_number'
        step_price:
          $ref: '#/components/schemas/offer_chain_step_price'
      type: object
    admin-post-put-attribute-item:
      maxItems: 6
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
        values:
          description: >-
            <div class="notice"><strong>Внимание.</strong> <strong>Невозможно
            создать более 6 значений для каждого атрибута</strong>. Любые
            попытки превысить данное ограничение вызовут ошибку.</div>
          example:
            - external_id: strategy
              value:
                de: Strategie
                en: Strategy
            - external_id: action
              value:
                de: Aktion
                en: Action
          items:
            $ref: '#/components/schemas/attribute-value'
          type: array
      required:
        - external_id
        - values
      type: object
    admin-promotions_200-get-coupon-promotion-model:
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/promotion_user-attribute_conditions_model-get'
        bonus:
          $ref: '#/components/schemas/Promotions_coupon_bonus'
        external_id:
          $ref: '#/components/schemas/Promotions_coupon-external_id'
        is_enabled:
          $ref: '#/components/schemas/Promotions_coupon-is_enabled'
        name:
          $ref: '#/components/schemas/Promotions_coupon_name'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
        redeem_code_limit:
          $ref: '#/components/schemas/Promotions_redeem_code_limit'
        redeem_total_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
        redeem_user_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
        total_limit_state:
          $ref: '#/components/schemas/Promotions_coupon_total_limit_state'
      type: object
    admin-promotions_200-get-redeemable-coupon-promotion-model:
      properties:
        bonus:
          $ref: '#/components/schemas/Promotions_coupon_bonus'
        discount:
          description: Только для промокодов.
          example:
            discount:
              percent: '10.99'
          nullable: true
          properties:
            percent:
              default: '10.00'
              description: >-
                Процент скидки. 

                Цена корзины будет уменьшена с использованием значения,
                рассчитанного с использованием этого процента, а затем округлена
                до 2 знаков после запятой.
              example: '10.00'
              nullable: true
              type: string
          type: object
        discounted_items:
          description: >-
            Список товаров, на которые действует скидка по промокоду. Только для
            промокодов.
          items:
            description: Скидка на определенные товары в корзине.
            minItems: 1
            properties:
              discount:
                nullable: false
                properties:
                  percent:
                    $ref: '#/components/schemas/Promotions_cart_item_discount'
                required:
                  - percent
                type: object
              sku:
                default: elven_shield
                description: Артикул товара.
                type: string
            required:
              - sku
              - discount
            type: object
          nullable: true
          type: array
        external_id:
          $ref: '#/components/schemas/Promotions_coupon-external_id'
        is_enabled:
          $ref: '#/components/schemas/Promotions_coupon-is_enabled'
        name:
          $ref: '#/components/schemas/Promotions_coupon_name'
        promotion_periods:
          $ref: '#/components/schemas/promotion_periods'
        redeem_code_limit:
          $ref: '#/components/schemas/Promotions_redeem_code_limit'
        redeem_total_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_total_limit'
        redeem_user_limit:
          $ref: '#/components/schemas/Promotions_coupon-redeem_user_limit'
        total_limit_state:
          $ref: '#/components/schemas/Promotions_coupon_total_limit_state'
      type: object
    admin-rolling-skippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-skippable-daily-chain-base'
        - description: >-
            Ежедневная награда с типом rolling_skippable в запросах для
            администрирования.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/admin-daily-chain-step-model'
              type: array
          type: object
    admin-rolling-skippable-daily-chain-short-model:
      allOf:
        - $ref: '#/components/schemas/rolling-skippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_skippable` (краткая версия).
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
          type: object
    admin-rolling-unskippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-unskippable-daily-chain-base'
        - description: >-
            Ежедневная награда с типом `rolling_unskippable` в запросах для
            администрирования.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/admin-daily-chain-step-model'
              type: array
          type: object
    admin-rolling-unskippable-daily-chain-short-model:
      allOf:
        - $ref: '#/components/schemas/rolling-unskippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_unskippable` (краткая версия).
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            number_of_steps:
              $ref: '#/components/schemas/daily_chain_number_of_step'
            order:
              $ref: '#/components/schemas/order'
          type: object
    admin_attribute_response:
      example:
        value:
          - external_id: genre
            name:
              de: Genre
              en: Genre
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
      type: object
    admin_recurrent_schedule:
      description: Период регулярного сброса цепочки наград.
      nullable: true
      oneOf:
        - description: Еженедельный сброс цепочки наград.
          properties:
            day_of_week:
              $ref: '#/components/schemas/day_of_week'
            displayable_reset_next_date:
              $ref: '#/components/schemas/displayable_reset_next_date'
            displayable_reset_start_date:
              $ref: '#/components/schemas/displayable_reset_start_date'
            interval_type:
              $ref: '#/components/schemas/interval_type_weekly'
            reset_next_date:
              $ref: '#/components/schemas/reset_next_date'
            time:
              $ref: '#/components/schemas/time'
          title: interval_type = еженедельно
          type: object
        - description: Ежемесячный сброс цепочки наград.
          properties:
            day_of_month:
              $ref: '#/components/schemas/day_of_month'
            displayable_reset_next_date:
              $ref: '#/components/schemas/displayable_reset_next_date'
            displayable_reset_start_date:
              $ref: '#/components/schemas/displayable_reset_start_date'
            interval_type:
              $ref: '#/components/schemas/interval_type_monthly'
            reset_next_date:
              $ref: '#/components/schemas/reset_next_date'
            time:
              $ref: '#/components/schemas/time'
          title: interval_type = ежемесячно
          type: object
        - description: >-
            Сброс цепочки наград, выполняемый через временной интервал, заданный
            в часах.
          properties:
            displayable_reset_next_date:
              $ref: '#/components/schemas/displayable_reset_next_date'
            displayable_reset_start_date:
              $ref: '#/components/schemas/displayable_reset_start_date'
            hours_interval:
              $ref: '#/components/schemas/reward_chain_hours_interval'
            interval_type:
              $ref: '#/components/schemas/interval_type_hourly_rc'
            reset_next_date:
              $ref: '#/components/schemas/reset_next_date'
            time:
              $ref: '#/components/schemas/time'
          title: interval_type = hourly
          type: object
      type: object
    admin_recurrent_schedule_response:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: Период обновления установленный ограничений для пользователя.
          nullable: true
          oneOf:
            - description: Ежедневное обновления пользовательских ограничений.
              properties:
                displayable_reset_next_date:
                  description: >-
                    Дата и время, когда ограничения должны быть сброшены (ISO
                    8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                displayable_reset_start_date:
                  description: Дата и время первого обновления ограничения (ISO 8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - daily
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
                time:
                  description: >-
                    Время обновления ограничений в желаемом часовом поясе
                    (округление до часов).
                  example: 11:00:00+03:00
                  format: full-time
                  type: string
              title: interval_type = daily
              type: object
            - description: Еженедельное обновления пользовательских ограничений.
              properties:
                day_of_week:
                  description: >-
                    День недели, когда обновляются ограничения: 1 — понедельник,
                    7 — воскресенье. Не `null` только для типа периода `weekly`.
                  maximum: 7
                  minimum: 1
                  nullable: true
                  type: integer
                displayable_reset_next_date:
                  description: >-
                    Дата и время, когда ограничения должны быть сброшены (ISO
                    8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                displayable_reset_start_date:
                  description: Дата и время первого обновления ограничения (ISO 8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - weekly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
                time:
                  description: >-
                    Время обновления ограничений в желаемом часовом поясе
                    (округление до часов).
                  example: 11:00:00+03:00
                  format: full-time
                  type: string
              title: interval_type = еженедельно
              type: object
            - description: Ежемесячное обновление пользовательских ограничений.
              properties:
                day_of_month:
                  description: >-
                    День месяца, когда обновляются ограничения. Если в месяце
                    нет указанного дня, поскольку месяц короче, обновление
                    произойдет в последний день месяца. Не `null` только для
                    периода `monthly`.
                  maximum: 31
                  minimum: 1
                  nullable: true
                  type: integer
                displayable_reset_next_date:
                  description: >-
                    Дата и время, когда ограничения должны быть сброшены (ISO
                    8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                displayable_reset_start_date:
                  description: Дата и время первого обновления ограничения (ISO 8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - monthly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
                time:
                  description: >-
                    Время обновления ограничений в желаемом часовом поясе
                    (округление до часов).
                  example: 11:00:00+03:00
                  format: full-time
                  type: string
              title: interval_type = ежемесячно
              type: object
            - description: >-
                Сброс лимитов пользователя, выполняемый через временной
                интервал, заданный в часах.
              properties:
                displayable_reset_next_date:
                  description: >-
                    Дата и время, когда ограничения должны быть сброшены (ISO
                    8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                displayable_reset_start_date:
                  description: Дата и время первого обновления ограничения (ISO 8601).
                  example: '2023-02-28T11:00:00+08:00'
                  format: date-time
                  type: string
                hours_interval:
                  description: >-
                    Интервал в часах, через который обновляется лимит покупок
                    товара. <br><br>Отсчет начинается с момента, когда товар
                    впервые отображается в магазине – задается в параметре <a
                    href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request">date_from</a>.<br><br>Например,
                    если `date_from = "2025-11-15T18:15:00+05:00"` и
                    `hours_interval = 2`, лимит покупок для этого товара будет
                    обновляться каждые 2 часа, начиная с
                    `"2025-11-15T20:15:00+05:00"`.
                  maximum: 10000
                  minimum: 1
                  type: integer
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - hourly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
              title: interval_type = hourly
              type: object
          type: object
      type: object
    admin_value_points-create:
      properties:
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/Common_admin-image_url'
        is_clan:
          $ref: '#/components/schemas/is_clan'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        media_list:
          $ref: '#/components/schemas/media_list'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        sku:
          $ref: '#/components/schemas/sku'
      required:
        - sku
        - name
      type: object
    attribute:
      example:
        external_id: attribute_external_id
        name:
          de: Attributname
          en: Attribute name
        values:
          - external_id: value_1
            name:
              de: wert 1
              en: value 1
          - external_id: value_2
            name:
              de: wert 2
              en: value 2
      properties:
        external_id:
          $ref: '#/components/schemas/admin-attribute-external_id'
        name:
          $ref: '#/components/schemas/admin-attribute-name'
        values:
          example:
            - external_id: strategy
              value:
                de: Strategie
                en: Strategy
            - external_id: action
              value:
                de: Aktion
                en: Action
          items:
            $ref: '#/components/schemas/attribute-value'
          type: array
      required:
        - external_id
        - values
      type: object
    attribute-value:
      example:
        external_id: value_external_id
        name:
          de: Wert 1
          en: Value 1
      properties:
        external_id:
          $ref: '#/components/schemas/value-external_id'
        value:
          $ref: '#/components/schemas/value-name'
      required:
        - value
        - external_id
      type: object
    bundle-item-limit:
      description: Ограничения на продажу товара.
      properties:
        per_item:
          $ref: '#/components/schemas/limit_per_item'
        per_user:
          $ref: '#/components/schemas/limit_per_user'
        recurrent_schedule:
          $ref: '#/components/schemas/bundle_recurrent_schedule'
      type: object
    bundle_recurrent_schedule:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: >-
            Сброс лимитов на покупку товара, выполняемый через временной
            интервал, заданный в часах.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_bundle'
      type: object
    bundle_type:
      description: Тип бандла. Возвращается, если тип элемента является бандлом.
      enum:
        - standard
        - virtual_currency_package
        - partner_side_content
      type: string
    calendar-hard-daily-chain-base:
      description: Базовые свойства ежедневной награды с типом `calendar_hard`.
      properties:
        date_start:
          $ref: '#/components/schemas/calendar_hard_date_start'
        is_recurrent:
          $ref: '#/components/schemas/calendar_hard_is_recurrent'
        type:
          allOf:
            - $ref: '#/components/schemas/daily_chain_type'
            - enum:
                - calendar_hard
      type: object
    calendar_hard_date_start:
      description: Дата, когда начнет действовать ежедневная награда.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      type: string
    calendar_hard_is_recurrent:
      default: false
      description: >-
        Перезапускается ли ежедневная награда. Если передано значение `true`,
        ежедневная награда автоматически сбрасывается в конце периода ее
        действия. Следующие значения для параметров `start_date` и `end_date`
        рассчитываются исходя из количества уровней ежедневной награды и времени
        старта ежедневной награды, заданном в параметре `start_date`.
      example: true
      type: boolean
    chain_is_always_visible:
      default: true
      description: "Отображается ли цепочка наград всем пользователям:\n* Если `true` — цепочка всегда отображается, независимо от авторизации пользователя и его атрибутов.\n* Если `false`\_— цепочка отображается, только если не найдено ни одной персонализированной цепочки. Например, если пользователь не авторизован или его атрибуты не соответствуют ни одной персонализированной цепочке.\n\nПрименяется только в контексте персонализации цепочек и используется, если массив `attribute_conditions` не передан."
      example: true
      type: boolean
    chain_user-attribute_conditions_model-get:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-get'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность цепочки на основе соответствия атрибутов
            пользователя всем указанным условиям.
    chain_user-attribute_conditions_model-post:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-post'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность цепочки на основе соответствия атрибутов
            пользователя всем указанным условиям.
    clan_type:
      description: Тип клана.
      enum:
        - clan
        - guild
        - faction
        - community
        - team
        - squad
        - alliance
        - association
        - coalition
        - union
        - group
        - civilizations
        - dynasty
        - order
        - league
        - brotherhood
        - kingdom
        - organization
        - house
        - empire
        - tribe
        - cartel
        - null
      nullable: true
      type: string
    client-attributes:
      default: []
      description: >-
        Список атрибутов и их значений, соответствующих товару. Может
        использоваться для фильтрации каталога.
      example:
        value:
          external_id: genre
          name: Жанр
          values:
            - external_id: genre_e3364991f92e751689a68b96598a5a5a84010b85
              value: Casual
            - external_id: genre_eba07bfd0f982940773cba3744d97264dd58acd7
              value: Strategy
            - external_id: genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8
              value: Mobile
      items:
        properties:
          external_id:
            $ref: '#/components/schemas/admin-attribute-external_id'
          name:
            description: Название атрибута.
            example: Genre
            type: string
          values:
            items:
              properties:
                external_id:
                  $ref: '#/components/schemas/value-external_id'
                value:
                  description: Значение атрибута.
                  example: Strategy
                  type: string
              type: object
            type: array
        type: object
      type: array
    client-calendar-hard-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/calendar-hard-daily-chain-base'
        - description: Ежедневная награда с типом calendar_hard в клиентских запросах.
          properties:
            date_end:
              $ref: '#/components/schemas/daily_chain_date_end'
            description:
              description: Описание ежедневной награды.
              example: Major weekly quest
              nullable: true
              type: string
            id:
              description: ID ежедневной награды.
              example: 9
              type: integer
            name:
              description: Название ежедневной награды.
              example: Weekly quest
              type: string
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/client-daily-chain-step-model'
              type: array
          type: object
    client-daily-chain-item-model:
      properties:
        bundle_type:
          enum:
            - standard
            - virtual_currency_package
          nullable: true
          type: string
        content:
          items:
            $ref: '#/components/schemas/client-daily-chain-item-model'
          nullable: true
          type: array
        description:
          description: Описание товара.
          nullable: true
          type: string
        image_url:
          $ref: '#/components/schemas/image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          $ref: '#/components/schemas/item_id'
        name:
          description: Название товара.
          type: string
        quantity:
          description: Количество товара.
          example: 1
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
        type:
          $ref: '#/components/schemas/item_type'
      type: object
    client-daily-chain-model:
      discriminator:
        mapping:
          calendar_hard: '#/components/schemas/client-calendar-hard-daily-chain-model'
          rolling_skippable: '#/components/schemas/client-rolling-skippable-daily-chain-model'
          rolling_unskippable: '#/components/schemas/client-rolling-unskippable-daily-chain-model'
        propertyName: type
      oneOf:
        - $ref: '#/components/schemas/client-calendar-hard-daily-chain-model'
        - $ref: '#/components/schemas/client-rolling-skippable-daily-chain-model'
        - $ref: '#/components/schemas/client-rolling-unskippable-daily-chain-model'
    client-daily-chain-step-model:
      description: Уровень ежедневной награды.
      properties:
        items:
          items:
            $ref: '#/components/schemas/client-daily-chain-item-model'
          type: array
        status:
          description: >-
            Определяет награду на уровне для текущего пользователя в цепочке
            наград.
          enum:
            - claimed
            - claimable
            - blocked
            - claim_in_future
          example: claimed
          type: string
          x-enumDescriptions:
            blocked: |-
              Награда за уровень не может быть получена:
                - Для неавторизованных пользователей: все уровни заблокированы.
                - Для типа calendar_hard: уровень не был получен и теперь недоступен.
                - Для rolling_skippable: уровень заблокирован до тех пор, пока не будет получена награда за предыдущий уровень.
            claim_in_future: >-
              Награда за уровень не получена, день получения награды еще не
              настал.
            claimable: Можно получить награду за уровень.
            claimed: Награда за уровень уже получена.
        step_number:
          $ref: '#/components/schemas/daily_chain_step_number'
        unlocked_date:
          description: Метка времени Unix (в секундах), когда уровень будет разблокирован.
          format: int64
          type: integer
      type: object
    client-item-limit-response:
      description: Ограничения на продажу товара.
      nullable: true
      properties:
        per_item:
          description: Глобальное ограничение товара.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое могут приобрести все
                пользователи.
              type: integer
            total:
              description: >-
                Максимальное количество товара, которое могут приобрести все
                пользователи.
              type: integer
          type: object
        per_user:
          description: Ограничение количества товара для отдельного пользователя.
          nullable: true
          properties:
            available:
              description: >-
                Оставшееся количество товара, которое может приобрести текущий
                пользователь.
              type: integer
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            recurrent_schedule:
              description: >-
                Период обновления ограничений на продажу товара для
                пользователя.
              nullable: true
              properties:
                interval_type:
                  description: Период обновления ограничения на продажу товара.
                  enum:
                    - daily
                    - weekly
                    - monthly
                    - hourly
                  type: string
                reset_next_date:
                  description: Дата и время обновления ограничений (Unix Timestamp).
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: >-
                Максимальное количество товара, которое может приобрести один
                пользователь.
              type: integer
          type: object
      type: object
    client-item-value-point-reward:
      description: Стоимость призовых баллов товара.
      items:
        properties:
          amount:
            $ref: '#/components/schemas/value-point-amount'
          image_url:
            $ref: '#/components/schemas/Common_admin-image_url'
          is_clan:
            $ref: '#/components/schemas/is_clan'
          item_id:
            $ref: '#/components/schemas/item_id'
          name:
            $ref: '#/components/schemas/value-point-name'
          sku:
            $ref: '#/components/schemas/value-point-sku'
        type: object
      type: array
    client-offer-chain-item-model:
      properties:
        bundle_type:
          enum:
            - standard
            - virtual_currency_package
          nullable: true
          type: string
        content:
          items:
            $ref: '#/components/schemas/client-offer-chain-item-model'
          nullable: true
          type: array
        description:
          description: Описание товара.
          nullable: true
          type: string
        image_url:
          $ref: '#/components/schemas/image_url'
        is_free:
          $ref: '#/components/schemas/value-is_free'
        item_id:
          $ref: '#/components/schemas/item_id'
        name:
          description: Название товара.
          type: string
        order:
          $ref: '#/components/schemas/order'
        quantity:
          description: Количество товара.
          example: 1
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
        type:
          $ref: '#/components/schemas/item_type'
      type: object
    client-offer-chain-model:
      description: Цепочка предложений.
      properties:
        date_end:
          $ref: '#/components/schemas/offer_chain_date_end'
        date_start:
          $ref: '#/components/schemas/offer_chain_date_start'
        description:
          description: Описание цепочки предложений.
          example: Major weekly quest
          nullable: true
          type: string
        id:
          description: ID цепочки предложений.
          example: 9
          type: integer
        name:
          description: Название цепочки предложений.
          example: Weekly quest
          type: string
        next_step_number:
          description: >-
            Номер следующего уровня цепочки предложений. `null`, если цепочка
            завершена.
          example: 1
          nullable: true
          type: integer
        order:
          $ref: '#/components/schemas/order'
        recurrent_schedule:
          $ref: '#/components/schemas/offer_chain_recurrent_schedule_client_side'
        steps:
          items:
            $ref: '#/components/schemas/client-offer-chain-step-model'
          type: array
      type: object
    client-offer-chain-step-model:
      description: Уровень цепочки предложений.
      properties:
        is_claimed:
          description: >-
            Указывает, является ли уровень цепочки предложений платным или
            бесплатным.
          example: false
          type: boolean
        is_free:
          $ref: '#/components/schemas/offer_chain_is_free'
        items:
          items:
            $ref: '#/components/schemas/client-offer-chain-item-model'
          type: array
        step_loyalty_rewards:
          items:
            properties:
              amount:
                description: Количество призовых баллов.
                example: 1
                type: integer
              description:
                description: Описание призовых баллов.
                example: First Loyalty Point Desc
                type: string
              image_url:
                $ref: '#/components/schemas/image_url'
              name:
                description: Название призовых баллов.
                example: First Loyalty Point
                type: string
              sku:
                description: ID призовых баллов.
                example: 0c745ef0-4243-46e1-aa90-54dee07da622
                type: string
            type: object
          nullable: true
          type: array
        step_number:
          $ref: '#/components/schemas/offer_chain_step_number'
        step_price:
          $ref: '#/components/schemas/offer_chain_step_price'
        step_vp_rewards:
          description: >-
            Набор призовых баллов из цепочки наград, начисляемых в качестве
            вознаграждения.
          items:
            properties:
              amount:
                $ref: '#/components/schemas/value-point-amount'
              image_url:
                $ref: '#/components/schemas/Common_admin-image_url'
              is_clan:
                $ref: '#/components/schemas/is_clan'
              item_id:
                $ref: '#/components/schemas/item_id'
              name:
                $ref: '#/components/schemas/value-point-name'
              sku:
                $ref: '#/components/schemas/value-point-sku'
            type: object
          nullable: true
          type: array
      type: object
    client-reward-chain-item-model:
      properties:
        clan_type:
          $ref: '#/components/schemas/clan_type'
        date_end:
          $ref: '#/components/schemas/date_end'
        date_start:
          $ref: '#/components/schemas/date_start'
        description:
          description: Описание цепочки наград.
          example: Major weekly quest
          nullable: true
          type: string
        image_url:
          $ref: '#/components/schemas/image_url'
        long_description:
          description: Развернутое описание цепочки наград.
          example: >-
            You can get a lot of additional items just by shopping during the
            week
          nullable: true
          type: string
        name:
          description: Название цепочки наград.
          example: Weekly quest
          type: string
        order:
          $ref: '#/components/schemas/order'
        popup_header:
          $ref: '#/components/schemas/popup_header-two-letter-locale'
        popup_image_url:
          $ref: '#/components/schemas/popup_image_url'
        popup_instruction:
          $ref: '#/components/schemas/popup_instruction-two-letter-locale'
        recurrent_schedule:
          $ref: '#/components/schemas/recurrent_schedule_client_side'
        reward_chain_id:
          description: ID цепочки наград.
          example: 9
          type: integer
        steps:
          items:
            description: Уровень цепочки наград.
            properties:
              image_url:
                $ref: '#/components/schemas/Common_admin-image_url'
              is_claimed:
                description: Получена ли награда за уровень.
                example: false
                type: boolean
              name:
                description: Название уровня.
                example: Level 1
                type: string
              price:
                properties:
                  amount:
                    description: >-
                      Количество призовых баллов, которое пользователь получит
                      за прохождение уровня.
                    example: 100
                    type: integer
                type: object
              reward:
                items:
                  properties:
                    description:
                      description: Описание товара.
                      example: Super box with items
                      type: string
                    image_url:
                      $ref: '#/components/schemas/Common_admin-image_url'
                    name:
                      description: Название товара.
                      example: Super box
                      type: string
                    quantity:
                      description: Количество товаров.
                      example: 2
                      type: integer
                    sku:
                      $ref: '#/components/schemas/sku'
                    type:
                      description: Тип товара.
                      example: bundle
                      type: string
                  type: object
                type: array
              step_id:
                description: ID уровня.
                example: 10
                type: integer
            type: object
          type: array
        top_contributors:
          items:
            $ref: '#/components/schemas/top_contributors'
          type: array
        value_point:
          properties:
            amount:
              $ref: '#/components/schemas/value-point-amount'
            description:
              $ref: '#/components/schemas/value-point-description'
            image_url:
              $ref: '#/components/schemas/Common_admin-image_url'
            is_clan:
              $ref: '#/components/schemas/is_clan'
            long_description:
              $ref: '#/components/schemas/value-point-long-description'
            name:
              $ref: '#/components/schemas/value-point-name'
            sku:
              $ref: '#/components/schemas/value-point-sku'
          type: object
      type: object
    client-rolling-skippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-skippable-daily-chain-base'
        - description: Ежедневная награда с типом rolling_skippable в клиентских запросах.
          properties:
            description:
              description: Описание ежедневной награды.
              example: Major weekly quest
              nullable: true
              type: string
            id:
              description: ID ежедневной награды.
              example: 9
              type: integer
            name:
              description: Название ежедневной награды.
              example: Weekly quest
              type: string
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/client-daily-chain-step-model'
              type: array
          type: object
    client-rolling-unskippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-unskippable-daily-chain-base'
        - description: >-
            Ежедневная награда с типом `rolling_unskippable` в клиентских
            запросах.
          properties:
            description:
              description: Описание ежедневной награды.
              example: Major weekly quest
              nullable: true
              type: string
            id:
              description: ID ежедневной награды.
              example: 9
              type: integer
            name:
              description: Название ежедневной награды.
              example: Weekly quest
              type: string
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/client-daily-chain-step-model'
              type: array
          type: object
    create-calendar-hard-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/calendar-hard-daily-chain-base'
        - description: Ежедневная награда с типом `calendar_hard`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/create-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    create-clan-reward-chain-model:
      allOf:
        - $ref: '#/components/schemas/create-reward-chain-model'
        - description: Цепочка наград для клана.
          properties:
            clan_type:
              $ref: '#/components/schemas/clan_type'
            popup_header:
              $ref: '#/components/schemas/popup_header-two-letter-locale'
            popup_image_url:
              $ref: '#/components/schemas/popup_image_url'
            popup_instruction:
              $ref: '#/components/schemas/popup_instruction-two-letter-locale'
            value_point:
              description: Призовой балл для цепочки наград для клана.
              properties:
                sku:
                  $ref: '#/components/schemas/sku'
              required:
                - sku
              type: object
          required:
            - name
            - value_point
            - periods
            - steps
            - is_enabled
            - popup_header
            - popup_instruction
          type: object
    create-daily-chain-step-model:
      properties:
        items:
          items:
            $ref: '#/components/schemas/modify-daily-chain-item-model'
          minItems: 1
          type: array
        step_number:
          $ref: '#/components/schemas/daily_chain_step_number'
      required:
        - step_number
        - items
      type: object
    create-offer-chain-model:
      description: Цепочка предложений.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-post'
        date_end:
          $ref: '#/components/schemas/offer_chain_date_end'
        date_start:
          $ref: '#/components/schemas/offer_chain_date_start'
        description:
          $ref: '#/components/schemas/description-localization-object'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        recurrent_schedule:
          $ref: '#/components/schemas/offer_chain_recurrent_schedule_create_update'
        steps:
          items:
            $ref: '#/components/schemas/create-offer-chain-step-model'
          type: array
      required:
        - name
        - date_start
        - steps
        - is_enabled
      type: object
    create-offer-chain-step-model:
      properties:
        is_free:
          $ref: '#/components/schemas/offer_chain_is_free'
        items:
          items:
            $ref: '#/components/schemas/modify-offer-chain-item-model'
          minItems: 1
          type: array
        step_number:
          $ref: '#/components/schemas/offer_chain_step_number'
      required:
        - step_number
        - is_free
        - items
      type: object
    create-reward-chain-model:
      description: Цепочка наград.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-post'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        is_reset_after_end:
          $ref: '#/components/schemas/is_reset_after_end'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        periods:
          $ref: '#/components/schemas/periods'
        recurrent_schedule:
          $ref: '#/components/schemas/recurrent_schedule_create_update'
        steps:
          items:
            $ref: '#/components/schemas/create_reward_step'
          type: array
        value_point:
          properties:
            sku:
              $ref: '#/components/schemas/sku'
          required:
            - sku
          type: object
      required:
        - name
        - value_point
        - periods
        - steps
        - is_enabled
      type: object
    create-rolling-skippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-skippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_skippable`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/create-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    create-rolling-unskippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-unskippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_unskippable`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/create-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    create_reward_step:
      description: Уровень цепочки наград.
      properties:
        image_url:
          $ref: '#/components/schemas/image_url'
        name:
          $ref: '#/components/schemas/name-localization-object'
        price:
          $ref: '#/components/schemas/reward_step_price'
        reward:
          items:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/reward-chain-step-reward_user-attribute_conditions_model-post
              quantity:
                $ref: '#/components/schemas/reward_item_quantity'
              sku:
                $ref: '#/components/schemas/sku'
            required:
              - sku
              - quantity
            type: object
          type: array
      required:
        - name
        - price
        - reward
      type: object
    daily-chain-error-model:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        errorMessageExtended:
          nullable: true
          type: object
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    daily_chain_date_end:
      description: "Дата окончания срока действия ежедневных наград. Может быть\_null. При установке типа `calendar_hard` эта дата будет автоматически рассчитана по количеству добавленных уровней, поэтому можно оставить значение null."
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      nullable: true
      type: string
    daily_chain_id:
      description: Уникальный ID ежеденевной награды.
      example: 9
      type: integer
    daily_chain_number_of_step:
      description: >-
        Количество уровней, заданных в ежедневной награде. Каждый уровень
        означает один день в ежедневной награде.
      example: 3
      type: integer
    daily_chain_step_id:
      description: Уникальный идентификатор уровня ежедневной награды
      example: 10
      minimum: 1
      nullable: true
      type: integer
    daily_chain_step_number:
      description: Номер уровня.
      example: 2
      minimum: 1
      nullable: false
      type: integer
    daily_chain_type:
      description: >-
        Тип ежедневной награды, который определяет, когда пользователи могут
        получать награды.
      enum:
        - calendar_hard
        - rolling_skippable
        - rolling_unskippable
      type: string
      x-enumDescriptions:
        calendar_hard: >-
          Разблокирует следующий уровень наград каждые 24 часа. Неполученные
          награды становятся недоступны, как только открывается награда за
          следующий уровень.
        rolling_skippable: >-
          Разблокирует награду за следующий уровень каждые 24 часа, отсчет
          начинается со значения, указанного в параметре date_start. Прогресс
          последовательный: новая награда не откроется, пока не будет получена
          предыдущая. Если пользователь пропустил один или несколько дней, Если
          пользователь пропускает один или несколько дней, он продолжает с того
          уровня, где остановился; за пропущенные дни награды не полагаются.
        rolling_unskippable: >-
          Разблокирует награду за следующий уровень каждые 24 часа, отсчет
          начинается со значения, указанного в параметре date_start. Прогресс
          последовательный: новая награда не откроется, пока не будет получена
          предыдущая. Если пользователь пропустил день, его прогресс
          сбрасывается и он начинает заново с первого уровня.
    daily_chain_update_step_id:
      description: >-
        Уникальный ID уровня цепочки наград. Укажите его при обновлении, чтобы
        сохранить прогресс пользователя для этого уровня.
      example: 10
      minimum: 1
      nullable: true
      type: integer
    daily_rolling_chain_date_start:
      description: >-
        Дата и время, когда начнет действовать ежедневная награда. Это время
        также определяет момент ежедневного сброса, когда пользователи могут
        получить свою награду.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      type: string
    date_end:
      description: >-
        Дата, когда закончится действие акции с цепочкой наград. Может быть
        `null`. Если `date_end` равна `null`, то цепочка наград не будет
        ограничена по времени.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      nullable: true
      type: string
    date_start:
      description: Дата, когда начнет действовать ваша цепочка наград.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      type: string
    day_of_month:
      description: >-
        День месяца, когда происходит сброс цепочки наград. Если количество дней
        в месяце меньше, чем порядковый номер указанного дня, сброс цепочки
        наград происходит в последний день месяца.
      maximum: 31
      minimum: 1
      type: integer
    day_of_week:
      description: >-
        День недели, когда осуществляется сброс цепочки наград, где `1` —
        понедельник и `7` — воскресенье.
      maximum: 7
      minimum: 1
      type: integer
    description-localization-object:
      description: >-
        Объект с локализованными описаниями товара. Принимает значения в одном
        из двух форматов: двухбуквенный код языка в нижнем регистре (например,
        `en`) или код локали из пяти символов (например, `en-US`). Оба формата
        допустимы при отправке запроса, но в ответе всегда используется код из
        двух символов. Если для одного языка указаны оба варианта (например,
        `en` и `en-US`), будет сохранено последнее переданное значение. Полный
        список поддерживаемых языков приведен в
        [документации](/ru/doc/shop-builder/references/supported-languages/).
      nullable: true
      oneOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
      type: object
    displayable_reset_next_date:
      description: >-
        Расчетные дата и время, когда цепочка наград будет сброшена в следующий
        раз (<a href="https://en.wikipedia.org/wiki/ISO_8601"
        target="_blank">ISO 8601</a>). <br><br>Например, сброс цепочки наград
        осуществляется ежемесячно, начиная с 1 марта 2024 в 01:00 по часовому
        поясу Куала-Лумпура (GMT+8). Дата и время следующего сброса цепочки
        наград: 1 апреля 2024 в 01:00 по часовому поясу Куала-Лумпура (GMT+8),
        что соответствует значению `2024-04-01T01:00:00+08:00` в формате <a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        </a>8601. <br><br>Example: `2024-04-01T01:00:00+08:00`
      format: date-time
      type: string
    displayable_reset_start_date:
      description: >-
        Дата и время первого сброса цепочки наград.<br><br>Например, дата и
        время первого сброса цепочки наград — 1 марта 2024 в 01:00 по часовому
        поясу Куала-Лумпура (GMT+8) или `2024-03-01T01:00:00+08:00` в формате <a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        </a>8601.<br><br>Example: `2024-03-01T01:00:00+08:00`
      format: date-time
      type: string
    drm_name:
      description: Название игры на платформе.
      example: Steam
      type: string
    drm_sku:
      description: Уникальный ID платформы.
      example: steam
      type: string
    excluded_promotions:
      description: >-
        Список акций, которые исключаются при применении этой акции.
        <br>Example: `[12, 789]`
      example:
        - 12
        - 789
      items:
        type: integer
      type: array
    five-letter-locale:
      description: Пятисимвольные коды локали.
      nullable: true
      properties:
        ar-AE:
          description: Арабский
          nullable: true
          type: string
        bg-BG:
          description: Болгарский
          nullable: true
          type: string
        cs-CZ:
          description: Чешский
          nullable: true
          type: string
        de-DE:
          description: Немецкий
          nullable: true
          type: string
        en-US:
          description: Английский
          nullable: true
          type: string
        es-ES:
          description: Spanish (Spain)
          nullable: true
          type: string
        fr-FR:
          description: Французский
          nullable: true
          type: string
        he-IL:
          description: Иврит
          nullable: true
          type: string
        id-ID:
          description: Индонезийский
          nullable: true
          type: string
        it-IT:
          description: Итальянский
          nullable: true
          type: string
        ja-JP:
          description: Японский
          nullable: true
          type: string
        km-KH:
          description: Кхмерский
          nullable: true
          type: string
        ko-KR:
          description: Корейский
          nullable: true
          type: string
        lo-LA:
          description: Лаосский
          nullable: true
          type: string
        my-MM:
          description: Бирманский
          nullable: true
          type: string
        ne-NP:
          description: Непальский
          nullable: true
          type: string
        ph-PH:
          description: Филиппинский
          nullable: true
          type: string
        pl-PL:
          description: Польский
          nullable: true
          type: string
        pt-BR:
          description: Portuguese (Brazil)
          nullable: true
          type: string
        ro-RO:
          description: Румынский
          nullable: true
          type: string
        ru-RU:
          description: Русский
          nullable: true
          type: string
        th-TH:
          description: Тайский
          nullable: true
          type: string
        tr-TR:
          description: Турецкий
          nullable: true
          type: string
        vi-VN:
          description: Вьетнамский
          nullable: true
          type: string
        zh-CN:
          description: Китайский упрощенный
          nullable: true
          type: string
        zh-TW:
          description: Китайский традиционный
          nullable: true
          type: string
      title: five-letter
      type: object
    game_key_recurrent_schedule:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
      type: object
    hours_interval:
      maximum: 10000
      minimum: 1
      type: integer
    image_url:
      description: URL-адрес изображения.
      example: https://image.example.com
      nullable: true
      type: string
    inactive_promotions_count:
      description: Количество отключенных акций.
      type: integer
    interval_type_hourly:
      description: Период обновления ограничений.
      enum:
        - hourly
      type: string
    interval_type_hourly_rc:
      description: Частота регулярного сброса цепочки наград.
      enum:
        - hourly
      type: string
    interval_type_monthly:
      description: Частота регулярного сброса цепочки наград.
      enum:
        - monthly
      type: string
    interval_type_weekly:
      description: Частота регулярного сброса цепочки наград.
      enum:
        - weekly
      type: string
    is_clan:
      description: Может ли призовой балл использоваться в цепочках наград для клана.
      example: true
      type: boolean
    is_enabled:
      example: true
      type: boolean
    is_reset_after_end:
      default: false
      description: >-
        Нужно ли сбрасывать цепочку наград (призовые баллы и прогресс всех
        пользователей) после даты ее окончания:

        * Если `true`, цепочка наград будет сброшена после даты окончания.

        * Если `false`, цепочка наград не будет сброшена после даты окончания.


        <br>

        <div class="notice"><strong>Внимание</strong><br><br>

        Не может быть <code>true</code>, если:<br>

        <ul>

        <li>В <code>recurrent_schedule</code> задан период регулярного
        обновления.</li>

        <li>В <code>periods.date_until</code> передано <code>null</code>.</li>

        </ul>

        </div>
      example: false
      type: boolean
    item-custom-attributes:
      description: >-
        JSON-объект, содержащий атрибуты товара и их значения. Атрибуты
        позволяют добавить дополнительную информацию к товарам. Например,
        указать уровень игрока, на котором ему станет доступен этот товар.
        Атрибуты дополняют внутреннюю логику игры и могут быть получены через
        GET-методы и вебхуки.
      format: json
      maxLength: 500
      type: object
    item-custom-attributes-response:
      description: JSON-объект, содержащий атрибуты товара и их значения.
      format: json
      type: object
    item-periods:
      description: Период продажи товара.
      items:
        properties:
          date_from:
            description: Дата, когда указанный товар будет доступен для продажи.
            example: '2020-08-11T10:00:00+03:00'
            format: date-time
            type: string
          date_until:
            description: >-
              Дата, когда указанный товар станет недоступен для продажи. Может
              быть `null`.
            example: '2020-08-11T20:00:00+03:00'
            format: date-time
            nullable: true
            type: string
        type: object
      nullable: true
      type: array
    item-periods-response:
      description: Период продажи товара.
      items:
        properties:
          date_from:
            description: Дата, когда указанный товар будет доступен для продажи.
            example: '2020-08-11T10:00:00+03:00'
            format: date-time
            nullable: true
            type: string
          date_until:
            description: >-
              Дата, когда указанный товар станет недоступен для продажи. Может
              быть `null`.
            example: '2020-08-11T20:00:00+03:00'
            format: date-time
            nullable: true
            type: string
        type: object
      type: array
    item-value-point-reward-set:
      items:
        properties:
          amount:
            description: Количество призовых баллов.
            type: integer
          sku:
            $ref: '#/components/schemas/sku'
        required:
          - sku
          - amount
        type: object
      type: array
    item-value-point-reward-set-for-patch:
      items:
        maxItems: 100
        properties:
          amount:
            description: Количество призовых баллов.
            minimum: 0
            type: integer
          sku:
            $ref: '#/components/schemas/sku'
        required:
          - sku
          - amount
        type: object
      type: array
    item_id:
      description: Внутренний уникальный ID виртуального предмета или валюты.
      example: 1
      type: integer
    item_price_conditions_promocode:
      description: "Массив объектов с условиями, задающими ценовой диапазон применения акции для отдельных товаров в корзине.<br>\nСтоимость каждого товара в корзине пользователя сравнивается с заданным в условии ценовым диапазоном. [Бонусы](/ru/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request) и [скидки](/ru/api/shop-builder/operation/create-promo-code/#!path=discount&t=request) применяются только к тем товарам в корзине, цена которых удовлетворяет условию.<br>\nЕсли вы передаете этот массив, в массиве [discounted_items](/ru/api/shop-builder/operation/create-promo-code/#!path=discounted_items&t=request)\_передайте значение `null`."
      items:
        $ref: '#/components/schemas/price_conditions_items'
      nullable: true
      type: array
    item_type:
      description: 'Тип товара: `virtual_good`/`virtual_currency`/`bundle`/`unit`.'
      type: string
    items_client_groups_response:
      default: []
      description: Группы, к которым принадлежит товар.
      example:
        - external_id: exclusive
          name: Exclusive
      items:
        properties:
          external_id:
            description: >-
              Уникальный ID группы. Используется для ссылок в запросах API или
              внешних системах.
            example: exclusive
            type: string
          item_order_in_group:
            description: >-
              Позиция предмета внутри группы, определяющая порядок отображения.

              Поле включается в ответ только при указании параметра в запросе
              <code>additional_fields[]</code>.
            example: 1
            type: integer
          name:
            description: Название группы.
            example: Exclusive
            type: string
        type: object
      type: array
    limit_exceeded_visibility:
      default: show
      description: >-
        Определяет видимость товара в каталоге после достижения лимита покупок
        до момента следующего обновления лимитов.


        Применяется к товарам, для которых задано регулярное обновление лимитов
        в массиве `recurrent_schedule`.


        Если обновление лимитов не задано, товар не отображается в каталоге
        после достижения лимита независимо от значения
        `limit_exceeded_visibility`.
      enum:
        - show
        - hide
      example: show
      type: string
      x-enumDescriptions:
        hide: >-
          Товар не возвращается в методах получения каталога товаров после
          достижения лимита покупок до момента сброса лимитов.
        show: >-
          Товар возвращается в методах получения каталога товаров после
          достижения лимита покупок.

          В клиентских методах получения каталога после достижения лимита товар
          возвращается с флагом `can_be_bought: false`.

          Дата следующего сброса возвращается в `reset_next_date`.
    limit_per_item:
      description: Глобальное ограничение товара.
      example: 10
      nullable: true
      type: integer
    limit_per_user:
      anyOf:
        - type: 'null'
        - description: >-
            Максимальное количество товара, которое может приобрести один
            пользователь.
          example: 5
          type: integer
        - description: Detailed purchase limit configuration.
          properties:
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            total:
              description: >-
                Максимальное количество товара, которое может приобрести один
                пользователь.
              example: 5
              type: integer
          type: object
      description: Ограничение количества товара для отдельного пользователя.
    long-description-localization-object:
      anyOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
      description: >-
        Объект с локализованными длинными описаниями товара. Принимает значения
        в одном из двух форматов: двухбуквенный код языка в нижнем регистре
        (например, `en`) или код локали из пяти символов (например, `en-US`).
        Оба формата допустимы при отправке запроса, но в ответе всегда
        используется код из двух символов. Если для одного языка указаны оба
        варианта (например, `en` и `en-US`), будет сохранено последнее
        переданное значение. Полный список поддерживаемых языков приведен в
        [документации](/ru/doc/shop-builder/references/supported-languages/).
      nullable: true
      type: object
    media_list:
      description: >-
        Дополнительные ассеты предмета, такие как скриншоты, видео игрового
        процесса и так далее.
      example:
        - type: image
          url: >-
            https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
      items:
        properties:
          type:
            description: 'Тип медиа: `image`/`video`.'
            enum:
              - image
              - video
            example: image
            type: string
          url:
            description: Ссылка на файл.
            example: >-
              https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg
            type: string
        type: object
      type: array
    modify-daily-chain-item-model:
      properties:
        quantity:
          description: Количество уровней ежедневной награды для этого артикула
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
      required:
        - sku
        - quantity
      type: object
    modify-daily-chain-step-model:
      properties:
        items:
          items:
            $ref: '#/components/schemas/modify-daily-chain-item-model'
          minItems: 1
          type: array
        step_id:
          $ref: '#/components/schemas/daily_chain_update_step_id'
        step_number:
          $ref: '#/components/schemas/daily_chain_step_number'
      required:
        - step_number
        - items
      type: object
    modify-offer-chain-item-model:
      properties:
        order:
          description: Заказ на вознаграждение за уровень цепочки предложений.
          minimum: 0
          nullable: true
          type: integer
        quantity:
          description: Количество товаров в вознаграждении для этого уровня цепочки.
          minimum: 1
          type: integer
        sku:
          $ref: '#/components/schemas/sku'
      required:
        - sku
        - quantity
      type: object
    modify-offer-chain-model:
      description: Цепочка предложений.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-post'
        date_end:
          $ref: '#/components/schemas/offer_chain_date_end'
        date_start:
          $ref: '#/components/schemas/offer_chain_date_start'
        description:
          $ref: '#/components/schemas/description-localization-object'
        id:
          $ref: '#/components/schemas/offer_chain_id'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        recurrent_schedule:
          $ref: '#/components/schemas/offer_chain_recurrent_schedule_create_update'
        steps:
          items:
            $ref: '#/components/schemas/modify-offer-chain-step-model'
          type: array
      required:
        - name
        - date_start
        - steps
        - is_enabled
      type: object
    modify-offer-chain-step-model:
      properties:
        is_free:
          $ref: '#/components/schemas/offer_chain_is_free'
        items:
          items:
            $ref: '#/components/schemas/modify-offer-chain-item-model'
          minItems: 1
          type: array
        step_id:
          $ref: '#/components/schemas/update_step_id'
        step_number:
          $ref: '#/components/schemas/offer_chain_step_number'
      required:
        - step_number
        - is_free
        - items
      type: object
    modify_reward_step:
      description: Уровень цепочки наград.
      properties:
        image_url:
          $ref: '#/components/schemas/image_url'
        name:
          $ref: '#/components/schemas/name-localization-object'
        price:
          $ref: '#/components/schemas/reward_step_price'
        reward:
          items:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/reward-chain-step-reward_user-attribute_conditions_model-post
              quantity:
                $ref: '#/components/schemas/reward_item_quantity'
              sku:
                $ref: '#/components/schemas/sku'
            required:
              - sku
              - quantity
            type: object
          type: array
        step_id:
          $ref: '#/components/schemas/step_id'
      required:
        - name
        - price
        - reward
        - step_id
      type: object
    name-localization-object:
      description: >-
        Объект с локализованными названиями товара. Принимает значения в одном
        из двух форматов: двухбуквенный код языка в нижнем регистре (например,
        `en`) или код языка из пяти символов (например, `en-US`). Оба формата
        допустимы при отправке запроса, но в ответе всегда используется
        двухбуквенный код языка. Если для одного языка указаны оба варианта
        (например, `en` и `en-US`), будет сохранено последнее переданное
        значение. Полный список поддерживаемых языков приведен в
        [документации](/ru/doc/shop-builder/references/supported-languages/).
      nullable: true
      oneOf:
        - $ref: '#/components/schemas/two-letter-locale'
        - $ref: '#/components/schemas/five-letter-locale'
      type: object
    offer-chain-error-model:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        errorMessageExtended:
          nullable: true
          type: object
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    offer_chain_date_end:
      description: >-
        Дата окончания срока действия цепочки предложений. Может быть `null`.
        Если `date_end` равен `null`, цепочка предложений будет бессрочной.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      nullable: true
      type: string
    offer_chain_date_start:
      description: Дата начала действия цепочки предложений.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      type: string
    offer_chain_day_of_month:
      description: >-
        День месяца, когда сбрасывается цепочка. Если в месяце меньше дней, чем
        указано — сброс произойдет в последний день месяца.
      maximum: 31
      minimum: 1
      type: integer
    offer_chain_day_of_week:
      description: >-
        День недели, когда происходит сброс, где `1` — понедельник, `7` —
        воскресенье.
      maximum: 7
      minimum: 1
      type: integer
    offer_chain_displayable_reset_next_date:
      description: >-
        Рассчитанная дата и время следующего сброса цепочки в формате <a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>.<br> Например, если цепочка предложений сбрасывается ежемесячно
        начиная с 1 марта 2024 года в 01:00 по времени в Куала-Лумпуре,
        следующий сброс произойдет 1 апреля 2024 года в 01:00 по времени в
        Куала-Лумпуре, что соответствует `2024-04-01T01:00:00+08:00` в формате
        <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>.<br><br>Example: `2024-04-01T01:00:00+08:00`
      format: date-time
      type: string
    offer_chain_displayable_reset_start_date:
      description: >-
        Дата и время первого сброса цепочки предложений.<br><br>Например, первый
        сброс происходит 1 марта 2024 года в 01:00 по времени в Куала-Лумпуре,
        это соответствует `2024-03-01T01:00:00+08:00` в формате <a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>.<br><br>Example: `2024-03-01T01:00:00+08:00`
      format: date-time
      type: string
    offer_chain_hours_interval:
      description: >-
        Интервал в часах, через который выполняется сброс цепочки
        предложений.<br><br>Отсчет начинается от значения <a
        href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-reward-chain/#!path=0/date_start&t=request">date_start</a>.
        Например, если `date_start = "2025-11-15T18:15:00+05:00"` и
        `hours_interval = 2`, цепочка предложений будет сбрасываться каждые 2
        часа, начиная с `"2025-11-15T20:15:00+05:00"`.
      maximum: 10000
      minimum: 1
      type: integer
    offer_chain_id:
      description: Уникальный ID цепочки предложений.
      example: 9
      type: integer
    offer_chain_interval_type_hourly:
      description: Частота сброса цепочки предложений.
      enum:
        - hourly
      type: string
    offer_chain_interval_type_monthly:
      description: Частота сброса цепочки предложений.
      enum:
        - monthly
      type: string
    offer_chain_interval_type_weekly:
      description: Частота сброса цепочки предложений.
      enum:
        - weekly
      type: string
    offer_chain_is_free:
      description: >-
        Указывает, является ли уровень цепочки предложений
        бесплатным:<ul><li>Если <code>true</code> — награду необходимо
        запросить, используя метод <a
        href="/api/shop-builder/operation/claim-user-offer-chain-step-reward">Получение
        награды за уровень цепочки предложений</a>.</li><li>Если
        <code>false</code> — награду необходимо приобрести, используя метод <a
        href="/api/shop-builder/operation/order-user-offer-chain-step-reward">Создание
        заказа на награду за уровень цепочки предложений</a>.</li></ul>
      type: boolean
    offer_chain_recurrent_schedule:
      description: Интервал повторяющегося сброса цепочки предложений.
      nullable: true
      oneOf:
        - description: Еженедельный сброс цепочки предложений.
          nullable: true
          properties:
            day_of_week:
              $ref: '#/components/schemas/offer_chain_day_of_week'
            displayable_reset_next_date:
              $ref: '#/components/schemas/offer_chain_displayable_reset_next_date'
            displayable_reset_start_date:
              $ref: '#/components/schemas/offer_chain_displayable_reset_start_date'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_weekly'
            reset_next_date:
              $ref: '#/components/schemas/offer_chain_reset_next_date'
            time:
              $ref: '#/components/schemas/offer_chain_time'
          title: interval_type = еженедельно
          type: object
        - description: Ежемесячный сброс цепочки.
          properties:
            day_of_month:
              $ref: '#/components/schemas/offer_chain_day_of_month'
            displayable_reset_next_date:
              $ref: '#/components/schemas/offer_chain_displayable_reset_next_date'
            displayable_reset_start_date:
              $ref: '#/components/schemas/offer_chain_displayable_reset_start_date'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_monthly'
            reset_next_date:
              $ref: '#/components/schemas/offer_chain_reset_next_date'
            time:
              $ref: '#/components/schemas/offer_chain_time'
          title: interval_type = ежемесячно
          type: object
        - description: >-
            Сброс цепочки предложений, выполняемый через временной интервал,
            заданный в часах.
          properties:
            hours_interval:
              $ref: '#/components/schemas/offer_chain_hours_interval'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_hourly'
          title: interval_type = hourly
          type: object
      type: object
    offer_chain_recurrent_schedule_client_side:
      description: Интервал сброса цепочки предложений.
      nullable: true
      properties:
        interval_type:
          description: Частота сброса цепочки предложений.
          enum:
            - weekly
            - monthly
            - hourly
          type: string
        reset_next_date:
          $ref: '#/components/schemas/offer_chain_reset_next_date'
      type: object
    offer_chain_recurrent_schedule_create_update:
      description: Интервал сброса цепочки предложений.
      nullable: true
      oneOf:
        - description: Еженедельный сброс цепочки предложений.
          nullable: true
          properties:
            day_of_week:
              $ref: '#/components/schemas/offer_chain_day_of_week'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_weekly'
            time:
              $ref: '#/components/schemas/offer_chain_time'
          required:
            - interval_type
            - time
            - day_of_week
          title: interval_type = еженедельно
          type: object
        - description: Ежемесячный сброс цепочки.
          properties:
            day_of_month:
              $ref: '#/components/schemas/offer_chain_day_of_month'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_monthly'
            time:
              $ref: '#/components/schemas/offer_chain_time'
          required:
            - interval_type
            - time
            - day_of_month
          title: interval_type = ежемесячно
          type: object
        - description: >-
            Сброс цепочки предложений, выполняемый через временной интервал,
            заданный в часах.
          properties:
            hours_interval:
              $ref: '#/components/schemas/offer_chain_hours_interval'
            interval_type:
              $ref: '#/components/schemas/offer_chain_interval_type_hourly'
          required:
            - interval_type
            - hours_interval
          title: interval_type = hourly
          type: object
      type: object
    offer_chain_reset_next_date:
      description: >-
        Рассчитанные дата и время следующего сброса цепочки предложений в
        формате <a href="https://en.wikipedia.org/wiki/Unix_time"
        target="_blank">Unix Timestamp</a>.<br><br>Например, цепочка предложений
        сбрасывается ежемесячно начиная с 1 марта 2024 года в 01:00 по времени в
        Куала-Лумпуре (GMT+8), следующий сброс произойдет 1 апреля 2024 года в
        01:00 по часовому поясу Куала-Лумпура (GMT+8), что соответствует 31
        марта 2024 года 17:00 по времени GMT+0 или `1711904400000` в формате
        Unix Timestamp.<br><br> Example: `1711904400000`
      type: integer
    offer_chain_step_id:
      description: Уникальный ID уровня цепочки.
      example: 10
      minimum: 1
      nullable: true
      type: integer
    offer_chain_step_number:
      description: Номер уровня.
      example: 2
      minimum: 1
      nullable: false
      type: integer
    offer_chain_step_price:
      nullable: true
      properties:
        amount:
          $ref: '#/components/schemas/offer_chain_step_price_amount'
        currency:
          $ref: '#/components/schemas/offer_chain_step_price_currency'
      required:
        - amount
        - currency
      type: object
    offer_chain_step_price_amount:
      description: Цена уровня в реальной валюте.
      example: 99.99
      type: number
    offer_chain_step_price_currency:
      description: >-
        Валюта, в которой указана цена товара. Трехбуквенный код в соответствии
        со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
      example: USD
      type: string
    offer_chain_time:
      description: >-
        Время сброса цепочки предложений в указанном часовом поясе (с
        округлением до часов).<br><br>Например, время сброса установлено на
        01:00 по часовому поясу Куала-Лумпура (GMT+8), значение параметра `time`
        будет `01:00:00+08:00`.
      example: 01:00:00+08:00
      pattern: ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
      type: string
    order:
      description: Определяет порядок расположения.
      example: 1
      type: integer
    per_user_daily:
      description: Ежедневное обновления пользовательских ограничений.
      properties:
        interval_type:
          description: Период обновления ограничений.
          enum:
            - daily
          type: string
        time:
          description: >-
            Время обновления ограничений в желаемом часовом поясе (округление до
            часов).
          example: 02:00:00+03:00
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          type: string
      required:
        - interval_type
        - time
      title: interval_type = daily
      type: object
    per_user_hourly_bundle:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                Интервал в часах, через который обновляется лимит покупок
                товара. <br><br>Отсчет начинается с момента, когда товар впервые
                отображается в магазине – задается в параметре <a
                href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request">date_from</a>.<br><br>Например,
                если `date_from = "2025-11-15T18:15:00+05:00"` и `hours_interval
                = 2`, лимит покупок для этого товара будет обновляться каждые 2
                часа, начиная с `"2025-11-15T20:15:00+05:00"`.
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = hourly
      type: object
    per_user_hourly_vc:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                Интервал в часах, через который обновляется лимит покупок
                товара. <br><br>Отсчет начинается с момента, когда товар впервые
                отображается в магазине – задается в параметре <a
                href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-virtual-currency/#!path=periods/date_from&t=request">date_from</a>.<br><br>Например,
                если `date_from = "2025-11-15T18:15:00+05:00"` и `hours_interval
                = 2`, лимит покупок для этого товара будет обновляться каждые 2
                часа, начиная с `"2025-11-15T20:15:00+05:00"`.
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = hourly
      type: object
    per_user_hourly_vcp:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                Интервал в часах, через который обновляется лимит покупок
                товара. <br><br>Отсчет начинается с момента, когда товар впервые
                отображается в магазине – задается в параметре <a
                href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-virtual-currency-package/#!path=0/periods/date_from&t=request">date_from</a>.<br><br>Например,
                если `date_from = "2025-11-15T18:15:00+05:00"` и `hours_interval
                = 2`, лимит покупок для этого товара будет обновляться каждые 2
                часа, начиная с `"2025-11-15T20:15:00+05:00"`.
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = hourly
      type: object
    per_user_hourly_vi:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                Интервал в часах, через который обновляется лимит покупок
                товара. <br><br>Отсчет начинается с момента, когда товар впервые
                отображается в магазине – задается в параметре <a
                href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request">date_from</a>.<br><br>Например,
                если `date_from = "2025-11-15T18:15:00+05:00"` и `hours_interval
                = 2`, лимит покупок для этого товара будет обновляться каждые 2
                часа, начиная с `"2025-11-15T20:15:00+05:00"`.
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = hourly
      type: object
    per_user_monthly:
      description: Ежемесячное обновление пользовательских ограничений.
      properties:
        day_of_month:
          description: >-
            День месяца, когда обновляются ограничения. Если в месяце нет
            выбранного дня, поскольку он короче, то обновление произойдет в
            последний день месяца.
          maximum: 31
          minimum: 1
          type: integer
        interval_type:
          description: Период обновления ограничений.
          enum:
            - monthly
          type: string
        time:
          description: >-
            Время обновления ограничений в желаемом часовом поясе (округление до
            часов).
          example: 23:00:00+03:00
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          type: string
      required:
        - interval_type
        - time
        - day_of_month
      title: interval_type = ежемесячно
      type: object
    per_user_weekly:
      description: Еженедельное обновления пользовательских ограничений.
      properties:
        day_of_week:
          description: >-
            День недели, когда обновляются ограничения: 1 — понедельник, 7 —
            воскресенье.
          maximum: 7
          minimum: 1
          type: integer
        interval_type:
          description: Период обновления ограничений.
          enum:
            - weekly
          type: string
        time:
          description: >-
            Время обновления ограничений в желаемом часовом поясе (округление до
            часов).
          example: 11:00:00+03:00
          pattern: >-
            ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
          type: string
      title: interval_type = еженедельно
      type: object
    periods:
      description: >-
        Периоды действия цепочки наград. Если указано больше одного периода,
        параметры `date_from` и `date_until` становятся обязательными.
      items:
        properties:
          date_from:
            description: Дата начала действия указанной цепочки наград.
            example: '2020-08-11T10:00:00+03:00'
            format: date-time
            nullable: false
            type: string
          date_until:
            description: >-
              Дата окончания действия указанной цепочки наград. Может быть
              `null`, только если указан один период действия.
            example: '2020-08-11T20:00:00+03:00'
            format: date-time
            nullable: true
            type: string
        required:
          - date_from
        type: object
      nullable: false
      type: array
    personalized-catalog_user-attribute_conditions_model-get:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-get'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность товаров в каталоге на основе соответствия
            атрибутов пользователя всем указанным условиям.
    personalized-catalog_user-attribute_conditions_model-post:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-post'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность товаров в каталоге на основе соответствия
            атрибутов пользователя всем указанным условиям.
    popup_header-two-letter-locale:
      description: >-
        Объект с локализациями для описания всплывающей подсказки в цепочке
        наград для клана. Двухбуквенный [код языка в нижнем
        регистре](https://developers.xsolla.com/ru/doc/pay-station/features/localization/).
      nullable: true
      properties:
        ar:
          example: null
          nullable: true
          type: string
        bg:
          example: null
          nullable: true
          type: string
        cn:
          example: null
          nullable: true
          type: string
        cs:
          example: null
          nullable: true
          type: string
        de:
          example: Wie man Belohnungen freischaltet
          nullable: true
          type: string
        en:
          example: How to unlock rewards
          nullable: true
          type: string
        es:
          example: Cómo desbloquear recompensas
          nullable: true
          type: string
        fr:
          example: Comment débloquer des récompenses
          nullable: true
          type: string
        he:
          example: null
          nullable: true
          type: string
        it:
          example: Come sbloccare ricompense
          nullable: true
          type: string
        ja:
          example: 報酬をアンロックする方法
          nullable: true
          type: string
        ko:
          example: null
          nullable: true
          type: string
        pl:
          example: null
          nullable: true
          type: string
        pt:
          example: null
          nullable: true
          type: string
        ro:
          example: null
          nullable: true
          type: string
        ru:
          example: null
          nullable: true
          type: string
        th:
          example: null
          nullable: true
          type: string
        tr:
          example: null
          nullable: true
          type: string
        tw:
          example: null
          nullable: true
          type: string
        vi:
          example: null
          nullable: true
          type: string
      type: object
    popup_image_url:
      description: >-
        Изображение для подсказки про цепочку наград для клана во всплывающем
        окне.
      example: https://image.example.com
      format: uri
      nullable: true
      type: string
    popup_instruction-two-letter-locale:
      description: >-
        Объект с локализациями для описания всплывающей подсказки в цепочке
        наград для клана. Двухбуквенный [код языка в нижнем
        регистре](https://developers.xsolla.com/ru/doc/pay-station/features/localization/).
      nullable: true
      properties:
        ar:
          example: null
          nullable: true
          type: string
        bg:
          example: null
          nullable: true
          type: string
        cn:
          example: null
          nullable: true
          type: string
        cs:
          example: null
          nullable: true
          type: string
        de:
          example: >-
            Du musst ein Clanmitglied sein, um Clananreize zu erhalten. Du
            trittst einem Clan bei, wenn ein Clanmitglied dich einlädt, und du
            die Einladung annimmst. Du kannst auch deinen eigenen Clan
            erstellen.
          nullable: true
          type: string
        en:
          example: >-
            You must be a clan member to get clan rewards. You join a clan when
            a clan member invites you to the clan, and you accept the invite.
            You can also create your own clan.
          nullable: true
          type: string
        es:
          example: >-
            Debes ser miembro de un clan para obtener las recompensas del clan.
            Te unes a un clan cuando un miembro del clan te invita al clan y
            aceptas la invitación. También puedes crear tu propio clan.
          nullable: true
          type: string
        fr:
          example: >-
            Vous devez être membre d'un clan pour obtenir les récompenses du
            clan. Vous rejoignez un clan lorsque qu'un membre du clan vous
            invite au clan et que vous acceptez l'invitation. Vous pouvez
            également créer votre propre clan.
          nullable: true
          type: string
        he:
          example: null
          nullable: true
          type: string
        it:
          example: >-
            Devi essere un membro del clan per ottenere le ricompense del clan.
            Ti unisci a un clan quando un membro del clan ti invita al clan e
            accetti l'invito. Puoi anche creare il tuo clan.
          nullable: true
          type: string
        ja:
          example: >-
            クランリワードを受け取るには、クランメンバーでなければなりません。
            クランメンバーがあなたをクランに招待し、招待を受け入れると、クランに参加できます。 あなた自身のクランを作成することもできます。
          nullable: true
          type: string
        ko:
          example: null
          nullable: true
          type: string
        pl:
          example: null
          nullable: true
          type: string
        pt:
          example: null
          nullable: true
          type: string
        ro:
          example: null
          nullable: true
          type: string
        ru:
          example: null
          nullable: true
          type: string
        th:
          example: null
          nullable: true
          type: string
        tr:
          example: null
          nullable: true
          type: string
        tw:
          example: null
          nullable: true
          type: string
        vi:
          example: null
          nullable: true
          type: string
      type: object
    price_conditions_bonus:
      description: "Массив объектов с условиями, задающими ценовой диапазон применения акции.<br> Акция применяется только к товарам, цена которых удовлетворяет всем условиям в массиве.\_Если вы передаете этот массив, в объекте [condition](/ru/api/shop-builder/operation/create-bonus-promotion/#!path=condition&t=request) передайте значение `null`."
      items:
        $ref: '#/components/schemas/price_conditions_items'
      nullable: true
      type: array
    price_conditions_discount:
      description: "Массив объектов с условиями, задающими ценовой диапазон применения акции.<br>Акция применяется только к товарам, цена которых удовлетворяет всем условиям в массиве.\_Если вы передаете этот массив, в объекте [items](/ru/api/shop-builder/operation/create-item-promotion/#!path=items&t=request) передайте значение `null`."
      items:
        $ref: '#/components/schemas/price_conditions_items'
      nullable: true
      type: array
    price_conditions_items:
      description: Each object describes a rule the price should be.
      properties:
        operator:
          description: Оператор сравнения для задания ценового диапазона применения акции.
          enum:
            - ge
            - gt
            - le
            - lt
            - eq
            - ne
          type: string
          x-enumDescriptions:
            eq: Равно
            ge: Больше или равно
            gt: Больше чем
            le: Меньше или равно
            lt: Меньше чем
            ne: Не равно
        value:
          description: Значение для определения ценового диапазона применения акции.
          pattern: ^\d+(\.\d{1,4})?$
          type: string
      required:
        - operator
        - value
      type: object
    price_conditions_promocode:
      description: >-
        Массив объектов с условиями, задающими ценовой диапазон применения акции
        для отдельных товаров в корзине.<br>

        Стоимость каждого товара в корзине пользователя сравнивается с заданным
        в условии ценовым диапазоном.
        [Бонусы](/ru/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request)
        и
        [скидки](/ru/api/shop-builder/operation/create-promo-code/#!path=discount&t=request)
        применяются только к тем товарам в корзине, цена которых удовлетворяет
        условию.<br>

        Если вы передаете этот массив, в массиве
        [discounted_items](/ru/api/shop-builder/operation/create-promo-code/#!path=discounted_items&t=request)
        передайте значение `null`.
      items:
        $ref: '#/components/schemas/price_conditions_items'
      nullable: true
      type: array
    promotion_periods:
      description: >-
        Периоды действия акции. Если указано больше одного периода, параметры
        `date_from` и `date_until` становятся обязательными.
      items:
        properties:
          date_from:
            description: Дата начала действия указанной акции.
            example: '2020-08-11T10:00:00+03:00'
            format: date-time
            nullable: false
            type: string
          date_until:
            description: >-
              Дата окончания действия указанной акции. Если передано значение
              `null`, акция является бессрочной. Может быть `null`, только если
              указан один период действия.
            example: '2020-08-11T20:00:00+03:00'
            format: date-time
            nullable: true
            type: string
        required:
          - date_from
        type: object
      nullable: false
      type: array
    promotion_recurrent_schedule_response:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: Период обновления установленный ограничений для пользователя.
          properties:
            day_of_month:
              description: >-
                День месяца, когда обновляются ограничения. Если в месяце нет
                указанного дня, поскольку месяц короче, обновление произойдет в
                последний день месяца. Не `null` только для периода `monthly`.
              maximum: 31
              minimum: 1
              nullable: true
              type: integer
            day_of_week:
              description: >-
                День недели, когда обновляются ограничения: 1 — понедельник, 7 —
                воскресенье. Не `null` только для типа периода `weekly`.
              maximum: 7
              minimum: 1
              nullable: true
              type: integer
            displayable_reset_next_date:
              description: Дата и время, когда ограничения должны быть сброшены (ISO 8601).
              example: '2023-02-28T11:00:00+08:00'
              format: date-time
              type: string
            displayable_reset_start_date:
              description: Дата и время первого обновления ограничения (ISO 8601).
              example: '2023-02-28T11:00:00+08:00'
              format: date-time
              type: string
            interval_type:
              description: Период обновления ограничения на продажу товара.
              enum:
                - daily
                - weekly
                - monthly
              type: string
            reset_next_date:
              description: Дата и время обновления ограничений (Unix Timestamp).
              example: 1677553200
              type: integer
            time:
              description: >-
                Время обновления ограничений в желаемом часовом поясе
                (округление до часов).
              example: 11:00:00+03:00
              format: full-time
              type: string
          type: object
      type: object
    promotion_user-attribute_conditions_model-get:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-get'
        - description: >-
            Условия для проверки атрибутов пользователя.

            Определяют доступность акции на основе соответствия атрибутов
            пользователя всем указанным условиям.
    promotion_user-attribute_conditions_model-post:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-post'
        - description: >-
            Условия для проверки атрибутов пользователя.

            Определяют доступность акции на основе соответствия атрибутов
            пользователя всем указанным условиям.
    recurrent_schedule_client_side:
      description: Период регулярного сброса цепочки наград.
      nullable: true
      properties:
        interval_type:
          oneOf:
            - $ref: '#/components/schemas/interval_type_weekly'
              title: interval_type = еженедельно
            - $ref: '#/components/schemas/interval_type_monthly'
              title: interval_type = ежемесячно
            - $ref: '#/components/schemas/interval_type_hourly_rc'
              title: interval_type = hourly
        reset_next_date:
          $ref: '#/components/schemas/reset_next_date'
      type: object
    recurrent_schedule_create_update:
      description: Период регулярного сброса цепочки наград.
      nullable: true
      oneOf:
        - description: Еженедельный сброс цепочки наград.
          properties:
            day_of_week:
              $ref: '#/components/schemas/day_of_week'
            interval_type:
              $ref: '#/components/schemas/interval_type_weekly'
            time:
              $ref: '#/components/schemas/time'
          required:
            - interval_type
            - time
            - day_of_week
          title: interval_type = еженедельно
          type: object
        - description: "Ежемесячный \_ сброс цепочки наград."
          properties:
            day_of_month:
              $ref: '#/components/schemas/day_of_month'
            interval_type:
              $ref: '#/components/schemas/interval_type_monthly'
            time:
              $ref: '#/components/schemas/time'
          required:
            - interval_type
            - time
            - day_of_month
          title: interval_type = ежемесячно
          type: object
        - description: >-
            Сброс цепочки наград, выполняемый через временной интервал, заданный
            в часах.
          properties:
            hours_interval:
              $ref: '#/components/schemas/reward_chain_hours_interval'
            interval_type:
              $ref: '#/components/schemas/interval_type_hourly_rc'
          required:
            - interval_type
            - hours_interval
          title: interval_type = hourly
          type: object
      type: object
    request-attribute-value:
      example:
        external_id: value_id
        value:
          de: Wert
          en: Value
      properties:
        external_id:
          $ref: '#/components/schemas/value-external_id'
        value:
          $ref: '#/components/schemas/value-name'
      required:
        - external_id
        - value
      type: object
    reset_next_date:
      description: "Расчетные дата и время, когда цепочка наград будет сброшена в следующий раз\_(<a href=\"https://en.wikipedia.org/wiki/Unix_time\" target=\"_blank\">Unix Timestamp</a>).<br><br>Например, сброс цепочки наград осуществляется ежемесячно, начиная с 1 марта 2024 в 01:00 по часовому поясу Куала-Лумпура (GMT+8). Дата и время следующего сброса цепочки наград: 1 апреля 2024 в 01:00 по часовому поясу Куала-Лумпура (GMT+8), что соответствует 31 марта 2024 17:00 GMT+0 или `1711904400000` в формате Unix Timestamp.<br><br>Example: `1711904400000`"
      type: integer
    reward-chain-step-reward_user-attribute_conditions_model-get:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-get'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность награды на шаге цепочки наград на основе
            соответствия атрибутов пользователя всем указанным условиям.
    reward-chain-step-reward_user-attribute_conditions_model-post:
      allOf:
        - $ref: '#/components/schemas/user-attribute_conditions_model-post'
        - description: >-
            Условия для проверки атрибутов пользователя. 

            Определяют доступность награды на шаге цепочки наград на основе
            соответствия атрибутов пользователя всем указанным условиям.
    reward_chain_hours_interval:
      description: >-
        Интервал в часах, через который выполняется сброс цепочки
        наград.<br><br>Отсчет начинается от значения <a
        href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-reward-chain/#!path=0/date_start&t=request">date_start</a>.
        Например, если `date_start = "2025-11-15T18:15:00+05:00"` и
        `hours_interval = 2`, цепочка будет сбрасываться каждые 2 часа, начиная
        с `"2025-11-15T20:15:00+05:00"`.
      maximum: 10000
      minimum: 1
      type: integer
    reward_chain_id:
      description: Уникальный ID цепочки наград.
      example: 9
      type: integer
    reward_item_quantity:
      description: Количество товаров.
      example: 2
      type: integer
    reward_step_price:
      properties:
        amount:
          $ref: '#/components/schemas/step_price_amount'
      required:
        - amount
      type: object
    reward_step_short:
      description: Уровень цепочки наград.
      properties:
        image_url:
          $ref: '#/components/schemas/image_url'
        name:
          $ref: '#/components/schemas/name-localization-object'
        price:
          $ref: '#/components/schemas/reward_step_price'
        reward:
          items:
            properties:
              attribute_conditions:
                $ref: >-
                  #/components/schemas/reward-chain-step-reward_user-attribute_conditions_model-get
              quantity:
                $ref: '#/components/schemas/reward_item_quantity'
              sku:
                $ref: '#/components/schemas/sku'
            type: object
          type: array
        step_id:
          $ref: '#/components/schemas/step_id'
      type: object
    rolling-skippable-daily-chain-base:
      description: Базовые свойства ежедневной награды с типом rolling_skippable.
      properties:
        date_end:
          $ref: '#/components/schemas/rolling_date_end'
        date_start:
          $ref: '#/components/schemas/daily_rolling_chain_date_start'
        is_recurrent:
          $ref: '#/components/schemas/rolling_is_recurrent'
        type:
          allOf:
            - $ref: '#/components/schemas/daily_chain_type'
            - enum:
                - rolling_skippable
      type: object
    rolling-unskippable-daily-chain-base:
      description: Базовые свойства ежедневной награды с типом `rolling_unskippable`.
      properties:
        date_end:
          $ref: '#/components/schemas/rolling_date_end'
        date_start:
          $ref: '#/components/schemas/daily_rolling_chain_date_start'
        is_recurrent:
          $ref: '#/components/schemas/rolling_is_recurrent'
        type:
          allOf:
            - $ref: '#/components/schemas/daily_chain_type'
            - enum:
                - rolling_unskippable
      type: object
    rolling_date_end:
      description: Дата окончания срока действия ежедневной награды.
      example: '2020-04-15T18:16:00+05:00'
      format: date-time
      nullable: true
      type: string
    rolling_is_recurrent:
      default: false
      description: >-
        Перезапускается ли ежедневная награда. Если передано значение `true`,
        ежедневная награда перезапускается после того, как пользователь проходит
        все уровни, и он может начать заново с первого уровня. Перезапуск
        возможен только в пределах активного периода награды, заданного
        параметрами `date_start` и `date_end`.
      example: true
      type: boolean
    schemas-422-invalid-request:
      properties:
        errorCode:
          example: 1102
          type: integer
        errorMessage:
          example: >-
            [0401-1102]: Unprocessable Entity. The property `property_name` is
            required
          type: string
        statusCode:
          example: 422
          type: integer
        transactionId:
          example: x-x-x-x-transactionId-mock-x-x-x
          type: string
      type: object
    sku:
      description: >-
        Уникальный ID товара. Артикул может содержать только строчные и
        заглавные латинские буквы, цифры, точки, тире и подчеркивания.
      example: booster_mega_1
      maxLength: 255
      minLength: 1
      pattern: ^[a-zA-Z0-9_\-–.]*$
      type: string
    step_id:
      description: Уникальный ID уровня.
      example: 10
      nullable: true
      type: integer
    step_price_amount:
      description: Цена уровня в призовых баллах.
      example: 100
      type: integer
    time:
      description: >-
        Время, когда происходит сброс цепочки наград в желаемом часовом поясе
        (округление до часов).<br><br>Например, задано время сброса цепочки
        наград 01:00 для часового пояса Куала-Лумпура (GMT+8). Значение
        параметра `time` в этом случае `01:00:00+08:00`.
      example: 01:00:00+08:00
      pattern: ((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])
      type: string
    top_contributors:
      nullable: true
      properties:
        contributed_amount:
          description: Количество призовых баллов, которые заработал пользователь.
          example: 100
          type: integer
        name:
          description: >-
            ID пользователя, который отправляется в Xsolla в процессе
            авторизации, связывает пользователя с вашим проектом Xsolla Login и
            отображается в качестве никнейма. Если вы используете [авторизацию
            по ID
            пользователя](https://developers.xsolla.com/ru/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth),
            мы рекомендуем передать параметр <code>name</code>  [в ответе на
            вебхук](https://developers.xsolla.com/ru/webhooks/operation/user-validation-in-webshop/).
            Этот параметр содержит имя пользователя, которое будет
            использоваться как никнейм.
          example: Rocket
          type: string
      type: object
    total_promotions_count:
      description: Общее количество акций.
      type: integer
    two-letter-locale:
      description: Двухбуквенные строчные языковые коды.
      nullable: true
      properties:
        ar:
          description: Арабский
          nullable: true
          type: string
        bg:
          description: Болгарский
          nullable: true
          type: string
        cn:
          description: Китайский упрощенный
          nullable: true
          type: string
        cs:
          description: Чешский
          nullable: true
          type: string
        de:
          description: Немецкий
          nullable: true
          type: string
        en:
          description: Английский
          nullable: true
          type: string
        es:
          description: Spanish (Spain)
          nullable: true
          type: string
        fr:
          description: Французский
          nullable: true
          type: string
        he:
          description: Иврит
          nullable: true
          type: string
        id:
          description: Индонезийский
          nullable: true
          type: string
        it:
          description: Итальянский
          nullable: true
          type: string
        ja:
          description: Японский
          nullable: true
          type: string
        km:
          description: Кхмерский
          nullable: true
          type: string
        ko:
          description: Корейский
          nullable: true
          type: string
        lo:
          description: Лаосский
          nullable: true
          type: string
        my:
          description: Бирманский
          nullable: true
          type: string
        ne:
          description: Непальский
          nullable: true
          type: string
        ph:
          description: Филиппинский
          nullable: true
          type: string
        pl:
          description: Польский
          nullable: true
          type: string
        pt:
          description: Португальский
          nullable: true
          type: string
        ro:
          description: Румынский
          nullable: true
          type: string
        ru:
          description: Русский
          nullable: true
          type: string
        th:
          description: Тайский
          nullable: true
          type: string
        tr:
          description: Турецкий
          nullable: true
          type: string
        tw:
          description: Китайский традиционный
          nullable: true
          type: string
        vi:
          description: Вьетнамский
          nullable: true
          type: string
      title: two-letter
      type: object
    unit_type:
      description: 'Тип: `game`.'
      example: game
      type: string
    update-calendar-hard-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/calendar-hard-daily-chain-base'
        - description: Ежедневная награда с типом `calendar_hard`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/modify-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    update-clan-reward-chain-model:
      allOf:
        - $ref: '#/components/schemas/create-reward-chain-model'
        - description: Цепочка наград для клана.
          properties:
            clan_type:
              $ref: '#/components/schemas/clan_type'
            popup_header:
              $ref: '#/components/schemas/popup_header-two-letter-locale'
            popup_image_url:
              $ref: '#/components/schemas/popup_image_url'
            popup_instruction:
              $ref: '#/components/schemas/popup_instruction-two-letter-locale'
          required:
            - name
            - periods
            - steps
            - is_enabled
            - popup_header
            - popup_instruction
          type: object
    update-reward-chain-model:
      description: Цепочка наград.
      properties:
        attribute_conditions:
          $ref: '#/components/schemas/chain_user-attribute_conditions_model-post'
        description:
          $ref: '#/components/schemas/description-localization-object'
        image_url:
          $ref: '#/components/schemas/image_url'
        is_always_visible:
          $ref: '#/components/schemas/chain_is_always_visible'
        is_enabled:
          $ref: '#/components/schemas/is_enabled'
        is_reset_after_end:
          $ref: '#/components/schemas/is_reset_after_end'
        long_description:
          $ref: '#/components/schemas/long-description-localization-object'
        name:
          $ref: '#/components/schemas/name-localization-object'
        order:
          $ref: '#/components/schemas/order'
        periods:
          $ref: '#/components/schemas/periods'
        recurrent_schedule:
          $ref: '#/components/schemas/recurrent_schedule_create_update'
        steps:
          items:
            $ref: '#/components/schemas/modify_reward_step'
          type: array
      required:
        - name
        - periods
        - steps
        - is_enabled
      type: object
    update-rolling-skippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-skippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_skippable`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/modify-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    update-rolling-unskippable-daily-chain-model:
      allOf:
        - $ref: '#/components/schemas/rolling-unskippable-daily-chain-base'
        - description: Ежедневная награда с типом `rolling_unskippable`.
          properties:
            description:
              $ref: '#/components/schemas/description-localization-object'
            id:
              $ref: '#/components/schemas/daily_chain_id'
            is_enabled:
              $ref: '#/components/schemas/is_enabled'
            name:
              $ref: '#/components/schemas/name-localization-object'
            order:
              $ref: '#/components/schemas/order'
            steps:
              items:
                $ref: '#/components/schemas/modify-daily-chain-step-model'
              type: array
          required:
            - name
            - date_start
            - steps
            - is_enabled
            - type
          type: object
    update_step_id:
      description: >-
        Уникальный ID уровня цепочки. Укажите его при обновлении, чтобы
        сохранить прогресс пользователя для этого уровня.
      example: 10
      minimum: 1
      nullable: true
      type: integer
    user-attribute_condition_date_model-get:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_date
        type:
          $ref: '#/components/schemas/user-attribute_conditions_properties_type-date'
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      title: type = date
      type: object
    user-attribute_condition_date_model-post:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_date
        type:
          $ref: '#/components/schemas/user-attribute_conditions_properties_type-date'
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      required:
        - attribute
        - operator
        - value
        - type
      title: type = date
      type: object
    user-attribute_condition_number_model-get:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_number
        type:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_type-number
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      title: type = number
      type: object
    user-attribute_condition_number_model-post:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_number
        type:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_type-number
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      required:
        - attribute
        - operator
        - value
        - type
      title: type = number
      type: object
    user-attribute_condition_string_model-get:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_string
        type:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_type-string
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      title: type = string
      type: object
    user-attribute_condition_string_model-post:
      properties:
        attribute:
          $ref: '#/components/schemas/user-attribute_conditions_properties_attribute'
        can_be_missing:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_can_be_missing
        operator:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_operator_string
        type:
          $ref: >-
            #/components/schemas/user-attribute_conditions_properties_type-string
        value:
          $ref: '#/components/schemas/user-attribute_conditions_properties_value'
      required:
        - attribute
        - operator
        - value
        - type
      title: type = string
      type: object
    user-attribute_conditions_model-get:
      items:
        oneOf:
          - $ref: '#/components/schemas/user-attribute_condition_string_model-get'
          - $ref: '#/components/schemas/user-attribute_condition_number_model-get'
          - $ref: '#/components/schemas/user-attribute_condition_date_model-get'
      maxItems: 100
      minItems: 1
      type: array
    user-attribute_conditions_model-post:
      items:
        oneOf:
          - $ref: '#/components/schemas/user-attribute_condition_string_model-post'
          - $ref: '#/components/schemas/user-attribute_condition_number_model-post'
          - $ref: '#/components/schemas/user-attribute_condition_date_model-post'
      maxItems: 100
      minItems: 1
      type: array
    user-attribute_conditions_properties_attribute:
      description: Код атрибута пользователя.
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
    user-attribute_conditions_properties_can_be_missing:
      description: "Считается ли условие выполненным, если этот атрибут отсутствует в атрибутах пользователя.\_Передайте `true`, чтобы показывать товар пользователям, у которых нет этого атрибута. Пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, не увидят товар. `false` — пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, или атрибута нет, не увидят товар."
      type: boolean
    user-attribute_conditions_properties_operator_date:
      description: >-
        Тип операции, выполняемой по условию. Для типа атрибута
        <code>date</code>.
      enum:
        - eq
        - ne
        - lt
        - gt
        - le
        - ge
      type: string
      x-enumDescriptions:
        eq: Равно
        ge: Позже или равно
        gt: Позже
        le: Раньше или равно
        lt: Раньше
        ne: Не равно
    user-attribute_conditions_properties_operator_number:
      description: >-
        Тип операции, выполняемой по условию. Для типа атрибута
        <code>number</code>.
      enum:
        - eq
        - ne
        - gt
        - ge
        - lt
        - le
      type: string
      x-enumDescriptions:
        eq: Равно
        ge: Больше или равно
        gt: Больше
        le: Меньше или равно
        lt: Меньше
        ne: Не равно
    user-attribute_conditions_properties_operator_string:
      description: >-
        Тип операции, выполняемой по условию. Для типа атрибута
        <code>string</code>.
      enum:
        - eq
        - ne
      type: string
      x-enumDescriptions:
        eq: Равно
        ne: Не равно
    user-attribute_conditions_properties_type-date:
      description: Тип атрибута пользователя.
      enum:
        - date
      type: string
    user-attribute_conditions_properties_type-number:
      description: Тип атрибута пользователя.
      enum:
        - number
      type: string
    user-attribute_conditions_properties_type-string:
      description: Тип атрибута пользователя.
      enum:
        - string
      type: string
    user-attribute_conditions_properties_value:
      description: >-
        Значение условия, с которым будет сравниваться значение атрибута
        пользователя. Тип зависит от типа атрибута.
      maxLength: 255
      type: string
    user-attribute_personalized-catalog:
      properties:
        attribute_conditions:
          $ref: >-
            #/components/schemas/personalized-catalog_user-attribute_conditions_model-get
        is_enabled:
          description: Включено ли данное правило.
          type: boolean
        is_satisfied_for_unauth:
          description: >-
            Отображается ли товар неавторизованным пользователям. Если `true`,
            товар отображается неавторизованным пользователям независимо от
            правил отображения каталога. `false` по умолчанию.
          type: boolean
        items:
          items:
            description: >-
              Товары, которые видит пользователь, если переданные им значения
              атрибутов товаров соответствуют условиям.
            properties:
              bundle_type:
                description: Тип бандла. Возвращается, если тип элемента является бандлом.
                enum:
                  - standard
                  - virtual_currency_package
                type: string
              item_id:
                description: ID предмета (артикул).
                type: number
              name:
                description: Название товара.
                type: string
              sku:
                description: Артикул товара.
                type: string
              type:
                description: Тип товара.
                enum:
                  - virtual_good
                  - virtual_currency
                  - bundle
                  - physical_good
                  - unit
                type: string
            type: object
          type: array
        name:
          description: >-
            Читаемое название правила. Используется для отображения правила в
            Личном кабинете.
          type: string
        rule_id:
          description: ID правила.
          type: number
      required:
        - rule_id
        - name
        - is_enabled
        - attribute_conditions
        - items
      type: object
    user-attribute_personalized-catalog-body:
      properties:
        attribute_conditions:
          $ref: >-
            #/components/schemas/personalized-catalog_user-attribute_conditions_model-post
        is_enabled:
          description: Включено ли данное правило.
          type: boolean
        is_satisfied_for_unauth:
          description: >-
            Отображается ли товар неавторизованным пользователям. Если `true`,
            товар отображается неавторизованным пользователям независимо от
            правил отображения каталога. `false` по умолчанию.
          type: boolean
        items:
          items:
            oneOf:
              - description: >-
                  Товары, которые видит пользователь, если переданные им
                  значения атрибутов товаров соответствуют условиям.
                properties:
                  item_id:
                    description: ID предмета (артикул).
                    type: number
                required:
                  - item_id
                type: object
              - description: >-
                  Товары, которые видит пользователь, если переданные им
                  значения атрибутов товаров соответствуют условиям.
                properties:
                  sku:
                    description: Артикул товара.
                    type: string
                required:
                  - sku
                type: object
          maxItems: 100
          minItems: 1
          type: array
        name:
          description: >-
            Читаемое название правила. Используется для отображения правила в
            Личном кабинете.
          maxLength: 255
          minLength: 1
          pattern: ^\S
          type: string
      type: object
    user-attribute_personalized-catalog-body-required:
      properties:
        attribute_conditions:
          $ref: >-
            #/components/schemas/personalized-catalog_user-attribute_conditions_model-post
        is_enabled:
          description: Включено ли данное правило.
          type: boolean
        is_satisfied_for_unauth:
          description: >-
            Отображается ли товар неавторизованным пользователям. Если `true`,
            товар отображается неавторизованным пользователям независимо от
            правил отображения каталога. `false` по умолчанию.
          type: boolean
        items:
          items:
            oneOf:
              - description: >-
                  Товары, которые видит пользователь, если переданные им
                  значения атрибутов товаров соответствуют условиям.
                properties:
                  item_id:
                    description: ID предмета (артикул).
                    type: number
                required:
                  - item_id
                type: object
              - description: >-
                  Товары, которые видит пользователь, если переданные им
                  значения атрибутов товаров соответствуют условиям.
                properties:
                  sku:
                    description: Артикул товара.
                    type: string
                required:
                  - sku
                type: object
          maxItems: 100
          minItems: 1
          type: array
        name:
          description: >-
            Читаемое название правила. Используется для отображения правила в
            Личном кабинете.
          maxLength: 255
          minLength: 1
          pattern: ^\S
          type: string
      required:
        - name
        - is_enabled
        - attribute_conditions
        - items
      type: object
    user-attribute_personalized-catalog_all:
      properties:
        is_enabled:
          description: Включено ли данное правило.
          type: boolean
        is_satisfied_for_unauth:
          description: >-
            Отображается ли товар неавторизованным пользователям. Если `true`,
            товар отображается неавторизованным пользователям независимо от
            правил отображения каталога. `false` по умолчанию.
          type: boolean
        name:
          description: >-
            Читаемое название правила. Используется для отображения правила в
            Личном кабинете.
          type: string
        rule_id:
          description: ID правила.
          type: number
      required:
        - rule_id
        - name
        - is_enabled
      type: object
    value-cart_is_free:
      default: false
      description: Если `true`, корзина бесплатная.
      example: false
      type: boolean
    value-external_id:
      description: >-
        Уникальный ID значения атрибута. `external_id` может содержать только
        строчные латинские буквы, цифры, тире и подчеркивания.
      example: attribute_value
      maxLength: 255
      minLength: 1
      pattern: ^[-_.\d\w]+$
      type: string
    value-is_free:
      default: false
      description: Если `true`, товар бесплатный.
      example: false
      type: boolean
    value-name:
      additionalProperties:
        type: string
      default:
        de: Strategie
        en: Strategy
      description: >-
        Объект с локализациями для названия значения. Ключи для обозначения
        стран указаны в стандарте ISO 3166-1.
      example:
        de: Strategie
        en: Strategy
      type: object
    value-point-amount:
      description: Количество призовых баллов.
      type: integer
    value-point-description:
      description: Описание призовых баллов.
      nullable: true
      type: string
    value-point-long-description:
      description: Развернутое описание призовых баллов.
      nullable: true
      type: string
    value-point-name:
      description: Название призовых баллов.
      type: string
    value-point-sku:
      description: Уникальный ID призовых баллов.
      type: string
    virtual_currency_package_recurrent_schedule:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: >-
            Сброс лимитов на покупку товара, выполняемый через временной
            интервал, заданный в часах.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vcp'
      type: object
    virtual_currency_recurrent_schedule:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: >-
            Сброс лимитов на покупку товара, выполняемый через временной
            интервал, заданный в часах.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vc'
      type: object
    virtual_item_recurrent_schedule:
      description: Период обновления установленный ограничений.
      nullable: true
      properties:
        per_user:
          description: >-
            Сброс лимитов на покупку товара, выполняемый через временной
            интервал, заданный в часах.
          oneOf:
            - $ref: '#/components/schemas/per_user_daily'
            - $ref: '#/components/schemas/per_user_weekly'
            - $ref: '#/components/schemas/per_user_monthly'
            - $ref: '#/components/schemas/per_user_hourly_vi'
      type: object
  securitySchemes:
    AuthForCart:
      description: >-
        При продаже корзины с играми вы можете [вызвать соответствующий метод
        без
        авторизации](/ru/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users).


        Для этого:


        * Добавьте уникальный идентификатор к параметру `x-unauthorized-id` в
        хедере для игр.

        * Добавьте адрес электронной почты пользователя в параметр `x-user` (в
        кодировке Base64) в хедере для игр.


        По умолчанию для авторизации используется JWT пользователя Авторизации
        Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с
        помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer
        eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`.


        В качестве альтернативы вы можете использовать [Pay Station access
        token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/).
      scheme: bearer
      type: http
    XsollaLoginUserJWT:
      bearerFormat: JWT
      description: >-
        По умолчанию для авторизации используется JWT пользователя Авторизации
        Иксолла (Bearer-токен). Вы можете попробовать вызвать этот метод с
        помощью тестового токена JWT пользователя Авторизации Иксолла: `Bearer
        eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`.


        В качестве альтернативы вы можете использовать [Pay Station access
        token](https://developers.xsolla.com/ru/api/pay-station/operation/create-token/).
      scheme: bearer
      type: http
    basicAuth:
      description: >-
        Xsolla API использует базовую аутентификацию. Все запросы к API должны
        содержать заголовок `Authorization: Basic
        <your_authorization_basic_key>`, где `your_authorization_basic_key` —
        пара `project_id:api_key`, закодированная по стандарту Base64.


        Вы можете использовать `merchant_id` вместо, `project_id` при
        необходимости. Это не влияет на функциональность.


        Значения параметров вы можете найти в [Личном
        кабинете](https://publisher.xsolla.com/):


        * `merchant_id` отображается:
          * В разделе **Настройки компании > Компания**
          * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>`.
        * `api_key` отображается в Личном кабинете только при создании и должен
        храниться на вашей стороне. Создать ключ можно в разделах:
          * **Настройки компании > Ключи API**
          * **Настройки проекта > Ключи API**
        * `project_id` отображается:
          * В Личном кабинете рядом с названием проекта.
          * В URL-адресе в адресной строке браузера при работе над проектом в учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>/projects/<project_id>`.

        Подробная информация о работе с ключами API приведена в [справочнике
        API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview).
      scheme: basic
      type: http
    basicMerchantAuth:
      description: >-
        Xsolla API использует базовую аутентификацию. Все запросы к API должны
        содержать заголовок `Authorization: Basic
        <your_authorization_basic_key>`, где `your_authorization_basic_key` —
        пара `merchant_id:api_key`, закодированная по стандарту Base64.


        Значения параметров вы можете найти в [Личном
        кабинете](https://publisher.xsolla.com/):


        * `merchant_id` отображается:
          * В разделе **Настройки компании > Компания**
          * В URL-адресе в адресной строке браузера на любой странице учетной записи издателя. URL-адрес имеет следующий формат: `https://publisher.xsolla.com/<merchant_id>`
        * `api_key` отображается в Личном кабинете только при создании и должен
        храниться на вашей стороне. Создать ключ можно в разделах:
          * **Настройки компании > Ключи API**
          * **Настройки проекта > Ключи API**

        Подробная информация о работе с ключами API приведена в [справочнике
        API](https://developers.xsolla.com/ru/api/getting-started/#api_keys_overview).
      scheme: basic
      type: http
info:
  description: >-
    # Overview


    * **Version:** 2.0.0

    * **Servers**: `https://store.xsolla.com/api`

    * **[Contact Us by Email](mailto:integration@xsolla.com)**

    * **Contact URL:** https://xsolla.com/

    * **Required TLS version:** 1.2


    Shop Builder API provides a third-party solution for implementing

    the server side for your store interface. Use the endpoints to manage
    in-game items,

    in-game currencies, cart, player inventory, promotions, game library, etc.
  title: Shop Builder API
  version: 2.0.0
openapi: 3.0.0
paths:
  /v1/admin/projects/{project_id}/connectors/import_items/import/status:
    get:
      description: "Возвращает информацию о прогрессе импорта товаров в проект. Метод возвращает данные по последнему импорту,\_ выполненному через API или Личный кабинет."
      operationId: get-items-import-status
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-items-import-status-model'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      servers:
        - url: https://connector.xsolla.com
      summary: Получение статуса импорта товаров
      tags:
        - connector-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v1/projects/{project_id}/import/from_external_file:
    post:
      description: >-
        Импортирует товары в магазин из JSON-файла по указанному URL-адресу.
        Подробная информация об импорте из JSON-файла приведена в
        [документации](https://developers.xsolla.com/ru/doc/shop-builder/how-to/json-import/).
      operationId: import-items-from-external-file
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/connector-import-items-body'
      responses:
        '201':
          content:
            application/json:
              schema:
                properties:
                  import_id:
                    description: >-
                      ID операции импорта. Если не удается импортировать
                      JSON-файл, сообщите этот ID вашему персональному менеджеру
                      или напишите на csm@xsolla.com.
                    example: af9f3638a16e11ef880da2cd677d2d24
                    type: string
                type: object
          description: Файл был успешно импортирован и находится в обработке.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/connector-422-validation-failed'
      security:
        - basicAuth: []
      servers:
        - url: https://connector.xsolla.com
      summary: Импорт товаров из JSON-файла
      tags:
        - connector-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/admin/project/{project_id}/cart/fill:
    put:
      description: >-
        Заполняет текущую корзину товарами. Если в корзине уже есть товар с
        таким же артикулом, существующий товар будет заменен на переданное
        значение.
      operationId: admin-cart-fill
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/x-user-for-header'
        - $ref: '#/components/parameters/x-user-id-header'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-admin-fill-cart-json-model'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-user'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - basicAuth: []
      summary: Наполнение корзины товарами
      tags:
        - cart-server-side
      x-badges:
        - color: '#95ff80'
          name: Server-side
  /v2/admin/project/{project_id}/cart/{cart_id}/fill:
    put:
      description: >-
        Заполняет корзину товарами по идентификатору корзины. Если в корзине уже
        есть товар с таким же артикулом, существующий товар будет заменен на
        переданное значение.
      operationId: admin-fill-cart-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/x-user-for-header'
        - $ref: '#/components/parameters/x-user-id-header'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-admin-fill-cart-json-model'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-user'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - basicAuth: []
      summary: Наполнение корзины по ID корзины товарами
      tags:
        - cart-server-side
      x-badges:
        - color: '#95ff80'
          name: Server-side
  /v2/merchant/{merchant_id}/projects:
    get:
      description: |-
        Получает список проектов мерчанта.

        <div class="notice">
         <p><strong>Внимание </strong></p><p>Этот метод API не включает в себя path-параметр <code>project_id</code>, поэтому для авторизации вам необходимо использовать ключ API, который действует во всех проектах.</p>
        </div>
      operationId: get-projects
      parameters:
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/merchant_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    has_more: false
                    items:
                      - project_id: 17558
                      - project_id: 17559
                    total_items_count: 2
              schema:
                properties:
                  has_more:
                    example: true
                    type: boolean
                  items:
                    properties:
                      project_id:
                        example: 17558
                        type: integer
                    type: array
                  total_items_count:
                    example: 3
                    type: integer
                type: object
          description: Информация о проектах успешно получена.
        '401':
          description: >-
            Данные для базовой аутентификации не переданы или ошибочны.
            Убедитесь, что использовали базовую аутентификацию и проверьте
            правильность учетных данных.
        '422':
          description: Недопустимые параметры запроса `limit` или `offset`.
      security:
        - basicMerchantAuth: []
      summary: Получение проектов
      tags:
        - common-merchant
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/attribute:
    get:
      description: Получает список атрибутов из проекта для администрирования.
      operationId: admin-get-attribute-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-attribute-list-response'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка атрибутов (admin)
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает атрибут.
      operationId: admin-create-attribute
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-validation-failed'
      security:
        - basicAuth: []
      summary: Создание атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/attribute/{external_id}:
    delete:
      description: >-
        Удаляет атрибут.

        <div class="notice"><strong>Внимание</strong><br><br>Если вы удалите
        атрибут товара, все его данные и связи с товарами будут удалены.</div>
      operationId: delete-attribute
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      responses:
        '204':
          description: Атрибут успешно удален.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает указанный атрибут.
      operationId: admin-get-attribute
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-attribute-not-found'
      security:
        - basicAuth: []
      summary: Получение указанного атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет атрибут.
      operationId: admin-update-attribute
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-update-attribute'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-validation-failed'
      security:
        - basicAuth: []
      summary: Обновление атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/attribute/{external_id}/value:
    delete:
      description: >-
        Удаляет все значения атрибута.

        <div class="notice"><strong>Внимание</strong><br><br>Если вы удалите
        значение атрибута, связь атрибута с товарами будет потеряна. Чтобы
        изменить значение атрибута для товара, используйте метод <a
        href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">Обновление значения атрибута</a> вместо удаления
        значения и создания нового.</div>
      operationId: admin-delete-all-attribute-value
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      responses:
        '204':
          description: Значения атрибутов успешно удалены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
      security:
        - basicAuth: []
      summary: Удаление всех значений атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: >-
        Создает значение атрибута.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество значений атрибута. Значение по умолчанию и
        максимальное значение — <strong>20 значений для каждого
        атрибута</strong>.</div>
      operationId: admin-create-attribute-value
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute-value'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-attribute-value'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
        '404':
          $ref: '#/components/responses/404-attribute-not-found'
        '422':
          $ref: '#/components/responses/422-create-update-attribute-value'
      security:
        - basicAuth: []
      summary: Создание значения атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/attribute/{external_id}/value/{value_external_id}:
    delete:
      description: >-
        Удаляет значение атрибута.

        <div class="notice"><strong>Внимание</strong><br><br>Если вы удалите
        значение атрибута, связь атрибута с товарами будет потеряна. Чтобы
        изменить значение атрибута для товара, используйте метод <a
        href="https://developers.xsolla.com/ru/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">Обновление значения атрибута</a> вместо удаления
        значения и создания нового.</div>
      operationId: admin-delete-attribute-value
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_external_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      responses:
        '204':
          description: Значение атрибута успешно удалено.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
      security:
        - basicAuth: []
      summary: Удаление значения атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет значения атрибута.
      operationId: admin-update-attribute-value
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_external_id-path-param'
        - $ref: '#/components/parameters/external_id-attr-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-attribute-value'
      responses:
        '204':
          description: Значение атрибута успешно обновлено.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
        '404':
          $ref: '#/components/responses/404-attribute-value-not-found'
        '422':
          $ref: '#/components/responses/422-create-update-attribute-value'
      security:
        - basicAuth: []
      summary: Обновление значения атрибута
      tags:
        - attribute-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}:
    get:
      description: >-
        Возвращает оставшееся количество применений кодов. Для фильтрации кодов
        используйте параметр запроса `codes`.


        Для настройки самого ограничения кода перейдите в раздел администратора:

        *
        [Купоны](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-coupons/)
      operationId: get-coupon-code-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/codes-query-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-code-coupon-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Coupon not found:
                  $ref: '#/components/examples/404-coupon-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Получение ограничений для уникальных кодов купонов
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/code/limit/promocode/external_id/{external_id}:
    get:
      description: >-
        Возвращает оставшееся количество применений кодов. Для фильтрации кодов
        используйте `codes`параметр запроса.


        Для настройки самого ограничения перейдите в раздел администратора:

        *
        [Промокоды](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-promo-codes/)
      operationId: get-promo-code-code-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/codes-query-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-code-promo-code-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Promo code not found:
                  $ref: '#/components/examples/404-coupon-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Информация об ограничении на применение промокодов
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/coupon/{external_id}/activate:
    put:
      description: |-
        Активирует акцию с купонами.
         После создания акция с купонами по умолчанию отключена.
         Погашение по акции не будет доступно, пока вы ее не активируете.
         Используйте данный метод, чтобы включить и активировать акцию с купонами.
      operationId: activate-coupon
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Купон успешно активирован.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Активация акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/coupon/{external_id}/code:
    get:
      description: Получает коды купонов.
      operationId: get-coupon-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-coupon-code-list'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Получение кодов купонов
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает код купона.
      operationId: create-coupon-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-coupon-promocode-code'
      responses:
        '201':
          $ref: '#/components/responses/Promotions_201-coupon-promocode-code-created'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-coupon-promocode-same-code-exists
      security:
        - basicAuth: []
      summary: Создание кода купона
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/coupon/{external_id}/code/generate:
    put:
      description: Генерирует коды купонов.
      operationId: generate-coupon-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                count:
                  $ref: '#/components/schemas/Promotions_coupon-generate-count'
              required:
                - count
              type: object
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 10
              schema:
                properties:
                  count:
                    $ref: '#/components/schemas/Promotions_coupon-generate-count'
                type: object
          description: Коды успешно сгенерированы.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Генерация кодов купонов
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/coupon/{external_id}/deactivate:
    put:
      description: |-
        Деактивирует акцию с купонами.
         После создания акция с купонами по умолчанию отключена.
         Погашение по акции не будет доступно, пока вы ее не активируете.
         Используйте данный метод, чтобы выключить и деактивировать акцию с купонами.
      operationId: deactivate-coupon
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Купон успешно деактивирован.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Деактивация акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/daily_chain:
    get:
      description: >-
        Получает список ежедневных наград для администрирования. 

        <div class="notice"><strong>Примечание</strong><br><br>Метод возвращает
        список элементов с учетом пагинации. <strong>Максимальное количество
        элементов в ответе — 50 (установлено по умолчанию)</strong>. Чтобы
        получить доступ к следующим элементам списка, используйте параметры
        `limit` и `offset`. Например, при вызове метода с параметрами `limit =
        25` и `offset = 100` вернется 25 элементов, начиная со 101-го в общем
        списке.</div>
      operationId: admin-get-daily-chains
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/enabled-query-param'
        - $ref: '#/components/parameters/is_expired-daily-chain-query-param'
        - $ref: '#/components/parameters/type-daily-chain-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-list-daily-chains'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка ежедневных наград
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает ежедневную награду.
      operationId: admin-create-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-daily-chain'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-daily-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-admin-create-error-list'
      security:
        - basicAuth: []
      summary: Создание ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}:
    delete:
      description: Удаляет определенную ежедневную награду.
      operationId: admin-delete-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      responses:
        '204':
          content: {}
          description: Ежедневная награда успешно удалена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
      security:
        - basicAuth: []
      summary: Удаление ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Возвращает определенную ежедневную награду для администрирования.
      operationId: admin-get-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-daily-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
      security:
        - basicAuth: []
      summary: Получение ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет определенную ежедневную награду.
      operationId: admin-update-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-daily-chain'
      responses:
        '204':
          content: {}
          description: Ежедневная награда успешно обновлена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
        '422':
          $ref: '#/components/responses/422-admin-update-error-list'
      security:
        - basicAuth: []
      summary: Обновление ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/reset:
    post:
      description: >-
        Сбрасывает прогресс для всех пользователей в ежедневной награде.
        Применяется только к ежедневным наградам с типом `rolling`.
      operationId: admin-reset-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      responses:
        '204':
          content: {}
          description: Ежедневная награда сброшена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
      security:
        - basicAuth: []
      summary: Сброс ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/daily_chain/id/{daily_chain_id}/toggle:
    put:
      description: Включает или отключает ежедневную награду.
      operationId: admin-toggle-daily-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      responses:
        '204':
          content: {}
          description: Ежедневная награда отключена или включена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
      security:
        - basicAuth: []
      summary: Переключение ежедневной награды
      tags:
        - daily-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/entitlement/grant:
    post:
      description: >-
        Дает пользователю право владения.


        <div class="notice"><strong>Внимание</strong><br><br>Могут быть
        предоставлены только игровые ключи или игры для DRM-free-платформ.</div>
      operationId: grant-entitlement-admin
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        content:
          application/json:
            schema:
              example:
                code: AAAA-BBBB-CCCC-DDDD
                drm:
                  sku: com.xsolla.key_1
                game:
                  sku: com.xsolla.game_1
                mode: default
                user_country: US
                user_external_id: user-external-id
              properties:
                code:
                  description: Игровой ключ.
                  example: AAAA-BBBB-CCCC-DDDD
                  nullable: true
                  type: string
                drm:
                  description: Объект со свойствами DRM.
                  example:
                    drm:
                      sku: com.xsolla.key_1
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_drm_sku'
                  required:
                    - sku
                  type: object
                game:
                  description: Объект со свойствами игры.
                  example:
                    game:
                      sku: com.xsolla.game_1
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_game_sku'
                  required:
                    - sku
                  type: object
                mode:
                  description: >-
                    Какой тип прав владения должен быть предоставлен. Если
                    параметру присвоено значение `sandbox`, пользователю будет
                    предоставлено право владения в режиме тестового окружения.
                    Если для параметра установлено значение `default`,
                    пользователю будет предоставлено право владения в режиме
                    боевого окружения.
                  enum:
                    - default
                    - sandbox
                  example: default
                  type: string
                user_country:
                  description: Страна пользователя.
                  example: US
                  nullable: true
                  type: string
                user_external_id:
                  description: Уникальный идентификатор пользователя.
                  example: user-external-id
                  type: string
              required:
                - user_external_id
                - game
                - drm
                - mode
              type: object
        required: true
      responses:
        '200':
          description: Право владения предоставлено.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '404':
          content:
            application/json:
              examples:
                Game code not found:
                  $ref: '#/components/examples/404-game-code-not-found'
                Game not found:
                  value:
                    errorCode: 4604
                    errorMessage: '[0401-4604]: Game not found.'
                    statusCode: 404
                    transactionId: transaction id
              schema:
                properties:
                  errorCode:
                    example: 4603
                    type: integer
                  errorMessage:
                    example: '[0401-4603]: Game code not found.'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                  transactionId:
                    example: x-x-x-x-transactionId-mock-x-x-x
                    type: string
                type: object
          description: >-
            Игровой ключ не найден. Убедитесь, что верно указали `code` и
            `project_id`.
        '422':
          content:
            application/json:
              examples:
                DRM is not DRM free:
                  $ref: '#/components/examples/422-drm-is-not-drm-free'
                User already has entitlement:
                  $ref: '#/components/examples/422-user-already-has-entitlement'
              schema:
                properties:
                  errorCode:
                    example: 5103
                    type: integer
                  errorMessage:
                    example: '[0401-5103]: Selected drm is not drmfree.'
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                  transactionId:
                    example: x-x-x-x-transactionId-mock-x-x-x
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Предоставление права владения (admin)
      tags:
        - game-keys-entitlement
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/entitlement/revoke:
    post:
      description: >-
        Отзывает право владения у пользователя.


        <div class="notice"><strong>Внимание</strong><br><br>Могут быть отозваны
        только игровые ключи или игры для DRM-free-платформ.</div>
      operationId: revoke-entitlement-admin
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        content:
          application/json:
            schema:
              example:
                drm:
                  sku: com.xsolla.key_1
                game:
                  sku: com.xsolla.game_1
                mode: default
                user_external_id: user-external-id
              properties:
                drm:
                  description: Объект со свойствами DRM.
                  example:
                    drm:
                      sku: com.xsolla.key_1
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_drm_sku'
                  required:
                    - sku
                  type: object
                game:
                  description: Объект со свойствами игры.
                  example:
                    game:
                      sku: com.xsolla.game_1
                  properties:
                    sku:
                      $ref: '#/components/schemas/Game-Keys_game_sku'
                  required:
                    - sku
                  type: object
                mode:
                  description: >-
                    Какой тип прав владения должен быть отозван. Если параметру
                    присвоено значение `sandbox`, у пользователя будет отозвано
                    право в режиме тестового окружения. Если для параметра
                    установлено значение `default`, у пользователя будет
                    отозвано право в режиме боевого окружения.
                  enum:
                    - default
                    - sandbox
                  example: default
                  type: string
                user_external_id:
                  description: Уникальный идентификатор пользователя.
                  example: user-external-id
                  type: string
              required:
                - user_external_id
                - game
                - drm
                - mode
              type: object
        required: true
      responses:
        '204':
          description: Отозвано успешно.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '422':
          content:
            application/json:
              examples:
                DRM is not DRM free:
                  value:
                    errorCode: 5103
                    errorMessage: '[0401-5103]: Selected drm is not drmfree.'
                    statusCode: 422
                    transactionId: transaction id
              schema:
                properties:
                  errorCode:
                    example: 5103
                    type: integer
                  errorMessage:
                    example: '[0401-5103]: Selected drm is not drmfree.'
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                  transactionId:
                    example: x-x-x-x-transactionId-mock-x-x-x
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Отзыв права владения (admin)
      tags:
        - game-keys-entitlement
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle:
    get:
      description: >-
        Получает список бандлов в рамках проекта для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-bundle-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка бандлов
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает бандл.
      operationId: admin-create-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Bundles_bundle'
      responses:
        '201':
          $ref: '#/components/responses/Bundles_201-admin-create-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Bundles_422-invalid-request'
      security:
        - basicAuth: []
      summary: Создание бандла
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle/group/external_id/{external_id}:
    get:
      description: >-
        Получает список бандлов в рамках группы для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-bundle-list-in-group-by-external-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list-in-group'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка бандлов по указанному External ID группы
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle/group/id/{group_id}:
    get:
      description: >-
        Получает список бандлов в рамках группы для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-bundle-list-in-group-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/group_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle-list-in-group'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка бандлов по указанному ID группы
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}:
    delete:
      description: Удаляет бандл.
      operationId: admin-delete-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-delete-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление бандла
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает бандл в рамках проекта для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-admin-get-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение бандла
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет бандл.
      operationId: admin-update-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Bundles_bundle'
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-update-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Bundles_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление бандла
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}/hide:
    put:
      description: Скрывает бандл в каталоге.
      operationId: admin-hide-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-hide-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Скрытие бандла в каталоге
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/bundle/sku/{sku}/show:
    put:
      description: Показывает бандл в каталоге.
      operationId: admin-show-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
      responses:
        '204':
          $ref: '#/components/responses/Bundles_204-admin-show-bundle'
        '401':
          $ref: '#/components/responses/Bundles_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Отображение бандла в каталоге
      tags:
        - bundles-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game:
    get:
      description: >-
        Получает список игр в рамках проекта для администрирования.

        Игра состоит из игровых ключей, которые могут быть приобретены
        пользователем.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-game-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-games-list'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка игр (admin)
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает игру в проекте.
      operationId: admin-create-game
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          content:
            application/json:
              examples:
                response:
                  value:
                    item_id: 101
                    sku: com.xsolla.game_1
              schema:
                properties:
                  item_id:
                    example: 101
                    type: integer
                  sku:
                    example: com.xsolla.game_1
                    type: string
                type: object
          description: Игра успешно создана.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
      security:
        - basicAuth: []
      summary: Создание игры
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/id/{item_id}:
    delete:
      description: Удаляет игру в проекте по ID.
      operationId: admin-delete-game-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      responses:
        '204':
          description: Игра успешно удалена.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление игры по ID
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает игру для администрирования.

        Игра состоит из игровых ключей, которые могут быть приобретены
        пользователем.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-game-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-game-by-sku'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with id = 1 not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with id = 1 not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игра не найдена.
      security:
        - basicAuth: []
      summary: Получение игры по ID (admin)
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет игру в проекте по ID.
      operationId: admin-update-game-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          description: Игра успешно обновлена.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with id = 1 not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with id = 1 not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игра не найдена.
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление игры по ID
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/delete/id/{item_id}:
    delete:
      description: Удаляет все коды по ID игрового ключа.
      operationId: admin-delete-codes-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Удаление кодов по ID
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/delete/sku/{item_sku}:
    delete:
      description: Удаляет все коды по артикулу игрового ключа.
      operationId: admin-delete-codes-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Удаление кодов
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/request/id/{item_id}:
    get:
      description: Получает определенное количество кодов по ID игрового ключа.
      operationId: admin-get-codes-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/quantity-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Получение кодов по ID
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/request/sku/{item_sku}:
    get:
      description: Получает определенное количество кодов по артикулу игрового ключа.
      operationId: admin-get-codes-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_email-query-param'
        - $ref: '#/components/parameters/quantity-query-param'
        - $ref: '#/components/parameters/reason-query-param'
        - $ref: '#/components/parameters/region_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-codes'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Получение кодов
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/upload/id/{item_id}:
    post:
      description: Загружает коды по ID игрового ключа.
      operationId: admin-upload-codes-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_id-path-param'
      requestBody:
        content:
          multipart/form-data:
            schema:
              example:
                file: keys.txt
                region_id: 1
              properties:
                file:
                  description: Файл с кодами.
                  format: binary
                  type: string
                region_id:
                  description: ID региона.
                  type: integer
              required:
                - file
              type: object
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Загрузка кодов по ID
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/upload/session/{session_id}:
    get:
      description: Получает информацию о сеансе загрузки кодов.
      operationId: admin-get-codes-session
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: ID сеанса.
          in: path
          name: session_id
          required: true
          schema:
            default: fc7105b6e8ee01339582970b37697242
            type: string
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          description: Сеанс загрузки кодов не найден.
      security:
        - basicAuth: []
      summary: Получение информации о сеансе загрузки кодов
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/key/upload/sku/{item_sku}:
    post:
      description: Загружает коды по артикулу игрового ключа.
      operationId: admin-upload-codes-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          multipart/form-data:
            schema:
              example:
                file: keys.txt
                region_id: 1
              properties:
                file:
                  description: Файл с кодами.
                  format: binary
                  type: string
                region_id:
                  description: ID региона.
                  type: integer
              required:
                - file
              type: object
        required: true
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-session-information'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ или регион не найден.
      security:
        - basicAuth: []
      summary: Загрузка кодов
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/game/sku/{item_sku}:
    delete:
      description: Удаляет игру в проекте по артикулу.
      operationId: admin-delete-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          description: Игра успешно удалена.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление игры по артикулу
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает игру для администрирования.

        Игра состоит из игровых ключей, которые могут быть приобретены
        пользователем.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-admin-get-game-by-sku'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игра не найдена.
      security:
        - basicAuth: []
      summary: Получение игры (admin)
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет игру в проекте по артикулу.
      operationId: admin-update-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Game-Keys_create-update-game-model'
      responses:
        '201':
          description: Игра успешно обновлена.
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игра не найдена.
        '422':
          $ref: '#/components/responses/Game-Keys_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление игры по артикулу
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}:
    delete:
      description: >-
        Удаляет ограничение на количество предзаказа товара. 


        Pre-Order limit API позволяет продавать товар в ограниченном количестве.
        Для настройки самого предзаказа перейдите в раздел Admin желаемого
        товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Алиасы для данного эндпоинта:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      operationId: remove-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          application/json:
            example:
              quantity: 100000
            schema:
              properties:
                quantity:
                  description: Количество для удаления.
                  type: integer
              required:
                - quantity
              type: object
      responses:
        '204':
          description: Указанное количество успешно удалено из лимита предзаказа.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Уменьшение лимита предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Возвращает ограничение на предзаказ товара.


        Pre-Order limit API позволяет вам продавать товар в ограниченном
        количестве. Для настройки самого предварительного заказа перейдите в
        раздел администратора модуля нужного товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Aliases для этой конечной точки:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      operationId: get-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    available: 431
                    is_pre_order_limit_enabled: true
                    item_id: 1
                    reserved: 13
                    sku: com.xsolla.item_1
                    sold: 556
              schema:
                properties:
                  available:
                    example: 431
                    type: integer
                  is_pre_order_limit_enabled:
                    example: true
                    type: boolean
                  item_id:
                    example: 1
                    type: integer
                  reserved:
                    example: 13
                    type: integer
                  sku:
                    example: com.xsolla.item_1
                    type: string
                  sold:
                    example: 556
                    type: integer
                type: object
          description: Информация о лимите предзаказа товара успешно получена.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Получение информации о лимите предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: >-
        Добавляет количество к ограничению на предзаказ товара.


        Pre-Order limit API позволяет вам продавать товар в ограниченном
        количестве. Для настройки самого предварительного заказа перейдите в
        раздел администратора модуля нужного товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Aliases для этой конечной точки:

        */v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      operationId: add-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          application/json:
            example:
              quantity: 100000
            schema:
              properties:
                quantity:
                  description: Количество для добавления.
                  type: integer
              required:
                - quantity
              type: object
      responses:
        '201':
          description: Указанное количество успешно добавлено к лимиту предзаказа.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Увеличение лимита предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Устанавливает ограничение на количество товара для предварительного
        заказа.


        Pre-Order limit API позволяет вам продавать товар в ограниченном
        количестве. Для настройки самого предварительного заказа перейдите в
        раздел администратора модуля нужного товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Aliases для этой конечной точки:

        * /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}
      operationId: set-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          application/json:
            example:
              quantity: 100000
            schema:
              properties:
                quantity:
                  description: Количество для установки.
                  type: integer
              required:
                - quantity
              type: object
      responses:
        '204':
          description: Количество для лимита предзаказа успешно установлено.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Установка/обновление лимита предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/all:
    delete:
      description: >-
        Удаляет все ограничения по количеству товара, предусмотренные для
        предварительного заказа.


        Pre-Order limit API позволяет вам продавать товар в ограниченном
        количестве. Для настройки самого предварительного заказа перейдите в
        раздел администратора модуля нужного товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Aliases для этой конечной точки:

        *
        /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/all
      operationId: remove-all-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          description: Лимит успешно удален.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Обнуление лимита предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/pre_order/limit/item/sku/{item_sku}/toggle:
    put:
      description: >-
        Включает/отключает лимит предзаказа товара. 


        API лимитов для предзаказов позволяет продавать товар в ограниченном
        количестве. Для настройки самого предзаказа перейдите в раздел Admin
        желаемого товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)


        Алиасы для данного метода:

        *
        /v2/project/{project_id}/admin/items/pre_order/limit/item/id/{item_id}/toggle
      operationId: toggle-pre-order-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        content:
          application/json:
            example:
              is_pre_order_limit_enabled: true
            schema:
              properties:
                is_pre_order_limit_enabled:
                  type: boolean
              required:
                - is_pre_order_limit_enabled
              type: object
      responses:
        '204':
          description: Лимит отключен/включен.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: Товар не найден.
      security:
        - basicAuth: []
      summary: Включение/отключение лимита предзаказа товара
      tags:
        - common-pre-orders
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/upsell:
    get:
      description: >-
        Возвращает информацию об апселле в проекте: включен или выключен апселл,
        какой тип апселла используется, а также список товаров, используемых в
        апселле.
      operationId: get-upsell-configurations-for-project-admin
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                upsell:
                  summary: Проект с апселлом
                  value:
                    - is_enabled: true
                      items:
                        - item_id: 1
                          name:
                            de: Name des Artikels
                            en: Item's name
                          sku: com.xsolla.booster_mega_1
                          type: virtual_good
                        - bundle_type: standard
                          item_id: 2
                          name:
                            de: Name des Artikels
                            en: Item's name
                          sku: com.xsolla.booster_mega_2
                          type: bundle
                        - item_id: 3
                          name:
                            en: Mega game
                          sku: com.xsolla.mega_game_1
                          type: unit
                          unit_items:
                            - drm_name: Steam
                              drm_sku: steam_key_1
                              item_id: 4
                              name:
                                en: Mega game steam
                              sku: com.xsolla.mega_game_steam_1
                          unit_type: game
                      type: fixed_list
              schema:
                items:
                  properties:
                    is_enabled:
                      description: Используется ли апселл в проекте.
                      example: true
                      type: boolean
                    items:
                      description: >-
                        Список артикулов товаров, которые входят в апселл в
                        проекте.
                      example:
                        - item_id: 1
                          name:
                            de: Name des Artikels
                            en: Item's name
                          sku: com.xsolla.booster_mega_1
                          type: virtual_good
                      items:
                        properties:
                          bundle_type:
                            $ref: '#/components/schemas/bundle_type'
                          item_id:
                            $ref: '#/components/schemas/item_id'
                          name:
                            $ref: '#/components/schemas/name-localization-object'
                          sku:
                            $ref: '#/components/schemas/sku'
                          type:
                            $ref: '#/components/schemas/item_type'
                          unit_items:
                            description: Платформы публикации игры.
                            items:
                              description: >-
                                Игра, опубликованная на определенной платформе
                                (steam, gog и т.д.).
                              properties:
                                drm_name:
                                  $ref: '#/components/schemas/drm_name'
                                drm_sku:
                                  $ref: '#/components/schemas/drm_sku'
                                item_id:
                                  $ref: '#/components/schemas/item_id'
                                name:
                                  $ref: >-
                                    #/components/schemas/name-localization-object
                                sku:
                                  $ref: '#/components/schemas/sku'
                                type:
                                  $ref: '#/components/schemas/item_type'
                              type: object
                            type: array
                          unit_type:
                            $ref: '#/components/schemas/unit_type'
                        type: object
                      type: array
                    type:
                      description: Тип апселла.
                      enum:
                        - fixed_list
                        - most_sellable
                        - only_promotions
                      example: fixed_list
                      type: string
                  type: object
                type: array
          description: >-
            Список деталей настройки и товаров, которые используются для апселла
            в проекте.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение информации об апселле в проекте
      tags:
        - upsell-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает апселл в проекте.
      operationId: post-upsell
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-upsell'
      responses:
        '202':
          description: Апселл создан в проекте.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '404':
          $ref: '#/components/responses/Upsell-404-item-not-found'
        '422':
          $ref: '#/components/responses/Upsell-422-invalid-request'
      security:
        - XsollaLoginUserJWT: []
      summary: Создание апселла
      tags:
        - upsell-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет апселл в проекте.
      operationId: put-upsell
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-upsell'
      responses:
        '202':
          description: Апселл обновлен в проекте.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '404':
          $ref: '#/components/responses/Upsell-404-item-not-found'
        '422':
          $ref: '#/components/responses/Upsell-422-invalid-request'
      security:
        - XsollaLoginUserJWT: []
      summary: Обновление апселла
      tags:
        - upsell-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/upsell/{toggle}:
    put:
      description: 'Меняет статус апселла в проекте: активирует или деактивирует.'
      operationId: put-upsell-toggle-active-inactive
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: Статус активации.
          in: path
          name: toggle
          required: true
          schema:
            example: activate
            type: string
      responses:
        '202':
          description: Апселл в проекте был активирован или деактивирован.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Активация/деактивация апселла в проекте
      tags:
        - upsell-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/value_points:
    get:
      description: Получает список призовых баллов для проекта администрирования.
      operationId: admin-get-value-points-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-value-points'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка призовых баллов
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает призовые баллы, которые выдаются за покупку товаров в каталоге.
      operationId: admin-create-value-points
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-value-point'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-value-point'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-admin-create-update-rc-vp-invalid-request'
      security:
        - basicAuth: []
      summary: Создание призовых баллов
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/value_points/sku/{item_sku}:
    delete:
      description: Удаляет призовые баллы, идентифицированные по артикулу товара.
      operationId: admin-delete-value-point
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          content: {}
          description: Призовые баллы были успешно удалены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление призовых баллов
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает призовые баллы по артикулу для проекта администрирования.
      operationId: admin-get-value-point
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-value-point'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение призовых баллов
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет призовые баллы, идентифицированные по артикулу.
      operationId: admin-update-value-point
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-value-point'
      responses:
        '204':
          content: {}
          description: Призовые баллы были успешно обновлены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-admin-create-update-rc-vp-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление призовых баллов
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_currency:
    get:
      description: >-
        Получает список виртуальных валют в рамках проекта для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-currencies-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currencies
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка виртуальных валют
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает виртуальную валюту.
      operationId: admin-create-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Создание виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_currency/package:
    get:
      description: >-
        Получает список пакетов виртуальной валюты в рамках проекта для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-currency-packages-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency-packages
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка пакетов виртуальной валюты (admin)
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает пакет виртуальной валюты.
      operationId: admin-create-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency-package
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Создание пакета виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_currency/package/sku/{item_sku}:
    delete:
      description: Удаляет пакет виртуальной валюты.
      operationId: admin-delete-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          description: Пакет виртуальной валюты успешно обновлен.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление пакета виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает пакет виртуальной валюты в рамках проекта для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency-package
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение пакета виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет пакет виртуальной валюты.
      operationId: admin-update-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency-package
      responses:
        '204':
          description: Виртуальный предмет успешно обновлен.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление пакета виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_currency/sku/{virtual_currency_sku}:
    delete:
      description: Удаляет виртуальную валюту.
      operationId: admin-delete-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      responses:
        '204':
          content: {}
          description: Виртуальная валюта успешно удалена.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает виртуальную валюту в рамках проекта для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-currency
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
      security:
        - basicAuth: []
      summary: Получение виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет виртуальную валюту.
      operationId: admin-update-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-currency
      responses:
        '204':
          content: {}
          description: Виртуальная валюта успешно обновлена.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление виртуальной валюты
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_items:
    get:
      description: >-
        Получает список виртуальных предметов в рамках проекта для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-items-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка виртуальных предметов
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает виртуальный предмет.
      operationId: admin-create-virtual-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-item
      responses:
        '201':
          $ref: '#/components/responses/Virtual-Items-Currency_201-created'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Создание виртуального предмета
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_items/group/external_id/{external_id}:
    get:
      description: >-
        Получает список виртуальных предметов в рамках группы для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-items-list-by-group-external-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items-by-group
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка виртуальных предметов по указанному External ID группы
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_items/group/id/{group_id}:
    get:
      description: >-
        Получает список виртуальных предметов в рамках группы для
        администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-items-list-by-group-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/group_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-admin-get-virtual-items-by-group
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка виртуальных предметов по указанному ID группы
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/virtual_items/sku/{item_sku}:
    delete:
      description: Удаляет виртуальный предмет.
      operationId: admin-delete-virtual-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          content: {}
          description: Виртуальный предмет успешно удален.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление виртуального предмета
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает виртуальный предмет в рамках проекта для администрирования.


        <div class="note"><b>Примечание</b><br><br>Не используйте данный метод
        для построения каталога магазина.</div>
      operationId: admin-get-virtual-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-admin-get-item'
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение виртуального предмета
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет виртуальный предмет.
      operationId: admin-update-virtual-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Virtual-Items-Currency_admin-create-virtual-item
      responses:
        '204':
          content: {}
          description: Виртуальный предмет успешно обновлен.
        '401':
          $ref: '#/components/responses/Virtual-Items-Currency_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Virtual-Items-Currency_422-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление виртуального предмета
      tags:
        - virtual-items-currency-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards:
    delete:
      description: Удаляет призовые баллы со ВСЕХ товаров.
      operationId: admin-delete-items-value-point-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_point_sku-path-param'
      responses:
        '204':
          content: {}
          description: Призовые баллы для товаров были успешно удалены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление призовых баллов с товаров
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает список всех товаров с призовыми баллами для проекта
        администрирования.
      operationId: admin-get-items-value-point-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_point_sku-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-list-value-point-rewards'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка товаров с призовыми баллами
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    patch:
      description: >-
        Частично обновляет количество призовых баллов для одного или нескольких
        товаров по артикулам этих товаров. Пользователи получают призовые баллы
        после покупки этих товаров.


        Принципы обновления призовых баллов:
          * Если у товара еще нет призовых баллов, отправка ненулевого значения в поле `amount` создаст их.
          * Если у товара уже есть призовые баллы, отправка ненулевого значения в поле `amount` обновит их.
          * Если в поле `amount` передано значение 0, существующие призовые баллы для этого товара будут удалены.

        В отличие от метода `PUT` ([Настройка призовых баллов для
        товаров](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-set-items-value-point-reward/)),
        этот метод `PATCH` не перезаписывает все ранее установленные призовые
        баллы для товаров в проекте, а обновляет только указанные.


        В одном запросе можно обновить до 100 товаров. В одном запросе нельзя
        передавать одинаковые артикулы товаров.
      operationId: admin-patch-items-value-point-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_point_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/set-item-value-point-reward-for-patch'
      responses:
        '204':
          content: {}
          description: Призовые баллы для товаров были успешно обновлены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/sellable-item-by-sku_404'
      security:
        - basicAuth: []
      summary: 'Частичное обновление призовых баллов для товаров '
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Присваивает призовые баллы одному или нескольким товарам по артикулу.
        Пользователи получают призовые баллы после покупки этих товаров.


        Обратите внимание, что этот запрос PUT перезаписывает все ранее
        установленные призовые баллы для товаров в проекте.


        Чтобы избежать непреднамеренного удаления призовых баллов, включайте все
        товары и соответствующие им значения в каждый запрос PUT.


        Если вы хотите обновить призовые баллы только для определенного товара,
        сохранив значения призовых баллов для других товаров, вам следует
        получить текущий набор призовых баллов с помощью запроса GET, изменить
        значения призовых баллов для желаемого товара, а затем отправить
        измененный набор призовых баллов обратно с обновленными значениями
        призовых баллов для конкретного товара.
      operationId: admin-set-items-value-point-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/value_point_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/set-item-value-point-reward'
      responses:
        '204':
          content: {}
          description: Призовые баллы для товаров были успешно обновлены.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/sellable-item-by-sku_404'
      security:
        - basicAuth: []
      summary: Настройка призовых баллов для товаров
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/offer_chain:
    get:
      description: >-
        Возвращает список цепочек предложений для администрирования.

        <div class="notice"><strong>Внимание</strong><br><br> Все проекты имеют
        ограничение на количество элементов, возвращаемых в одном ответе.
        Максимальное значение — <strong>10 элементов в ответе</strong>. Чтобы
        получить больше данных, используйте query-параметры <code>limit</code> и
        <code>offset</code> для пагинации.</div>
      operationId: admin-get-offer-chains
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/enabled-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-list-offer-chains'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка цепочек предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает цепочку предложений.
      operationId: admin-create-offer-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-offer-chain'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-offer-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-create-error-list'
      security:
        - basicAuth: []
      summary: Создание цепочки предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}:
    delete:
      description: >-
        Удаляет конкретную цепочку предложений.


        После удаления цепочки:<ul><li>Все уже полученные пользователями награды
        сохраняются.</li><li>Непройденные уровни становятся недоступны, и
        получить награды за них больше нельзя.</li></ul>


        Удаление цепочки необратимо и не сохраняет прогресс пользователя, в
        отличие от временного отключения цепочки с помощью метода <a
        href="/api/shop-builder/operation/admin-toggle-offer-chain">Переключение
        цепочки предложений</a>.
      operationId: admin-delete-offer-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
      responses:
        '204':
          content: {}
          description: Цепочка предложений успешно удалена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-not-found'
      security:
        - basicAuth: []
      summary: Удаление цепочки предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Возвращает конкретную цепочку предложений для администрирования.
      operationId: admin-get-offer-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-offer-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-not-found'
      security:
        - basicAuth: []
      summary: Получение цепочки предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет конкретную цепочку предложений.
      operationId: admin-update-offer-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-offer-chain'
      responses:
        '204':
          content: {}
          description: Цепочка предложений успешно обновлена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-not-found'
        '422':
          $ref: '#/components/responses/422-update-error-list'
      security:
        - basicAuth: []
      summary: Обновление цепочки предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/offer_chain/id/{offer_chain_id}/toggle:
    put:
      description: >-
        Включает или отключает цепочку предложений.


        При отключении цепочки пользователи теряют доступ к ней, но их прогресс
        сохраняется.


        После повторного включения цепочки пользователь может продолжить
        прохождение с того уровня, на котором остановился.
      operationId: admin-toggle-offer-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
      responses:
        '204':
          content: {}
          description: Цепочка предложений была отключена/включена.
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-not-found'
      security:
        - basicAuth: []
      summary: Переключение цепочки предложений
      tags:
        - offer-chain-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promocode/{external_id}/activate:
    put:
      description: |-
        Активирует акцию с промокодами.

         После создания акция с промокодами по умолчанию отключена.
         Погашение по акции не будет доступно, пока вы ее не активируете.
         Используйте данный метод, чтобы включить и активировать акцию с промокодами.
      operationId: activate-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Промокод успешно активирован.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Активация акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promocode/{external_id}/code:
    get:
      description: Получает коды акции с промокодами.
      operationId: get-promocode-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-promocode-code-list'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Получение кодов акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает код для акции с промокодами.
      operationId: create-promo-code-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-coupon-promocode-code'
      responses:
        '201':
          $ref: '#/components/responses/Promotions_201-coupon-promocode-code-created'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-coupon-promocode-same-code-exists
      security:
        - basicAuth: []
      summary: Создание кода для акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promocode/{external_id}/code/generate:
    put:
      description: Генерирует коды для акции с промокодами.
      operationId: generate-promo-code-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                count:
                  $ref: '#/components/schemas/Promotions_coupon-generate-count'
              required:
                - count
              type: object
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 10
              schema:
                properties:
                  count:
                    $ref: '#/components/schemas/Promotions_coupon-generate-count'
                type: object
          description: Коды успешно сгенерированы.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Генерация кодов для акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promocode/{external_id}/deactivate:
    put:
      description: |-
        Деактивирует акцию с промокодами.

         После создания акция с промокодами по умолчанию отключена.
         Погашение по акции не будет доступно, пока вы ее не активируете.
         Используйте данный метод, чтобы выключить и деактивировать акцию с промокодами.
      operationId: deactivate-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Купон успешно деактивирован.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Деактивация акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promotion/{promotion_id}/activate:
    put:
      description: Активирует акцию.
      operationId: activate-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '204':
          description: Акция успешно активирована.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Promotions_422-activate-deactivate-promotion'
      security:
        - basicAuth: []
      summary: Активация акции
      tags:
        - promotions-common
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/promotion/{promotion_id}/deactivate:
    put:
      description: Деактивирует акцию.
      operationId: deactivate-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '204':
          description: Акция успешно деактивирована.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Promotions_422-activate-deactivate-promotion'
      security:
        - basicAuth: []
      summary: Деактивация акции
      tags:
        - promotions-common
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/region:
    get:
      description: |-
        Получает список регионов.

         Вы можете использовать регион для управления вашими региональными ограничениями.
      operationId: admin-get-regions
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-regions-list'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка регионов
      tags:
        - common-regions
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: |-
        Создает регион.

         Вы можете использовать регион для управления вашими региональными ограничениями.
      operationId: admin-create-region
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-region'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Создание региона
      tags:
        - common-regions
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/region/{region_id}:
    delete:
      description: Удаляет определенный регион.
      operationId: admin-delete-region
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-delete-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
      security:
        - basicAuth: []
      summary: Удаление региона
      tags:
        - common-regions
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: |-
        Получает определенный регион.

         Вы можете использовать регион для управления вашими региональными ограничениями.
      operationId: admin-get-region
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
      security:
        - basicAuth: []
      summary: Получение региона
      tags:
        - common-regions
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: |-
        Обновляет определенный регион.

         Вы можете использовать регион для управления вашими региональными ограничениями.
      operationId: admin-update-region
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/region_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-update-region'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-update-region'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-region-not-found'
      security:
        - basicAuth: []
      summary: Обновление региона
      tags:
        - common-regions
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/activate:
    put:
      description: >-
        Активирует уникальное акционное предложение по каталогу.

        Созданное уникальное акционное предложение каталога по умолчанию
        отключено.

        Оно не может быть погашено до тех пор, пока вы его не активируете.

        Используйте этот эндпоинт для включения и активации акции с купонами.
      operationId: activate-unique-catalog-offer
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Уникальное предложение по каталогу было успешно активировано.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Активация уникального акционного предложения по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code:
    get:
      description: Получает уникальные коды предложений по каталогу.
      operationId: get-unique-catalog-offer-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-unique-catalog-offer-code-list'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Получение уникальных кодов предложений по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает уникальный код предложения по каталогу.
      operationId: create-unique-catalog-offer-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-coupon-promocode-code'
      responses:
        '201':
          $ref: '#/components/responses/Promotions_201-coupon-promocode-code-created'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-coupon-promocode-same-code-exists
      security:
        - basicAuth: []
      summary: Создание уникального кода предложения по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/code/generate:
    put:
      description: Генерирует уникальные коды предложений по каталогу.
      operationId: generate-unique-catalog-offer-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                count:
                  $ref: '#/components/schemas/Promotions_coupon-generate-count'
              required:
                - count
              type: object
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    count: 10
              schema:
                properties:
                  count:
                    $ref: '#/components/schemas/Promotions_coupon-generate-count'
                type: object
          description: Коды были успешно сгенерированы.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Генерация уникальных кодов предложений по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/unique_catalog_offer/{external_id}/deactivate:
    put:
      description: |-
        Отключает уникальное акционное предложение по каталогу.
        Созданное уникальное акционное предложение по умолчанию отключено.
        Оно не может быть погашено, пока вы его не активируете.
        Используйте этот эндпоинт для отключения и деактивации акции с купонами.
      operationId: deactivate-unique-catalog-offer
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Уникальное предложение по каталогу было успешно деактивировано.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-admin-promotion-error'
      security:
        - basicAuth: []
      summary: Отключите уникальное акционное предложение по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/attribute/rule:
    get:
      description: Получает все правила, применяемые к атрибутам пользователя.
      operationId: get-filter-rules
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/is_enabled-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    has_more: true
                    items:
                      - attribute_conditions:
                          - attribute: race
                            can_be_missing: false
                            operator: eq
                            type: string
                            value: ork
                        is_enabled: true
                        is_satisfied_for_unauth: false
                        items:
                          - item_id: 1
                            name: Ork Armor
                            sku: com.xsolla.ork_armor_1
                            type: virtual_good
                          - bundle_type: standard
                            item_id: 2
                            name: Potion pack
                            sku: com.xsolla.potion_pack_1
                            type: bundle
                        name: Ork race armor rule
                        rule_id: 1
                    total_items_count: 20
              schema:
                properties:
                  has_more:
                    description: Существует ли другая страница с правилами.
                    type: boolean
                  items:
                    items:
                      $ref: '#/components/schemas/user-attribute_personalized-catalog'
                    type: array
                  total_items_count:
                    description: Общее количество правил.
                    type: number
                type: object
          description: Правила успешно получены.
        '401':
          $ref: '#/components/responses/Common_401-complex'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
      security:
        - basicAuth: []
      summary: Получение списка правил фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает правило для пользовательских атрибутов.
      operationId: create-filter-rule
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/personalized-catalog_create-update-body'
      responses:
        '201':
          content:
            application/json:
              examples:
                response:
                  value:
                    rule_id: 1
              schema:
                properties:
                  rule_id:
                    description: ID правила.
                    type: number
                type: object
          description: Правило успешно создано.
        '401':
          $ref: '#/components/responses/Common_401-complex'
        '422':
          $ref: '#/components/responses/Common_422-body-validation'
      security:
        - basicAuth: []
      summary: Создание правила фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/attribute/rule/all:
    get:
      description: >-
        Получает список всех правил каталога для поиска на стороне клиента.

        <div class="notice"><strong>Внимание</strong><br><br>Возвращает только
        ID правила, имя и is_enabled</div>
      operationId: get-all-filter-rules
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    items:
                      - is_enabled: true
                        is_satisfied_for_unauth: false
                        name: Ork race armor rule
                        rule_id: 1
                      - is_enabled: false
                        is_satisfied_for_unauth: false
                        name: Age
                        rule_id: 2
              schema:
                properties:
                  items:
                    items:
                      $ref: >-
                        #/components/schemas/user-attribute_personalized-catalog_all
                    type: array
                type: object
          description: Правила успешно получены.
        '401':
          $ref: '#/components/responses/Common_401-complex'
        '403':
          $ref: '#/components/responses/403-auth-header-not-sent'
      security:
        - basicAuth: []
      summary: Получение всех правил каталога для поиска на стороне клиента
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/attribute/rule/{rule_id}:
    delete:
      description: Удаляет определенное правило.
      operationId: delete-filter-rule-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/personalized-catalog-rule_id-path-param'
      responses:
        '204':
          description: Удалено успешно.
        '401':
          $ref: '#/components/responses/Common_401-complex'
      security:
        - basicAuth: []
      summary: Удаление правила фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает конкретное правило, применяемое к атрибутам пользователя.
      operationId: get-filter-rule-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/personalized-catalog-rule_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    attribute_conditions:
                      - attribute: race
                        can_be_missing: false
                        operator: eq
                        type: string
                        value: ork
                    is_enabled: true
                    is_satisfied_for_unauth: true
                    items:
                      - item_id: 1
                        name: Ork Armor
                        sku: com.xsolla.ork_armor_1
                    name: Ork race armor rule
                    rule_id: 1
              schema:
                $ref: '#/components/schemas/user-attribute_personalized-catalog'
          description: Правило получено успешно.
        '401':
          $ref: '#/components/responses/Common_401-complex'
      security:
        - basicAuth: []
      summary: Получение правила фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    patch:
      description: >-
        Обновляет определенное правило, применяемое к атрибутам пользователя.
        Для неуказанных свойств будет использоваться текущее значение.
      operationId: patch-filter-rule-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/personalized-catalog-rule_id-path-param'
      requestBody:
        content:
          application/json:
            example:
              is_enabled: false
            schema:
              $ref: '#/components/schemas/user-attribute_personalized-catalog-body'
      responses:
        '204':
          description: Обновлено успешно.
        '401':
          $ref: '#/components/responses/Common_401-complex'
        '422':
          $ref: '#/components/responses/Common_422-body-validation'
      security:
        - basicAuth: []
      summary: Корректировка правила фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Обновляет определенное правило, применяемое к атрибутам пользователя.
        Для неуказанных свойств (при их необязательности) будет использоваться
        значение по умолчанию.
      operationId: update-filter-rule-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/personalized-catalog-rule_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/personalized-catalog_create-update-body'
      responses:
        '204':
          description: Обновлено успешно.
        '401':
          $ref: '#/components/responses/Common_401-complex'
        '422':
          $ref: '#/components/responses/Common_422-body-validation'
      security:
        - basicAuth: []
      summary: Обновление правила фильтрации каталога
      tags:
        - personalized-catalog
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/coupon/external_id/{external_id}:
    get:
      description: >-
        Получает информацию об оставшемся количестве применений купона для
        указанного пользователя.


        API ограничений для пользователей позволяет ограничить доступное
        количество применений купона. Для настройки самого ограничения перейдите
        в раздел администратора:

        *
        [Купоны](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-coupons/)
      operationId: get-coupon-user-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/user_external_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-coupon-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Coupon not found:
                  $ref: '#/components/examples/404-coupon-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/Promotions_422-invalid-coupon'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: >-
        Информация об ограничении на применение купонов для указанного
        пользователя
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/item/all:
    delete:
      description: >-
        Обновляет все лимиты на покупку для всех товаров для указанного
        пользователя, чтобы он мог приобрести эти товары снова.


        API лимитов на покупку позволяет вам продавать товар в ограниченном
        количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin
        нужного типа товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: reset-all-user-items-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits'
      responses:
        '200':
          description: Лимиты успешно обновлены.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                User not found:
                  value:
                    errorCode: 5008
                    errorMessage: '[0401-5008]: Could not find User'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  value:
                    errorCode: 1102
                    errorMessage: '[0401-1102]: Unprocessable Entity'
                    errorMessageExtended:
                      - message: Must be at least 1 characters long
                        property: user_external_id
                      - message: Does not match the regex pattern ^\S+$
                        property: user_external_id
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    items:
                      properties:
                        message:
                          type: string
                        property:
                          type: string
                      type: object
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Обновление всех лимитов на покупку для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}:
    delete:
      description: >-
        Уменьшает оставшееся количество товаров, доступных указанному
        пользователю в пределах установленного лимита.


        API лимитов на покупку позволяет вам продавать товар в ограниченном
        количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin
        нужного типа товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        *[Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: remove-user-item-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Available item limit is out of range:
                  $ref: >-
                    #/components/examples/422-item-out-of-range-available-user-limit
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Уменьшение лимита доступных пользователю товаров
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Возвращает оставшееся количество товаров, доступных указанному
        пользователю, в пределах установленного ограничения.

         User limit API позволяет вам продавать товар в ограниченном количестве. Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного типа товара:
        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: get-user-item-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/user_external_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Получение лимита доступных пользователю товаров
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: >-
        Увеличивает оставшееся количество товаров, доступных указанному
        пользователю, в пределах установленного ограничения.


        User limit API позволяет продавать товар в ограниченном количестве.
        Чтобы настроить ограничения на покупку, перейдите в раздел Admin нужного
        типа товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: add-user-item-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Available item limit is out of range:
                  $ref: >-
                    #/components/examples/422-item-out-of-range-available-user-limit
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Увеличение лимита доступных пользователю товаров
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Устанавливает количество товаров, которые указанный пользователь может
        купить в пределах ограничения, примененного после его увеличения или
        уменьшения.


        User limit API позволяет продавать товар в ограниченном количестве.
        Чтобы настроить ограничения покупку, перейдите в раздел Admin нужного
        типа товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        * [Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: set-user-item-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-flexible'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-item-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Настройка лимита доступных пользователю товаров
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/item/sku/{item_sku}/all:
    delete:
      description: >-
        Обновляет лимит на покупку товара, чтобы пользователь мог купить его
        снова. Если параметр *user* равен `null`, этот метод обновляет лимит для
        всех пользователей.


        API лимитов на покупку позволяет вам продавать товар в ограниченном
        количестве. Чтобы настроить лимиты покупок, перейдите в раздел Admin
        нужного типа товара:

        * [Игровые
        ключи](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-create-game/)

        *[Виртуальные предметы и
        валюта](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [Бандлы](https://developers.xsolla.com/ru/api/shop-builder/operation/admin-get-bundle-list/)
      operationId: reset-user-item-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits-flexible'
      responses:
        '200':
          description: Лимиты успешно обновлены.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-item-by-sku-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Item does not have configured user limits:
                  $ref: '#/components/examples/422-item-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Обновление лимита на покупку
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/promocode/external_id/{external_id}:
    get:
      description: >-
        Получает информацию об оставшемся количестве применений промокода для
        указанного пользователя.


        API ограничений для пользователей позволяет ограничить доступное
        количество применений промокода. Для настройки самого ограничения
        перейдите в раздел администратора:

        *
        [Промокоды](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-promo-codes/)
      operationId: get-promo-code-user-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
        - $ref: '#/components/parameters/user_external_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-promo-code-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Promo code not found:
                  $ref: '#/components/examples/404-coupon-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/Promotions_422-invalid-coupon'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: >-
        Информация об ограничении на применение промокодов для указанного
        пользователя
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/promotion/all:
    delete:
      description: >-
        Обновляет все лимиты по всем акциям для указанного пользователя, чтобы
        он мог снова использовать эти акции.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: reset-all-user-promotions-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits'
      responses:
        '200':
          description: Лимит акции был успешно обновлен.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Обновление лимитов акций для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}:
    delete:
      description: >-
        Уменьшает оставшееся количество раз, когда указанный пользователь может
        воспользоваться рекламной акцией в пределах установленного лимита.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: remove-user-promotion-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-promotion-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-promotion-by-id-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Available promotion limit is out of range:
                  $ref: >-
                    #/components/examples/422-promotion-out-of-range-available-user-limit
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Promotion does not have configured user limits:
                  $ref: '#/components/examples/422-promotion-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Уменьшение лимита акций для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Возвращает оставшееся количество раз, когда указанный пользователь может
        воспользоваться акцией в пределах установленного лимита.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: get-user-promotion-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
        - $ref: '#/components/parameters/user_external_id-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-promotion-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-promotion-by-id-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Promotion does not have configured user limits:
                  $ref: '#/components/examples/422-promotion-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Получение лимита акций для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: >-
        Увеличивает оставшееся количество раз, когда указанный пользователь
        может воспользоваться акцией в пределах установленного лимита.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: add-user-promotion-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-strict'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-promotion-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-promotion-by-id-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Available promotion limit is out of range:
                  $ref: >-
                    #/components/examples/422-promotion-out-of-range-available-user-limit
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Promotion does not have configured user limits:
                  $ref: '#/components/examples/422-promotion-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Увеличение лимита акций для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Задает количество раз, когда указанный пользователь может
        воспользоваться рекламной акцией в пределах лимита, примененного после
        его увеличения или уменьшения.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: set-user-promotion-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-user-limits-flexible'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-user-promotion-limits'
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-promotion-by-id-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Promotion does not have configured user limits:
                  $ref: '#/components/examples/422-promotion-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Настройка лимита акций для пользователя
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/user/limit/promotion/id/{promotion_id}/all:
    delete:
      description: >-
        Обновляет лимит акции, чтобы пользователь мог снова воспользоваться этой
        акцией. Если параметр *user* равен `null`, этот вызов обновляет это
        ограничение для всех пользователей.


        API лимитов пользователя позволяет ограничить количество раз, когда
        пользователи могут использовать рекламную акцию. Для настройки самого
        лимита перейдите в раздел Admin нужного типа акции:

        * [Акции со
        скидками](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-discounts/)

        * [Бонусные
        акции](https://developers.xsolla.com/ru/api/shop-builder/tag/promotions-bonuses/)
      operationId: reset-user-promotion-limit
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/reset-user-limits-flexible'
      responses:
        '200':
          description: Лимит акции был успешно обновлен.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                Item not found:
                  $ref: '#/components/examples/404-promotion-by-id-not-found'
                User not found:
                  $ref: '#/components/examples/404-user-not-found'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Товар не найден.
        '422':
          content:
            application/json:
              examples:
                Invalid user_external_id:
                  $ref: '#/components/examples/422-user_external_id_invalid'
                Promotion does not have configured user limits:
                  $ref: '#/components/examples/422-promotion-without-user-limit'
              schema:
                properties:
                  errorCode:
                    type: integer
                  errorMessage:
                    type: string
                  errorMessageExtended:
                    type: array
                  statusCode:
                    type: integer
                  transactionId:
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - basicAuth: []
      summary: Обновление лимита акций для пользователей
      tags:
        - user-limits-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/admin/webhook:
    get:
      description: |-
        Получает информацию о настройках вебхуков в Store.
         Подробная информация о настройке вебхуков приведена в [документации](https://developers.xsolla.com/ru/doc/shop-builder/integration-guide/set-up-webhooks/).
      operationId: get-webhook
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    is_enabled: true
                    secret: my_secret
                    url: http://site.ru/webhook
              schema:
                properties:
                  is_enabled:
                    example: true
                    type: boolean
                  secret:
                    example: my_secret
                    type: string
                  url:
                    example: http://site.ru/webhook
                    type: string
                type: object
          description: Информация о настройках вебхуков успешно получена.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: >-
            Нет информации о настройках вебхуков для переданного `project_id`.
            Убедитесь, что использовали верный `project_id` и проверьте
            существование вебхуков.
      security:
        - basicAuth: []
      summary: Получение информации о настройках вебхуков
      tags:
        - common-webhooks
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: |-
        Обновляет информацию о настройках вебхуков в Store.
         Подробная информация о настройке вебхуков приведена в [документации](/ru/doc/shop-builder/integration-guide/set-up-webhooks/).
      operationId: update-webhook
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        content:
          application/json:
            schema:
              example:
                is_enabled: true
                secret: my_secret_key
                url: http://site.ru/webhook
                version: 1
              properties:
                is_enabled:
                  description: >-
                    Подключено ли получение вебхуков раздела [Игровые
                    сервисы](/ru/webhooks/operation/successful-order-payment/).


                    Для вебхуков раздела [Игровые
                    сервисы](/ru/webhooks/operation/successful-order-payment/)
                    настройка, заданная в этом методе, имеет приоритет над
                    настройкой, указанной в Личном кабинете в разделе [Настройки
                    проекта >
                    Вебхуки](https://publisher.xsolla.com/0/projects/0/edit/webhooks/).
                  example: true
                  type: boolean
                secret:
                  description: "Секретный ключ проекта для подписи вебхуков\_раздела [Игровые сервисы](/ru/webhooks/operation/successful-order-payment/). \n\nДля вебхуков раздела [Игровые сервисы](/ru/webhooks/operation/successful-order-payment/) ключ, заданный в этом методе, имеет приоритет над ключом, сгенерированным в Личном кабинете в разделе [Настройки проекта > Вебхуки](https://publisher.xsolla.com/0/projects/0/edit/webhooks/)."
                  example: my_secret
                  type: string
                url:
                  description: >-
                    URL-адрес вашего сервера для получения вебхуков раздела
                    [Игровые
                    сервисы](/ru/webhooks/operation/successful-order-payment/).
                    URL-адрес должен быть общедоступным и использовать протокол
                    HTTPS, например `https://example.com`. Вы также можете
                    ввести URL-адрес из любого инструмента для тестирования
                    вебхуков. 


                    Для вебхуков раздела [Игровые
                    сервисы](/ru/webhooks/operation/successful-order-payment/)
                    настройка, заданная в этом методе, имеет приоритет над
                    настройкой, указанной в Личном кабинете в разделе [Настройки
                    проекта >
                    Вебхуки](https://publisher.xsolla.com/0/projects/0/edit/webhooks/).
                  example: http://site.ru/webhook
                  type: string
                version:
                  description: >-
                    Версия вебхуков. В версии `2` в массиве
                    [items](/ru/webhooks/operation/successful-order-payment/#!path=items&t=request)
                    добавлены параметры `is_free`, `is_bonus` и
                    `is_bundle_content`. В версии `1` (по умолчанию) эти
                    параметры отсутствуют.
                  enum:
                    - 1
                    - 2
                  type: integer
              required:
                - url
                - secret
                - is_enabled
              type: object
        description: Информация о настройках вебхуков.
        required: true
      responses:
        '204':
          description: Информация о настройках вебхуков успешно обновлена.
        '401':
          $ref: '#/components/responses/Common_401-invalid-basic-auth'
        '404':
          description: >-
            Нет информации о настройках вебхуков для переданного `project_id`.
            Убедитесь, что использовали верный `project_id` и проверьте
            существование вебхуков.
        '422':
          description: Информация о настройках вебхуков содержит пустой URL.
      security:
        - basicAuth: []
      summary: Обновление информации о настройках вебхуков
      tags:
        - common-webhooks
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v2/project/{project_id}/cart:
    get:
      description: Возвращает корзину текущего пользователя.
      operationId: get-user-cart
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-cart-json-model'
      security:
        - AuthForCart: []
      summary: Получение корзины текущего пользователя
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/clear:
    put:
      description: Удаляет все товары из корзины.
      operationId: cart-clear
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '204':
          description: Корзина успешно очищена.
      security:
        - AuthForCart: []
      summary: Удаление всех товаров из текущей корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/fill:
    put:
      description: >-
        Наполняет корзину товарами. Если в корзине уже есть товар с тем же
        артикулом, существующий товар будет заменен переданным значением.
      operationId: cart-fill
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-fill-cart-json-model'
      security:
        - AuthForCart: []
      summary: Наполнение корзины товарами
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/item/{item_sku}:
    delete:
      description: Удаляет товар из корзины.
      operationId: delete-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          description: Товар успешно удален из корзины.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
      security:
        - AuthForCart: []
      summary: Удаление товара из текущей корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
    put:
      description: Обновляет уже имеющийся в корзине товар или создает его в корзине.
      operationId: put-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_put-item-by-cart-idJsonModel'
      responses:
        '204':
          description: Корзина успешно обновлена.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
        '422':
          $ref: >-
            #/components/responses/Cart-Payment_422-can-put-only-virtual-good-to-cart
      security:
        - AuthForCart: []
      summary: Обновление товара из текущей корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/{cart_id}:
    get:
      description: Возвращает корзину пользователя по ID корзины.
      operationId: get-cart-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/currency-query-param'
        - $ref: '#/components/parameters/locale-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-cart-json-model'
      security:
        - AuthForCart: []
      summary: Получение корзины по ID корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/{cart_id}/clear:
    put:
      description: Удаляет все товары из корзины.
      operationId: cart-clear-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      responses:
        '204':
          description: Корзина успешно очищена.
      security:
        - AuthForCart: []
      summary: Удаление всех товаров из корзины по ID корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/{cart_id}/fill:
    put:
      description: >-
        Наполняет определенную корзину товарами. Если в корзине уже есть товар с
        тем же артикулом, существующая позиция товара будет заменен переданным
        значением.
      operationId: cart-fill-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_fill-cart-json-model'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-fill-cart-json-model'
      security:
        - AuthForCart: []
      summary: Наполнение определенной корзины товарами
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/cart/{cart_id}/item/{item_sku}:
    delete:
      description: Удаляет товар из корзины.
      operationId: delete-item-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      responses:
        '204':
          description: Товар успешно удален из корзины.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
      security:
        - AuthForCart: []
      summary: Удаление товара из корзины по ID корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
    put:
      description: Обновляет уже имеющийся в корзине товар или создает его в корзине.
      operationId: put-item-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_put-item-by-cart-idJsonModel'
      responses:
        '204':
          description: Корзина успешно обновлена.
        '404':
          $ref: '#/components/responses/Cart-Payment_404-item'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-non-negative-quantity'
      security:
        - AuthForCart: []
      summary: Обновление товара в корзине по ID корзины
      tags:
        - cart-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/coupon/code/{coupon_code}/rewards:
    get:
      description: >-
        Получает вознаграждения по купону по его коду.

        Может использоваться, чтобы дать пользователям возможность выбрать один
        предмет из множества в качестве бонуса.
         Обычным случаем, если купон содержит игру в качестве бонуса (тип unit), является выбор платформы.
      operationId: get-coupon-rewards-by-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/coupon_code-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-coupon-rewards'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '404':
          $ref: '#/components/responses/Promotions_404-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-rewards'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение вознаграждений по купону
      tags:
        - promotions-coupons
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/coupon/redeem:
    post:
      description: Погашает код купона. Пользователь получает бонус после погашения купона.
      operationId: redeem-coupon
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_redeem-coupon-model'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-coupon-redeemed'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '404':
          $ref: '#/components/responses/Promotions_404-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-redeem-coupon'
      security:
        - XsollaLoginUserJWT: []
      summary: Погашение кода купона
      tags:
        - promotions-coupons
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/entitlement:
    get:
      description: >-
        Получает список игр, принадлежащих пользователю. Ответ будет содержать
        массив игр, принадлежащих определенному пользователю.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ</strong>.Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div>
      operationId: get-user-games
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/sandbox-query-param'
        - $ref: '#/components/parameters/additional_fields-entitlement-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-user-entitlement-list'
        '401':
          $ref: '#/components/responses/Game-Keys_401-invalid-basic-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка игр, принадлежащих пользователю
      tags:
        - game-keys-entitlement
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/entitlement/redeem:
    post:
      description: >-
        Дает право владения по предоставленному игровому коду.


        <div class="notice"><strong>Внимание</strong><br><br>Могут быть погашены
        только игровые коды для DRM-free-платформ.</div>
      operationId: redeem-game-pin-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                code:
                  description: Игровой ключ.
                  example: AAAA-BBBB-CCCC-DDDD
                  type: string
                sandbox:
                  default: false
                  description: >-
                    Погашает игровой ключ в режиме тестового окружения. Данная
                    опция доступна пользователям, указанным в списке
                    пользователей компании.
                  example: false
                  type: boolean
              required:
                - code
              type: object
        required: true
      responses:
        '201':
          description: Успешная операция.
        '403':
          $ref: '#/components/responses/Game-Keys_403-auth-header-not-sent'
        '404':
          content:
            application/json:
              examples:
                Game code not found:
                  $ref: '#/components/examples/404-game-code-not-found'
              schema:
                properties:
                  errorCode:
                    example: 4603
                    type: integer
                  errorMessage:
                    example: '[0401-4603]: Game code not found.'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                  transactionId:
                    example: x-x-x-x-transactionId-mock-x-x-x
                    type: string
                type: object
          description: >-
            Игровой ключ не найден. Убедитесь, что верно указали `code` и
            `project_id`.
        '422':
          content:
            application/json:
              examples:
                DRM is not DRM free:
                  $ref: '#/components/examples/422-drm-is-not-drm-free'
                Game code is already activated:
                  value:
                    errorCode: 5107
                    errorMessage: '[0401-5107]: Game code has been already activated'
                    statusCode: 422
                    transactionId: transaction id
                Game is in pre-order state:
                  value:
                    errorCode: 5106
                    errorMessage: >-
                      [0401-5106]: Item: game_sku is in pre-order state and can
                      not be redeemed
                    statusCode: 422
                    transactionId: transaction id
                User already has entitlement:
                  $ref: '#/components/examples/422-user-already-has-entitlement'
              schema:
                properties:
                  errorCode:
                    example: 5103
                    type: integer
                  errorMessage:
                    example: '[0401-5103]: Selected drm is not drmfree.'
                    type: string
                  statusCode:
                    example: 422
                    type: integer
                  transactionId:
                    example: x-x-x-x-transactionId-mock-x-x-x
                    type: string
                type: object
          description: Неверный запрос.
      security:
        - XsollaLoginUserJWT: []
      summary: Активация игрового ключа на стороне клиента
      tags:
        - game-keys-entitlement
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/free/cart:
    post:
      description: >-
        Создает заказ со всеми товарами из бесплатной корзины. Созданному заказу
        будет присвоен статус заказа `done`.
      operationId: create-free-order
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - AuthForCart: []
      summary: Создание заказа с помощью бесплатной корзины
      tags:
        - free-item
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/free/cart/{cart_id}:
    post:
      description: >-
        Создает заказ со всеми товарами из определенной бесплатной корзины.
        Созданному заказу будет присвоен статус заказа `done`.
      operationId: create-free-order-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - AuthForCart: []
      summary: Создание заказа с помощью определенной бесплатной корзины
      tags:
        - free-item
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/free/item/{item_sku}:
    post:
      description: >-
        Создает заказ с указанным бесплатным товаром. Созданному заказу будет
        присвоен статус заказа `done`.
      operationId: create-free-order-with-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-with-specified-item-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Free_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-item'
      security:
        - XsollaLoginUserJWT: []
      summary: Создание заказа с указанным бесплатным товаром
      tags:
        - free-item
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items:
    get:
      description: >-
        Получает список продаваемых товаров для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ</strong>.Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-sellable-items
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-items-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка продаваемых товаров
      tags:
        - common-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/bundle:
    get:
      description: >-
        Получает список бандлов для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 элементов на
        ответ.</strong> </div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации,но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-bundle-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-get-bundle-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка бандлов
      tags:
        - bundles-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/bundle/group/{external_id}:
    get:
      description: >-
        Получает список бандлов в рамках группы для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 элементов на
        ответ.</strong> </div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-bundle-list-in-group
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Bundles_200-get-bundle-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка бандлов по указанной группе
      tags:
        - bundles-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/bundle/sku/{sku}:
    get:
      description: >-
        Получает указанный бандл.


        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-bundle
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/sku-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  $ref: '#/components/examples/Bundles_200-get-bundle'
              schema:
                $ref: '#/components/schemas/Bundles_client_bundle'
          description: Указанный бандл успешно получен.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение указанного бандла
      tags:
        - bundles-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game:
    get:
      description: >-
        Получает список игр для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-games-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-games-catalog'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка игр
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game/drm:
    get:
      description: Получает список доступных платформ.
      operationId: get-drm-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-drm-list'
      security: []
      summary: Получение списка платформ
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game/group/{external_id}:
    get:
      description: >-
        Получает список игр из указанной группы для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров в
        ответе.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации,но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-games-group
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-games-catalog'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка игр по указанной группе
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game/key/group/{external_id}:
    get:
      description: >-
        Получает список игровых ключей из указанной группы для построения
        каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров в
        ответе.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-game-keys-group
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Game-Keys_200-get-game-keys-by-group-catalog'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка игровых ключей по указанной группе
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game/key/sku/{item_sku}:
    get:
      description: >-
        Получает иговой ключ для каталога.


        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-game-key-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: Артикул товара.
          in: path
          name: item_sku
          required: true
          schema:
            default: xsollus_basic_edition_steam
            type: string
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                            value: Horror
                    can_be_bought: true
                    description: Game description
                    drm_name: Steam
                    drm_sku: steam_key_1
                    groups:
                      - external_id: all
                        name: All games
                      - external_id: Xsolla
                        name: Xsolla games
                    has_keys: true
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    is_free: false
                    is_pre_order: true
                    limits: null
                    name: Game name
                    periods:
                      - date_from: '2020-08-11T10:00:00+03:00'
                        date_until: '2020-08-11T20:00:00+03:00'
                    price:
                      amount: '30.5'
                      amount_without_discount: '30.5'
                      currency: USD
                    promotions: []
                    release_date: '2020-08-11T10:00:00+03:00'
                    sku: com.xsolla.game_1
                    type: game_key
                    virtual_prices: []
              schema:
                description: Объект с информацией об игровом ключе.
                example:
                  attributes:
                    - external_id: OS
                      name: OS
                      values:
                        - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                          value: Windows
                    - external_id: genre
                      name: Genre
                      values:
                        - external_id: 23fda05111c125608af8f1fa0e99db45a10ea1cc
                          value: Horror
                  can_be_bought: true
                  description: Game description
                  drm_name: Steam
                  drm_sku: steam_key_1
                  groups:
                    - external_id: all
                      item_order_in_group: 2
                      name: All games
                    - external_id: Xsolla
                      item_order_in_group: 1
                      name: Xsolla games
                  has_keys: true
                  image_url: >-
                    https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                  is_free: false
                  is_pre_order: true
                  limits: null
                  name: Game name
                  periods:
                    - date_from: '2020-08-11T10:00:00+03:00'
                      date_until: '2020-08-11T20:00:00+03:00'
                  price:
                    amount: '30.5'
                    amount_without_discount: '30.5'
                    currency: USD
                  promotions: []
                  release_date: '2020-08-11T10:00:00+03:00'
                  sku: com.xsolla.game_1
                  type: game_key
                  virtual_prices: []
                properties:
                  attributes:
                    $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                  can_be_bought:
                    $ref: '#/components/schemas/Can_be_bought'
                  description:
                    description: Описание товара.
                    example: Game description
                    type: string
                  drm_name:
                    description: Название платформы.
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      Уникальный ID платформы. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: steam_key_1
                    type: string
                  groups:
                    $ref: '#/components/schemas/items_client_groups_response'
                  has_keys:
                    description: >-
                      Если `true`, у игры на платформе есть игровые ключи для
                      продажи.
                    example: false
                    type: boolean
                  image_url:
                    description: URL-адрес изображения.
                    example: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    type: string
                  is_free:
                    $ref: '#/components/schemas/value-is_free'
                  is_pre_order:
                    description: >-
                      Если `true`, игра на платформе находится в предзаказе и
                      дата релиза еще не прошла.
                    example: true
                    type: boolean
                  limits:
                    $ref: '#/components/schemas/Catalog_item_limits'
                  name:
                    description: Название товара.
                    example: Game name
                    type: string
                  periods:
                    $ref: '#/components/schemas/item-periods'
                  price:
                    description: Цены на товар.
                    properties:
                      amount:
                        description: Цена товара со скидкой.
                        example: '2.9900'
                        type: string
                      amount_without_discount:
                        description: Цена товара.
                        example: '2.9900'
                        type: string
                      currency:
                        description: >-
                          Валюта, в которой указана цена товара. Трехбуквенный
                          код в соответствии со стандартом [ISO
                          4217](https://en.wikipedia.org/wiki/ISO_4217).
                        example: USD
                        type: string
                    type: object
                  promotions:
                    $ref: '#/components/schemas/Catalog_item_promotions'
                  release_date:
                    description: Дата выпуска игры на платформе в формате ISO 8601.
                    example: '2020-08-11T10:00:00+03:00'
                    type: string
                  sku:
                    description: >-
                      Уникальный ID товара. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: com.xsolla.game_01
                    type: string
                  type:
                    description: 'Тип товара: `game_key`.'
                    example: game_key
                    type: string
                  virtual_prices:
                    description: Виртуальные цены.
                    items:
                      description: Виртуальная цена.
                      properties:
                        amount:
                          description: Цена товара со скидкой в виртуальной валюте.
                          example: 100
                          type: integer
                        amount_without_discount:
                          description: Цена товара.
                          example: 200
                          type: integer
                        description:
                          description: Описание виртуальной валюты.
                          example: Big Rocket - description
                          type: string
                        image_url:
                          description: Изображение виртуальной валюты.
                          example: http://image.png
                          type: string
                        is_default:
                          description: Является ли данная цена товара ценой по умолчанию.
                          example: true
                          type: boolean
                        name:
                          description: Название виртуальной валюты.
                          example: SHOTGUN FOR TRUE RAIDERS
                          type: string
                        sku:
                          description: Артикул виртуальной валюты.
                          example: com.xsolla.vc_1
                          type: string
                        type:
                          description: Тип виртуальной валюты.
                          example: virtual_currency
                          type: string
                      type: object
                    type: array
                type: object
          description: Игровой ключ успешно получен.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_key_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_key_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игровой ключ не найден.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение игрового ключа для каталога
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/game/sku/{item_sku}:
    get:
      description: >-
        Получает игру для каталога. 


        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: Артикул товара.
          in: path
          name: item_sku
          required: true
          schema:
            default: full_game_1
            type: string
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    attributes:
                      - external_id: OS
                        name: OS
                        values:
                          - external_id: 9d5c5efb7c0f00a00fe4e3583f1215b0050bc723
                            value: Windows
                      - external_id: genre
                        name: Genre
                        values:
                          - external_id: 9c5774997fc072b973bd5c231075c13841413f62
                            value: Casual, Logic
                    description: Game description
                    groups:
                      - external_id: all
                        item_order_in_group: 2
                        name: All games
                      - external_id: Xsolla
                        item_order_in_group: 1
                        name: Xsolla games
                    image_url: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    name: Game name
                    promotions: []
                    sku: com.xsolla.game_1
                    type: unit
                    unit_items:
                      - can_be_bought: true
                        drm_name: Steam
                        drm_sku: steam_key_1
                        has_keys: true
                        is_free: false
                        is_pre_order: true
                        limits: null
                        periods:
                          - date_from: '2020-08-11T10:00:00+03:00'
                            date_until: '2020-08-11T20:00:00+03:00'
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        promotions: []
                        release_date: '2020-08-11T10:00:00+03:00'
                        sku: com.xsolla.game_key_01
                        type: game_key
                        virtual_prices: []
                        vp_rewards:
                          - amount: 130
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            item_id: 175232
                            name: Value point
                            sku: com.xsolla.value_point_1
                          - amount: 50
                            image_url: >-
                              https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg
                            is_clan: true
                            item_id: 186321
                            name: Clan Reward VP 1
                            sku: com.xsolla.clan_value_point_1
                      - can_be_bought: true
                        drm_name: Origin
                        drm_sku: origin_key_1
                        has_keys: false
                        is_free: false
                        is_pre_order: false
                        limits: null
                        periods: []
                        price:
                          amount: '30.5'
                          amount_without_discount: '30.5'
                          currency: USD
                        promotions: []
                        release_date: null
                        sku: com.xsolla.game_key_02
                        type: game_key
                        virtual_prices: []
                        vp_rewards: []
                    unit_type: game
              schema:
                description: Объект с информацией об игре.
                properties:
                  attributes:
                    $ref: '#/components/schemas/Game-Keys_schemas-client-attributes'
                  description:
                    description: Описание товара.
                    example: Game description
                    type: string
                  groups:
                    $ref: '#/components/schemas/items_client_groups_response'
                  image_url:
                    description: URL-адрес изображения.
                    example: >-
                      https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png
                    type: string
                  name:
                    description: Название товара.
                    example: Game name
                    type: string
                  promotions:
                    $ref: '#/components/schemas/Catalog_item_promotions'
                  sku:
                    description: >-
                      Уникальный ID товара. Артикул может содержать только
                      строчные и заглавные латинские буквы, цифры, точки, тире и
                      подчеркивания.
                    example: game_01
                    type: string
                  type:
                    description: >-
                      Тип товара:
                      `virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`.
                    example: unit
                    type: string
                  unit_items:
                    items:
                      properties:
                        can_be_bought:
                          $ref: '#/components/schemas/Can_be_bought'
                        drm_name:
                          description: Название платформы.
                          example: Steam
                          type: string
                        drm_sku:
                          description: >-
                            Уникальный ID платформы. Артикул может содержать
                            только строчные и заглавные латинские буквы, цифры,
                            точки, тире и подчеркивания.
                          example: steam
                          type: string
                        has_keys:
                          description: >-
                            Если `true`, у игры на платформе есть игровые ключи
                            для продажи.
                          example: false
                          type: boolean
                        is_free:
                          $ref: '#/components/schemas/value-is_free'
                        is_pre_order:
                          description: >-
                            Если `true`, игра на платформе находится в
                            предзаказе и дата релиза еще не прошла.
                          example: true
                          type: boolean
                        limits:
                          $ref: '#/components/schemas/Catalog_item_limits'
                        periods:
                          $ref: '#/components/schemas/item-periods'
                        price:
                          description: Цены на товар.
                          properties:
                            amount:
                              description: Цена товара со скидкой.
                              example: '2.9900'
                              type: string
                            amount_without_discount:
                              description: Цена товара.
                              example: '2.9900'
                              type: string
                            currency:
                              description: >-
                                Валюта, в которой указана цена товара.
                                Трехбуквенный код в соответствии со стандартом
                                [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217).
                              example: USD
                              type: string
                          type: object
                        promotions:
                          $ref: '#/components/schemas/Catalog_item_promotions'
                        release_date:
                          description: Дата выпуска игры на платформе в формате ISO 8601.
                          example: '2020-08-11T10:00:00+03:00'
                          nullable: true
                          type: string
                        sku:
                          description: >-
                            Уникальный ID товара. Артикул может содержать только
                            строчные и заглавные латинские буквы, цифры, точки,
                            тире и подчеркивания.
                          example: game_01
                          type: string
                        type:
                          description: 'Тип товара: `game_key`.'
                          example: game_key
                          type: string
                        virtual_prices:
                          description: Виртуальные цены.
                          items:
                            description: Виртуальная цена.
                            properties:
                              amount:
                                description: Цена товара со скидкой в виртуальной валюте.
                                example: 100
                                type: integer
                              amount_without_discount:
                                description: Цена товара.
                                example: 200
                                type: integer
                              description:
                                description: Описание виртуальной валюты.
                                example: Big Rocket - description
                                type: string
                              image_url:
                                description: Изображение виртуальной валюты.
                                example: http://image.png
                                type: string
                              is_default:
                                description: >-
                                  Является ли данная цена товара ценой по
                                  умолчанию.
                                example: true
                                type: boolean
                              name:
                                description: Название виртуальной валюты.
                                example: SHOTGUN FOR TRUE RAIDERS
                                type: string
                              sku:
                                description: Артикул виртуальной валюты.
                                example: vc_test
                                type: string
                              type:
                                description: Тип виртуальной валюты.
                                example: virtual_currency
                                type: string
                            type: object
                          type: array
                        vp_rewards:
                          $ref: '#/components/schemas/client-item-value-point-reward'
                      type: object
                    type: array
                  unit_type:
                    description: 'Тип: `game`.'
                    example: game
                    type: string
                type: object
          description: Игра успешно получена.
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 4001
                    errorMessage: '[0401-4001]: Item with sku = ''game_1'' not found'
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 4001
                    type: integer
                  errorMessage:
                    example: '[0401-4001]: Item with sku = ''game_1'' not found'
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Игра не найдена.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение игры для каталога
      tags:
        - game-keys-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/group/{external_id}:
    get:
      description: >-
        Получает список продаваемых товаров из указанной группы для построения
        каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50
        товаров.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-sellable-items-group
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/external_id_59080-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-items-by-group-id'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка продаваемых товаров по указанной группе
      tags:
        - common-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/groups:
    get:
      description: Получает список групп товаров для создания каталога.
      operationId: get-item-groups
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-items-groups'
      security: []
      summary: Получение списка групп товаров
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/id/{item_id}:
    get:
      description: >-
        Получает продаваемый товар по его ID. 

        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-sellable-item-by-id
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/item_id_59080-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-item-by-id'
        '404':
          $ref: '#/components/responses/sellable-item-by-id_404'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение продаваемого товара по ID
      tags:
        - common-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/sku/{sku}:
    get:
      description: >-
        Получает продаваемый товар по артикулу для построения каталога.

        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-sellable-item-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id_59080-path-param'
        - $ref: '#/components/parameters/item_sku_59080-path-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          $ref: '#/components/responses/sellable_items_200-get-item-by-id'
        '404':
          $ref: '#/components/responses/sellable-item-by-sku_404'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение продаваемого товара по артикулу
      tags:
        - common-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/upsell:
    get:
      description: Получает список товаров для апселла в проекте, если они уже настроены.
      operationId: get-upsell-for-project-client
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Upsell-200-get-client-list'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка товаров для апселла в проекте
      tags:
        - upsell-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_currency:
    get:
      description: >-
        Получает список виртуальных валют для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-list
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка виртуальных валют
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_currency/package:
    get:
      description: >-
        Получает список пакетов виртуальной валюты для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-virtual-currency-package
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-packages-list
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка пакетов виртуальной валюты
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_currency/package/sku/{virtual_currency_package_sku}:
    get:
      description: >-
        Получает пакет виртуальной валюты по артикулу для построения каталога.

        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-virtual-currency-package-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_package_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency-package
      security:
        - XsollaLoginUserJWT: []
      summary: Получение пакета виртуальной валюты по артикулу
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}:
    get:
      description: >-
        Получает виртуальную валюту по артикулу для построения каталога.

        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-virtual-currency-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-virtual-currency
      security:
        - XsollaLoginUserJWT: []
      summary: Получение виртуальной валюты по артукулу
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_items:
    get:
      description: >-
        Получает список виртуальных предметов для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div> <br> <div
        class="note"><b>Примечание</b><br><br>Использование каталога товаров
        доступно без авторизации, но для получения <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированного каталога</a> необходимо передать
        JWT пользователя в заголовке Authorization.</div>
      operationId: get-virtual-items
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-items-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка виртуальных предметов
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_items/all:
    get:
      description: >-
        Gets a list of all virtual items for searching on client-side.


        <div class="notice"><strong>Attention</strong><br><br>Returns only item
        SKU, name, groups and description</div> <br> <div
        class="note"><b>Note</b><br><br>The use of the item catalog API calls is
        available without authorization, but to get a <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">personalized catalog</a>, you must pass the user JWT in
        the Authorization header.</div>
      operationId: get-all-virtual-items
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-all-items-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка всех виртуальных предметов
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_items/group/{external_id}:
    get:
      description: >-
        Получает список товаров из указанной группы для построения каталога.


        <div class="notice"><strong>Внимание</strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров на
        ответ.</strong> Чтобы получить больше данных постранично, используйте
        поля <b>limit</b> и <b>offset</b>.</div><br><div
        class="note"><b>Примечание</b><br><br>Без авторизации метод возвращает
        общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-virtual-items-group
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-group-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/promo_code-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
      responses:
        '200':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_200-get-items-by-group-id
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item-group'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение списка товаров по указанной группе
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/items/virtual_items/sku/{item_sku}:
    get:
      description: >-
        Получает виртуальный предмет по артикулу для построения каталога.

        <div class="note"><b>Примечание</b><br><br>Без авторизации метод
        возвращает общие данные. Используйте авторизацию, чтобы получить <a
        href="https://developers.xsolla.com/ru/doc/shop-builder/features/personalization/"
        target="_blank">персонализированные</a> данные пользователя, такие как
        лимиты и акции.</div>
      operationId: get-virtual-items-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/locale-query-param'
        - $ref: '#/components/parameters/country-query-param'
        - $ref: '#/components/parameters/show_inactive_time_limited_items-query-param'
        - $ref: '#/components/parameters/additional_fields-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-get-item-by-sku'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение виртуального предмета по артикулу
      tags:
        - virtual-items-currency-catalog
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/order/{order_id}:
    get:
      description: Получает указанный заказ.
      operationId: get-order
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/order_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-get-order'
        '404':
          $ref: '#/components/responses/Cart-Payment_404-get-order'
      security:
        - AuthForCart: []
      summary: Получение заказа
      tags:
        - order
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/payment/cart:
    post:
      description: >-
        Используется для интеграции клиент-сервер. Создает заказ со всеми
        товарами из корзины и генерирует для него токен оплаты. Созданный заказ
        получает `new` статус заказа.


        IP-адрес клиента используется для определения страны пользователя,
        которая затем используется для применения соответствующей валюты и
        доступных способов оплаты заказа.


        Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей
        ссылкой: `https://secure.xsolla.com/paystation4/?token={token}`, где
        `{token}` — полученный токен.


        Для целей тестирования используйте этот URL-адрес:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Внимание </strong><br><br>Поскольку этот
        метод использует IP-адрес для определения страны пользователя и валюты
        для заказа, важно использовать этот метод только на стороне клиента, а
        не на стороне сервера. Использование этого метода на стороне сервера
        может привести к неправильному определению валюты и повлиять на способы
        оплаты в <a href="https://developers.xsolla.com/ru/doc/pay-station/">Pay
        Station</a>. </div>
      operationId: create-order
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - AuthForCart: []
      summary: Создание заказа со всеми товарами из текущей корзины
      tags:
        - payment-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/payment/cart/{cart_id}:
    post:
      description: >-
        Используется для интеграции клиент-сервер. Создает заказ со всеми
        товарами из конкретной корзины и генерирует для него токен оплаты.
        Созданный заказ получает статус заказа `new`.


        IP-адрес клиента используется для определения страны пользователя,
        которая затем используется для применения соответствующей валюты и
        доступных способов оплаты заказа.


        Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей
        ссылкой: `https://secure.xsolla.com/paystation4/?token={token}`, где
        `{token}` — полученный токен.


        Для целей тестирования используйте этот URL-адрес:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Примечание</strong><br><br>Поскольку этот
        метод использует IP-адрес для определения страны пользователя и выбора
        валюты для заказа, важно использовать этот метод только на стороне
        клиента, а не на стороне сервера. Использование этого метода на стороне
        сервера может привести к неправильному определению валюты и повлиять на
        способы оплаты в <a
        href="https://developers.xsolla.com/ru/doc/pay-station/">Pay
        Station</a>. </div>
      operationId: create-order-by-cart-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/cart_id-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-by-cart-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-invalid-cart'
      security:
        - AuthForCart: []
      summary: Создание заказа со всеми товарами из определенной корзины
      tags:
        - payment-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/payment/item/{item_sku}:
    post:
      description: >-
        Используется для интеграции клиент-сервер. Создает заказ с указанным
        товаром и генерирует для него токен оплаты. Созданный заказ получает
        статус заказа `new`.


        IP-адрес клиента используется для определения страны пользователя,
        которая затем используется для применения соответствующей валюты и
        доступных способов оплаты заказа.


        Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей
        ссылкой: `https://secure.xsolla.com/paystation4/?token={token}`, где
        `{token}` — полученный токен.


        Для целей тестирования используйте этот URL-адрес:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"><strong>Примечание</strong><br><br>Поскольку этот
        метод использует IP-адрес для определения страны пользователя и выбора
        валюты для заказа, важно использовать этот метод только на стороне
        клиента, а не на стороне сервера. Использование этого метода на стороне
        сервера может привести к неправильному определению валюты и повлиять на
        способы оплаты в <a
        href="https://developers.xsolla.com/ru/doc/pay-station/">Pay
        Station</a>. </div>
      operationId: create-order-with-item
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
      requestBody:
        $ref: >-
          #/components/requestBodies/Cart-Payment_create-order-with-specified-item-idJsonModel
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '404':
          $ref: >-
            #/components/responses/Cart-Payment_404-create-order-with-item-not-found-errors
        '422':
          $ref: >-
            #/components/responses/Cart-Payment_422-create-order-with-item-invalid
      security:
        - XsollaLoginUserJWT: []
      summary: Создание заказа с указанным товаром
      tags:
        - payment-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/payment/item/{item_sku}/virtual/{virtual_currency_sku}:
    post:
      description: Создает покупку товара с использованием виртуальной валюты.
      operationId: create-order-with-item-for-virtual-currency
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/item_sku-path-param'
        - $ref: '#/components/parameters/virtual_currency_sku-path-param'
        - $ref: '#/components/parameters/platform-query-param'
      requestBody:
        content:
          application/json:
            example:
              custom_parameters:
                array_param:
                  - object1:
                      param: https://xsolla.com
                    property:
                      int_property: 112
                      string_property: xsolla
                  - object2:
                      param: https://developers.xsolla.com/ru
                    property:
                      int_property: 112
                      string_property: email@example.com
                bool_param: true
                int_param: 100
                null_param: null
                object_param:
                  key: value
            schema:
              properties:
                custom_parameters:
                  $ref: '#/components/schemas/Cart-Payment_custom_parameters'
              type: object
      responses:
        '200':
          $ref: '#/components/responses/Virtual-Items-Currency_200-quick-purchase'
        '404':
          $ref: '#/components/responses/Virtual-Items-Currency_404-item'
        '422':
          $ref: >-
            #/components/responses/Virtual-Items-Currency_422-not-enough-virtual-currency
      security:
        - XsollaLoginUserJWT: []
      summary: Создание заказа с указанным товаром, приобретенным за виртуальную валюту
      tags:
        - virtual-payment
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/promocode/code/{promocode_code}/rewards:
    get:
      description: >-
        Получает вознаграждения по промокоду по его коду.

        Может использоваться, чтобы дать пользователям возможность выбрать один
        предмет из множества в качестве бонуса.
         Обычным случаем, если промокод содержит игру в качестве бонуса (тип unit), является выбор платформы.
      operationId: get-promo-code-rewards-by-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promocode_code-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-promocode-rewards'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '404':
          $ref: '#/components/responses/Promotions_404-promo-code'
        '422':
          $ref: '#/components/responses/Promotions_422-rewards'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение вознаграждения по промокоду
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/promocode/redeem:
    post:
      description: >-
        Использует код акции с промокодами.

        После погашения промокода пользователь получит бесплатные товары и/или
        цена корзины и/или отдельных товаров будет снижена.
      operationId: redeem-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_redeem-promo-code-model'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-promo-code-redeemed'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '404':
          $ref: '#/components/responses/Promotions_404-promo-code'
        '422':
          $ref: '#/components/responses/Promotions_422-redeem-coupon'
      security:
        - AuthForCart: []
      summary: Погашение промокода
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/promocode/remove:
    put:
      description: >-
        Удаляет промокод из корзины.

        После удаления промокода общая цена всех товаров в корзине будет
        пересчитана без учета бонусов и скидок, предоставляемых промокодом.
      operationId: remove-cart-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_cancel-promo-code-model'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-promo-code-canceled'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '422':
          $ref: '#/components/responses/Promotions_422-cancel-promo-code'
      security:
        - AuthForCart: []
      summary: Удаление промокода из корзины
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/promotion/code/{code}/verify:
    get:
      description: >-
        Определяет, является ли код промокодом или купоном и может ли
        пользователь его применить.
      operationId: verify-promotion-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/code-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-verify-promo-code'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '403':
          $ref: '#/components/responses/Promotions_403-auth-header'
        '404':
          $ref: '#/components/responses/Promotions_404-verify-promo-code'
        '422':
          $ref: '#/components/responses/Promotions_422-verify-promo-code'
      security:
        - XsollaLoginUserJWT: []
      summary: Подтвердите промокод
      tags:
        - promotions-common
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/clan/contributors/{reward_chain_id}/top:
    get:
      description: >-
        Возвращает 10 участников, внесших наибольший вклад в определенную
        цепочку наград для текущего клана пользователя. Если пользователь не
        состоит в клане, в ответе вернется пустой массив.
      operationId: get-user-clan-top-contributors
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            example: 44056
            type: integer
        - description: ID цепочки наград.
          in: path
          name: reward_chain_id
          required: true
          schema:
            example: 101
            type: integer
      responses:
        '200':
          content:
            application/json:
              examples:
                clan:
                  summary: Пользователь состоит в клане.
                  value:
                    - contributed_amount: 555
                      name: winner
                    - contributed_amount: 398
                      name: Rocket
                    - contributed_amount: 201
                      name: MrJoe
                    - contributed_amount: 1
                      name: beginner
                without-clan:
                  summary: Пользователь не состоит в клане.
                  value: []
              schema:
                items:
                  properties:
                    contributed_amount:
                      description: Количество призовых баллов, заработанных пользователем.
                      example: 100
                      type: integer
                    name:
                      description: >-
                        ID пользователя, который отправляется в Xsolla в
                        процессе авторизации и связывает пользователя с вашим
                        проектом Xsolla Login.
                      example: Rocket
                      type: string
                  type: object
                type: array
          description: 10 участников, внесших наибольший вклад в клановую цепочку наград.
      security:
        - XsollaLoginUserJWT: []
      summary: >-
        Получение 10 участников, внесших наибольший вклад в продвижение по
        клановой цепочке наград
      tags:
        - clan-reward-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/clan/update:
    put:
      description: >-
        Обновляет текущий клан пользователя через атрибуты пользователя. Выдает
        пользователю награды, которые он не забрал из цепочки наград старого
        клана, и возвращает их в ответе. Если пользователь состоял в клане, а
        теперь нет — принадлежность к клану будет удалена. Если пользователь
        сменил клан, принадлежность к клану изменится и будет указан новый клан.
      operationId: user-clan-update
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 44056
            type: integer
      responses:
        '200':
          $ref: '#/components/responses/200-client-update-user-clan'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Обновление клана текущего пользователя
      tags:
        - clan-reward-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/daily_chain:
    get:
      description: >-
        Клиентский метод. Возвращает ежедневные награды для текущего
        пользователя. 

        <div class="notice"><strong>Примечание</strong><br><br>Метод возвращает
        список элементов с учетом пагинации. <strong>Максимальное количество
        элементов в ответе — 50 (установлено по умолчанию)</strong>. Чтобы
        получить доступ к следующим элементам списка, используйте параметры
        `limit` и `offset`. Например, при вызове метода с параметрами `limit =
        25` и `offset = 100` вернется 25 элементов, начиная со 101-го в общем
        списке.</div>
      operationId: get-daily-chains-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-client-get-daily-chains-list'
        '401':
          $ref: '#/components/responses/401-client-auth-error'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение ежедневных наград для текущего пользователя
      tags:
        - daily-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/daily_chain/{daily_chain_id}:
    get:
      description: >-
        Клиентский метод. Возвращает ежедневную награду по ее ID для текущего
        пользователя.
      operationId: get-user-daily-chain-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  $ref: '#/components/examples/200-client-daily-chain'
              schema:
                $ref: '#/components/schemas/client-daily-chain-model'
          description: Ежедневные награды пользователя успешно получены.
        '404':
          $ref: '#/components/responses/404-daily-chain-not-found'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение ежедневной награды по ее ID для текущего пользователя
      tags:
        - daily-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/daily_chain/{daily_chain_id}/step/number/{step_number}/claim:
    post:
      description: >-
        Клиентский метод. Возвращает награду на текущем уровне в цепочке
        ежедневных наград для текущего пользователя. Все уровни могут быть
        пройдены только в заданном порядке. Награду за пропущенный уровень
        нельзя получить за виртуальную или реальную валюту, или просмотр
        рекламного ролика.
      operationId: claim-user-daily-chain-step-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/daily_chain_id-path-param'
        - $ref: '#/components/parameters/daily_chain_step_number-path-param'
      responses:
        '204':
          description: >-
            Текущая награда пользователя за уровень ежедневной награды успешно
            получена.
        '401':
          $ref: '#/components/responses/401-client-auth-error'
        '404':
          $ref: '#/components/responses/404-daily-chain-step-not-found'
        '422':
          content:
            application/json:
              examples:
                invalid-step:
                  $ref: >-
                    #/components/examples/422-daily-chain-claim-error-invalid-step
              schema:
                $ref: '#/components/schemas/daily-chain-error-model'
          description: Награда за уровень не может быть получена.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение ежедневной награды за уровень
      tags:
        - daily-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/offer_chain:
    get:
      description: >-
        Возвращает цепочки предложений для текущего пользователя.

        <div class="notice"><strong>Внимание</strong><br><br> Все проекты имеют
        ограничение на количество элементов, возвращаемых в одном ответе.
        Максимальное значение — <strong>30 элементов на запрос</strong>. Чтобы
        получить больше данных, используйте параметры <code>limit</code> и
        <code>offset</code> для пагинации.</div>
      operationId: get-offer-chains-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-client-get-offer-chains-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение цепочек предложений для текущего пользователя
      tags:
        - offer-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/offer_chain/{offer_chain_id}:
    get:
      description: Возвращает цепочку предложений по ее ID для текущего пользователя.
      operationId: get-user-offer-chain-by-id
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  $ref: '#/components/examples/200-client-offer-chain'
              schema:
                $ref: '#/components/schemas/client-offer-chain-model'
          description: Цепочка предложений пользователя успешно получена.
        '404':
          $ref: '#/components/responses/404-offer-chain-not-found'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение цепочки предложений по ее ID для текущего пользователя
      tags:
        - offer-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/claim:
    post:
      description: >-
        Завершает прохождение текущим пользователем уровня цепочки предложений и
        выдает связанную с ним награду.

        <div class="notice">

        <strong>Внимание</strong><br><br>

        Используйте этот метод только для бесплатных уровней.

        Для уровней, доступных за реальную валюту, используйте метод <a
        href="/api/shop-builder/operation/order-user-offer-chain-step-reward">Создание
        заказа на награду за уровень цепочки предложений</a>.

        </div>
      operationId: claim-user-offer-chain-step-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
        - $ref: '#/components/parameters/offer_chain_step_number-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    order_id: 641
              schema:
                properties:
                  order_id:
                    description: ID заказа.
                    type: integer
                type: object
          description: >-
            Награда на бесплатном уровне для текущего пользователя успешно
            получена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-step-not-found'
        '422':
          content:
            application/json:
              examples:
                invalid-step:
                  $ref: >-
                    #/components/examples/422-offer-chain-claim-error-invalid-step
              schema:
                $ref: '#/components/schemas/offer-chain-error-model'
          description: >-
            Невозможно получить награду на бесплатном уровне цепочки
            предложений. Убедитесь, что все предыдущие уровни пройдены, и
            текущий уровень бесплатный.
      security:
        - XsollaLoginUserJWT: []
      summary: Получение награды за уровень цепочки предложений
      tags:
        - offer-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/offer_chain/{offer_chain_id}/step/number/{step_number}/order:
    post:
      description: >-
        Создает заказ на товар, связанный с указанным уровнем цепочки
        предложений. Полученный заказ получает статус `new`.


        Чтобы открыть платежный интерфейс в новом окне, используйте ссылку:
        `https://secure.xsolla.com/paystation4/?token={token}`, где `{token}` —
        полученный токен.


        Для тестирования используйте этот URL-адрес:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice">

        <strong>Внимание</strong> <br><br>

        Используйте этот метод только на стороне клиента. Метод определяет
        страну пользователя по IP-адресу, чтобы применить соответствующую валюту
        и доступные способы оплаты. Вызов с сервера может привести к
        некорректному определению валюты и повлиять на способы оплаты в <a
        href="https://developers.xsolla.com/ru/doc/pay-station/">Pay
        Station</a>. 

        </div><br>


        <div class="notice">

        <strong>Внимание</strong><br><br>

        Используйте только для получения наград на платных уровнях цепочки
        предложений.

        Для платных используйте метод <a
        href="/api/shop-builder/operation/claim-user-offer-chain-step-reward">Получение
        награды за уровень цепочки предложений</a>.

        </div>
      operationId: order-user-offer-chain-step-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/offer_chain_id-path-param'
        - $ref: '#/components/parameters/offer_chain_step_number-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Cart-Payment_200-order-created'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '404':
          $ref: '#/components/responses/404-offer-chain-step-not-found'
        '422':
          content:
            application/json:
              examples:
                invalid-step:
                  $ref: >-
                    #/components/examples/422-offer-chain-claim-error-invalid-step
              schema:
                $ref: '#/components/schemas/offer-chain-error-model'
          description: Покупка уровня невозможна.
      security:
        - XsollaLoginUserJWT: []
      summary: Создание заказа на награду за уровень цепочки предложений
      tags:
        - offer-chain-client
        - payment-client-side
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/reward_chain:
    get:
      description: >-
        Метод клиента. Получает цепочки наград текущего пользователя.


        <div class="notice"><strong>Внимание! </strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>50 товаров в
        ответе.</strong> Чтобы получить больше данных постранично, используйте
        <b></b><b></b>поля limit и offset.</div>
      operationId: get-reward-chains-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-client-get-reward-chains-list'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение цепочки наград текущего пользователя
      tags:
        - reward-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/balance:
    get:
      description: Метод клиента. Возвращает призовые баллы текущего пользователя.
      operationId: get-user-reward-chain-balance
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-client-get-user-reward-chain-balance'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение призовых баллов текущего пользователя
      tags:
        - reward-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v2/project/{project_id}/user/reward_chain/{reward_chain_id}/step/{step_id}/claim:
    post:
      description: >-
        Метод клиента. Запрашивает награду на уровне для текущего пользователя в
        цепочке наград.
      operationId: claim-user-reward-chain-step-reward
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
        - $ref: '#/components/parameters/reward_chain_step_id-path-param'
      responses:
        '204':
          description: >-
            Успешно получена награда на уровне для текущего пользователя в
            цепочке наград.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-client-auth'
        '404':
          $ref: '#/components/responses/404-reward-chain-step-not-found'
        '422':
          $ref: '#/components/responses/422-reward-chain-step-reward-can-not-claimed'
      security:
        - XsollaLoginUserJWT: []
      summary: Получение награды на уровне
      tags:
        - reward-chain-client
      x-badges:
        - color: '#80eaff'
          name: Client-side
  /v3/project/{project_id}/admin/coupon:
    get:
      description: Получает список акций с купонами в рамках проекта.
      operationId: get-coupons
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-coupons'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка акций с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает акцию с купонами.
      operationId: admin-create-coupon
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_coupon-create'
      responses:
        '201':
          content:
            application/json:
              examples:
                response:
                  value:
                    external_id: coupon_external_id
              schema:
                properties:
                  external_id:
                    $ref: '#/components/schemas/Promotions_coupon-external_id'
                type: object
          description: Акция с купонами успешно создана.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Создание акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/coupon/{external_id}:
    delete:
      description: "Удаляет [акцию с купонами](https://developers.xsolla.com/ru/doc/shop-builder/features/coupons/). Удаленная акция:\n* Пропадет из списка акций, настроенных в вашем проекте.\n* Не будет применяться к каталогу товаров. Пользователь не сможет получить бонусные товары по этой акции.\n\nПосле удаления акция не может быть восстановлена.\nКоды купонов из удаленной акции могут быть [добавлены](https://developers.xsolla.com/ru/api/shop-builder/operation/create-coupon-code/)\_в существующие акции."
      operationId: delete-coupon-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Акция с купоном была успешно удалена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Удаление акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает указанную акцию с купонами.
      operationId: get-coupon
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    bonus:
                      - quantity: 100
                        sku: com.xsolla.diamonds_1
                    external_id: summer20221
                    is_enabled: true
                    name:
                      en-US: Coupon name
                      ru-RU: Название купона
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                      - date_from: '2020-05-15T18:16:00+05:00'
                        date_until: '2020-05-25T18:16:00+05:00'
                    redeem_code_limit: null
                    redeem_total_limit: 100
                    redeem_user_limit: null
                    total_limit_state:
                      available: 50
                      reserved: 10
                      used: 40
              schema:
                $ref: >-
                  #/components/schemas/admin-promotions_200-get-coupon-promotion-model
          description: Акция с купонами успешно получена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Получение акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет акцию с купонами.
      operationId: update-coupon-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_coupon-update'
      responses:
        '204':
          description: Акция с купонами успешно обновлена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Обновление акции с купонами
      tags:
        - promotions-coupons
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/order/search:
    post:
      description: >-
        Возвращает список заказов, упорядоченный по дате создания — от самой
        ранней до самой поздней.
      operationId: admin-order-search
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/admin-order-search'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-order-search'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка заказов за указанный период
      tags:
        - order
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/payment/token:
    post:
      description: >-
        Генерирует заказ и платежный токен для него. Заказ генерируется на
        основе товаров, переданных в теле запроса.


        Чтобы открыть платежный интерфейс в новом окне, воспользуйтесь следующей
        ссылкой: `https://secure.xsolla.com/paystation4/?token={token}`, где
        `{token}` — полученный токен.


        Для целей тестирования используйте этот URL-адрес:
        `https://sandbox-secure.xsolla.com/paystation4/?token={token}`.


        <div class="notice"> <strong>Внимание</strong>

        <br><br>

        Параметр <code>user.country.value</code> используется для выбора валюты
        для заказа. Если страна пользователя неизвестна, 

        альтернативным вариантом является указание IP-адреса пользователя в
        <code>X-User-Ip</code> заголовке. <br>Для корректной работы метода
        требуется один из этих двух вариантов. <br>Выбранная валюта используется
        для оплаты в <a
        href="https://developers.xsolla.com/ru/doc/pay-station/">Pay
        Station</a></b>.
           </div>
      operationId: admin-create-payment-token
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Cart-Payment_admin-create-payment-token'
      responses:
        '201':
          $ref: '#/components/responses/Cart-Payment_201-admin-create-payment-token'
        '401':
          $ref: '#/components/responses/Cart-Payment_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Cart-Payment_422-admin-create-payment-token'
      security:
        - basicAuth: []
      summary: Создание платежного токена для покупки
      tags:
        - payment-server-side
      x-badges:
        - color: '#95ff80'
          name: Server-side
  /v3/project/{project_id}/admin/promocode:
    get:
      description: Получает список промокодов проекта.
      operationId: get-promo-codes
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-promocodes'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка акций с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает акцию с промокодами.
      operationId: create-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_promocode-create'
      responses:
        '201':
          content:
            application/json:
              examples:
                response:
                  value:
                    external_id: coupon_external_id
              schema:
                properties:
                  external_id:
                    $ref: '#/components/schemas/Promotions_coupon-external_id'
                type: object
          description: Промокод успешно создан.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Создание акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promocode/{external_id}:
    delete:
      description: "Удаляет [акцию с промокодами](https://developers.xsolla.com/ru/doc/shop-builder/features/promo-codes/). Удаленная акция:\n* Пропадет из списка акций, настроенных в вашем проекте.\n* Не будет применяться к каталогу товаров и к корзине. Пользователь не сможет получить бонусные товары или купить товары с применением этой акции.\n\nПосле удаления акция не может быть восстановлена.\nПромокоды из удаленной акции могут быть [добавлены](https://developers.xsolla.com/ru/api/shop-builder/operation/create-promo-code-code/)\_в существующие акции."
      operationId: delete-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Акция с промокодом была успешно удалена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Удаление акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает указанную акцию с промокодами.
      operationId: get-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                simple:
                  value:
                    bonus:
                      - quantity: 100
                        sku: com.xsolla.diamonds_1
                    discount:
                      percent: '10.99'
                    discounted_items: null
                    excluded_promotions:
                      - 23
                      - 45
                    external_id: summer20221
                    is_enabled: true
                    name:
                      en-US: Coupon name
                      ru-RU: Название купона
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                      - date_from: '2020-05-15T18:16:00+05:00'
                        date_until: '2020-05-25T18:16:00+05:00'
                    redeem_code_limit: 1
                    redeem_total_limit: 100
                    redeem_user_limit: null
                    total_limit_state:
                      available: 50
                      reserved: 10
                      used: 40
                with item price conditions:
                  value:
                    bonus:
                      - quantity: 100
                        sku: com.xsolla.diamonds_3
                    discount:
                      percent: '10.99'
                    discounted_items: null
                    excluded_promotions:
                      - 23
                      - 45
                    external_id: summer20221
                    is_enabled: true
                    item_price_conditions:
                      - operator: gt
                        value: '10.0000'
                      - operator: lt
                        value: '50.0000'
                    name:
                      en-US: Coupon name
                      ru-RU: Название купона
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                    redeem_code_limit: 1
                    redeem_total_limit: 100
                    redeem_user_limit: null
                    total_limit_state:
                      available: 50
                      reserved: 10
                      used: 40
                with price conditions:
                  value:
                    bonus:
                      - quantity: 100
                        sku: com.xsolla.diamonds_2
                    discount:
                      percent: '10.99'
                    discounted_items: null
                    external_id: summer20221
                    is_enabled: true
                    name:
                      en-US: Coupon name
                      ru-RU: Название купона
                    price_conditions:
                      - operator: gt
                        value: '10.0000'
                      - operator: lt
                        value: '50.0000'
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                    redeem_code_limit: 1
                    redeem_total_limit: 100
                    redeem_user_limit: null
                    total_limit_state:
                      available: 50
                      reserved: 10
                      used: 40
              schema:
                $ref: >-
                  #/components/schemas/Promotions_200-get-promocode-promotion-model
          description: Промокод успешно получен.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
      security:
        - basicAuth: []
      summary: Получение акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет акцию с промокодами.
      operationId: update-promo-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_promocode-update'
      responses:
        '204':
          description: Промокод успешно обновлен.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promocode'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Обновление акции с промокодами
      tags:
        - promotions-promo-codes
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion:
    get:
      description: Получает список акций проекта.
      operationId: get-promotion-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/enabled-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-promotions'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка всех акций
      tags:
        - promotions-common
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion/bonus:
    get:
      description: >-
        Получает список акций с бонусами в рамках проекта.


        Акция добавляет бесплатные бонусные товары к покупке, совершенной
        пользователем.

        Акция может быть применена к каждой покупке в рамках проекта или к
        покупке, включающей определенные товары.
      operationId: get-bonus-promotion-list
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-bonus-promotions'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка акций с бонусами
      tags:
        - promotions-bonuses
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: >-
        Создает акцию с бонусами.


        Акция добавляет бесплатные бонусные товары к покупке, совершенной
        пользователем.

        Акция может быть применена к каждой покупке в рамках проекта или к
        покупке, включающей определенные товары.
      operationId: create-bonus-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-update-bonus-promotion'
      responses:
        '201':
          $ref: '#/components/responses/Promotions_201-create-promotion'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-admin-promotion-missed-bonus-property
      security:
        - basicAuth: []
      summary: Создание акции с бонусами
      tags:
        - promotions-bonuses
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion/item:
    get:
      description: |-
        Получает список акций со скидками в рамках проекта.

        Акция дает скидку (%) на товары.
        Скидка будет применена ко всем ценам на указанные товары.
      operationId: get-item-promotion-list
      parameters:
        - description: ID проекта.
          in: path
          name: project_id
          required: true
          schema:
            default: 59080
            type: integer
        - description: Лимит количества элементов на странице.
          in: query
          name: limit
          required: false
          schema:
            type: integer
        - description: >-
            Номер элемента, с которого выполняется вывод на странице (нумерация
            ведется с 0).
          in: query
          name: offset
          required: false
          schema:
            type: integer
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-item-promotions'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка акций со скидками
      tags:
        - promotions-discounts
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: |-
        Создает акцию со скидками для товара.

        Акция дает скидку (%) на товары.
        Скидка будет применена ко всем ценам на указанные товары.
      operationId: create-item-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-update-item-promotion'
      responses:
        '201':
          $ref: '#/components/responses/Promotions_201-create-promotion'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-admin-promotion-missed-items-property
      security:
        - basicAuth: []
      summary: Создание акции со скидками для товара
      tags:
        - promotions-discounts
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion/redeemable/code/{code}:
    get:
      description: Получение акции по промокоду или коду купона.
      operationId: get-redeemable-promotion-by-code
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/code-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-redeemable-by-code'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-code-not-found'
        '405':
          $ref: '#/components/responses/405-method-not-found'
      security:
        - basicAuth: []
      summary: Информация об акции с кодом
      tags:
        - promotions-common
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion/{promotion_id}/bonus:
    delete:
      description: >-
        Удаляет [бонусную
        акцию](https://developers.xsolla.com/ru/doc/shop-builder/features/bonuses/).
        Удаленная акция:

        * Пропадет из списка акций, настроенных в вашем проекте.

        * Не будет применяться к каталогу товаров и к корзине. Пользователь не
        сможет получить бонусные товары по этой акции.


        После удаления акция не может быть восстановлена.
      operationId: delete-bonus-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '204':
          description: Акция была успешно удалена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promotion'
      security:
        - basicAuth: []
      summary: Удаление бонусной акции
      tags:
        - promotions-bonuses
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: >-
        Получает акцию с бонусами.


        Акция добавляет бесплатные бонусные товары к покупке, совершенной
        пользователем.

        Акция может быть применена к каждой покупке в рамках проекта или к
        покупке, включающей определенные товары.
      operationId: get-bonus-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-admin-get-bonus-promotion'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promotion'
      security:
        - basicAuth: []
      summary: Получение акции с бонусами
      tags:
        - promotions-bonuses
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Обновляет акцию.


        <div class='note'><b>Примечание</b><br><br>Новые данные заменят старые.
        Если вы хотите обновить только часть акции, вам также следует передать в
        запросе все необходимые данные.</div>


        Акция добавляет бесплатные бонусные товары к покупке, совершенной
        пользователем.

        Акция может быть применена к каждой покупке в рамках проекта или к
        покупке, включающей определенные товары.
      operationId: update-bonus-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-update-bonus-promotion'
      responses:
        '204':
          description: Акция успешно обновлена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-admin-promotion-missed-bonus-property
      security:
        - basicAuth: []
      summary: Обновление акции с бонусами
      tags:
        - promotions-bonuses
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/promotion/{promotion_id}/item:
    delete:
      description: >-
        Удаляет [скидочную
        акцию](https://developers.xsolla.com/ru/doc/shop-builder/features/discounts/).
        Удаленная акция:

        * Пропадет из списка акций, настроенных в вашем проекте.

        * Не будет применяться к каталогу товаров и к корзине. Пользователь не
        сможет купить товары с применением этой акции.


        После удаления акция не может быть восстановлена.
      operationId: delete-item-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '204':
          description: Акция была успешно удалена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promotion'
      security:
        - basicAuth: []
      summary: Удаление скидочной акции
      tags:
        - promotions-discounts
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: |-
        Получает акцию, применяемую к определенным товарам.

        Акция дает скидку (%) на товары.
        Скидка будет применена ко всем ценам на указанные товары.
      operationId: get-item-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    discount:
                      percent: '20.00'
                    excluded_promotions:
                      - 23
                      - 45
                    id: 1
                    is_enabled: true
                    items:
                      - sku: com.xsolla.elven_helmet_1
                      - sku: com.xsolla.elven_armor_1
                    limits:
                      per_item: null
                      per_user:
                        total: 10
                      recurrent_schedule:
                        per_user:
                          day_of_month: null
                          day_of_week: null
                          displayable_reset_next_date: '2023-02-28T11:00:00+08:00'
                          displayable_reset_start_date: '2023-02-28T11:00:00+08:00'
                          interval_type: daily
                          reset_next_date: 1677553200
                          time: 11:00:00+08:00
                    name:
                      en-US: Promotion
                      ru-RU: Акция
                    price_conditions:
                      - operator: ge
                        value: '10.0000'
                      - operator: le
                        value: '50.0000'
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
              schema:
                example:
                  discount:
                    percent: '15.00'
                  id: 1
                  is_enabled: true
                  items:
                    - sku: com.xsolla.elven_sword_1
                    - sku: com.xsolla.elven_helmet_1
                    - sku: com.xsolla.elven_armor_1
                  name:
                    en-US: Promotion
                    ru-RU: Акция
                  promotion_periods:
                    - date_from: '2020-04-15T18:16:00+05:00'
                      date_until: '2020-04-25T18:16:00+05:00'
                properties:
                  attribute_conditions:
                    $ref: >-
                      #/components/schemas/promotion_user-attribute_conditions_model-get
                  discount:
                    properties:
                      percent:
                        default: '10.00'
                        description: >-
                          Процент скидки. 

                          Цена товара будет уменьшена с использованием значения,
                          рассчитанного с использованием этого процента.
                        nullable: true
                        type: string
                    type: object
                  excluded_promotions:
                    $ref: '#/components/schemas/excluded_promotions'
                  id:
                    description: ID акции. Уникальный идентификатор акции в рамках проекта.
                    type: integer
                  is_enabled:
                    $ref: '#/components/schemas/Promotions_is_enabled'
                  items:
                    items:
                      description: >-
                        Список товаров, на которые будет распространяться
                        скидка.
                      properties:
                        sku:
                          default: elven_sword
                          description: Артикул товара.
                          type: string
                      type: object
                    nullable: true
                    type: array
                  limits:
                    $ref: '#/components/schemas/Promotions_promotion_limits_response'
                  name:
                    additionalProperties:
                      example:
                        en-US: Promotion
                        ru-RU: Акция
                      type: string
                    description: >-
                      Название акции. Данный параметр должен содержать пары
                      ключ/значение,
                       где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение — строка.
                    type: object
                  price_conditions:
                    $ref: '#/components/schemas/price_conditions_discount'
                  promotion_periods:
                    $ref: '#/components/schemas/promotion_periods'
                type: object
          description: Акция со скидками успешно получена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          content:
            application/json:
              examples:
                response:
                  value:
                    errorCode: 9502
                    errorMessage: >-
                      [0401-9502]: Can not find promotion with ID = 111425 in
                      project 59080
                    statusCode: 404
              schema:
                properties:
                  errorCode:
                    example: 9502
                    type: integer
                  errorMessage:
                    example: >-
                      [0401-9502]: Can not find promotion with ID = 111425 in
                      project 59080
                    type: string
                  statusCode:
                    example: 404
                    type: integer
                type: object
          description: Акция не найдена. Убедитесь, что верно указали `promotion_id`.
      security:
        - basicAuth: []
      summary: Получение акции со скидками
      tags:
        - promotions-discounts
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: >-
        Обновляет акцию.


        <div class='note'><b>Примечание</b><br><br>Новые данные заменят старые.
        Если вы хотите обновить только часть акции, вам также следует передать в
        запросе все необходимые данные.</div>


        Акция дает скидку (%) на товары.

        Скидка будет применена ко всем ценам на указанные товары.
      operationId: update-item-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/promotion_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_create-update-item-promotion'
      responses:
        '204':
          description: Акция успешно обновлена.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-promotion'
        '422':
          $ref: >-
            #/components/responses/Promotions_422-admin-promotion-missed-items-property
      security:
        - basicAuth: []
      summary: Обновление акции со скидками
      tags:
        - promotions-discounts
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/reward_chain:
    get:
      description: >-
        Получает список цепочек наград.


        <div class="notice"><strong>Внимание! </strong><br><br>Все проекты имеют
        ограничение на количество товаров, которые вы можете получить в ответе.
        Значение по умолчанию и максимальное значение — <strong>10 товаров в
        ответе</strong>.Чтобы получить больше данных постранично, используйте
        <b></b><b></b>поля limit и offset.</div>
      operationId: admin-get-reward-chains
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
        - $ref: '#/components/parameters/enabled-query-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-list-reward-chains'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка цепочек наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает цепочку наград.
      operationId: admin-create-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/create-reward-chain'
      responses:
        '201':
          $ref: '#/components/responses/201-admin-create-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/422-admin-create-update-rc-vp-invalid-request'
      security:
        - basicAuth: []
      summary: Создание цепочек наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}:
    delete:
      description: Удаляет определенную цепочку наград.
      operationId: admin-delete-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-delete-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Удаление цепочек наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает определенную цепочку наград.
      operationId: admin-get-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      responses:
        '200':
          $ref: '#/components/responses/200-admin-get-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-admin-reward-chain-not-found'
      security:
        - basicAuth: []
      summary: Получение цепочек наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет определенную цепочку наград.
      operationId: admin-update-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/update-reward-chain'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-update-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/404-admin-reward-chain-not-found'
        '422':
          $ref: '#/components/responses/422-admin-create-update-rc-vp-invalid-request'
      security:
        - basicAuth: []
      summary: Обновление цепочек наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/reset:
    post:
      description: >-
        Сбрасывает призовые баллы и прогресс всех пользователей в цепочке
        наград.<br>После сброса вы можете обновить срок действия цепочки наград
        и пользователи смогут снова продвигаться по ней.

        <div class="notice"><strong>Внимание</strong>

        <br><br>

        Не следует сбрасывать цепочку наград в период ее действия. В этом случае
        пользователи могут потерять заработанные очки до получения награды.

        </div>
      operationId: admin-reset-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-reset-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Сброс цепочки наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/reward_chain/id/{reward_chain_id}/toggle:
    put:
      description: Включение/отключение цепочки наград.
      operationId: admin-toggle-reward-chain
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/reward_chain_id-path-param'
      responses:
        '204':
          $ref: '#/components/responses/204-admin-toggle-reward-chain'
        '401':
          $ref: '#/components/responses/401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Переключение цепочки наград
      tags:
        - reward-chain-value-points-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/unique_catalog_offer:
    get:
      description: Получает список уникальных акционных предложений каталога проекта.
      operationId: get-unique-catalog-offers
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/limit-query-param'
        - $ref: '#/components/parameters/offset-query-param'
      responses:
        '200':
          $ref: '#/components/responses/Promotions_200-get-unique-catalog-offers'
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
      security:
        - basicAuth: []
      summary: Получение списка уникальных акционных предложений каталога
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    post:
      description: Создает уникальное акционное предложение по каталогу.
      operationId: admin-create-unique-catalog-offer
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_unique_catalog_offer-create'
      responses:
        '201':
          content:
            application/json:
              examples:
                response:
                  value:
                    external_id: coupon_external_id
              schema:
                properties:
                  external_id:
                    $ref: '#/components/schemas/Promotions_coupon-external_id'
                type: object
          description: Уникальное предложение по каталогу было успешно создано.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Создание уникального акционного предложения по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
  /v3/project/{project_id}/admin/unique_catalog_offer/{external_id}:
    delete:
      description: >-
        Удаляет [уникальное акционное предложение
        каталога](https://developers.xsolla.com/ru/doc/shop-builder/features/unique-offer/).
        Удаленная акция:

        * Пропадет из списка акций, настроенных в вашем проекте.

        * Не будет применяться к каталогу товаров и к корзине. Пользователь не
        сможет купить товары с применением этой акции.


        После удаления акция не может быть восстановлена.
      operationId: delete-unique-catalog-offer-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '204':
          description: Уникальное предложение каталога было успешно удалено.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Удаление уникального акционного предложения каталога
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    get:
      description: Получает указанное уникальное акционное предложение по каталогу.
      operationId: get-unique-catalog-offer
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      responses:
        '200':
          content:
            application/json:
              examples:
                response:
                  value:
                    external_id: secret_shop
                    is_enabled: true
                    items:
                      - helmet
                      - sword
                      - shield
                    name:
                      en-US: Secret shop
                      ru-RU: Секретный магазин
                    promotion_periods:
                      - date_from: '2020-04-15T18:16:00+05:00'
                        date_until: '2020-04-25T18:16:00+05:00'
                      - date_from: '2020-05-15T18:16:00+05:00'
                        date_until: '2020-05-25T18:16:00+05:00'
                    redeem_code_limit: 1
                    redeem_total_limit: 100
                    redeem_user_limit: 1
                    total_limit_state:
                      available: 50
                      reserved: 10
                      used: 40
              schema:
                $ref: >-
                  #/components/schemas/Promotions_200-get-unique-catalog-offer-promotion-model
          description: Уникальное предложение по каталогу было успешно получено.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
      security:
        - basicAuth: []
      summary: Получение уникального акционного предложения по каталогу
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: Обновляет уникальное акционное предложение каталога.
      operationId: update-unique-catalog-offer-promotion
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - $ref: '#/components/parameters/external_id-promotion-path-param'
      requestBody:
        $ref: '#/components/requestBodies/Promotions_unique_catalog_offer-update'
      responses:
        '204':
          description: Уникальное предложение каталога было успешно обновлено.
        '401':
          $ref: '#/components/responses/Promotions_401-invalid-basic-auth'
        '404':
          $ref: '#/components/responses/Promotions_404-admin-coupon'
        '422':
          $ref: '#/components/responses/Promotions_422-invalid-coupon'
      security:
        - basicAuth: []
      summary: Обновление уникального акционного предложения каталога
      tags:
        - promotions-unique-catalog-offers
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
servers:
  - url: https://store.xsolla.com/api
tags:
  - name: attribute-admin
    x-displayName: Admin
  - description: >-
      Данный API позволяет задавать правила для пользовательских атрибутов. Если
      пользователь соответствует всем условиям для конкретного правила, будут
      показаны персонализированные товары.


      Узнать о персонализированных акциях можно в [подразделе
      "Скидки"](/ru/api/shop-builder/tag/promotions-discounts) раздела "Акции".


      Чтобы передать атрибуты перед покупкой, вы можете использовать [API
      Авторизации
      Иксолла](/ru/api/login/operation/update-users-attributes-from-server/) или
      передать их в [свойство user.attributes при генерации токена с помощью API
      Платежей Иксолла](/ru/api/pay-station/operation/create-token).
    name: personalized-catalog
    x-displayName: Персонализированный каталог
  - name: bundles-admin
    x-displayName: Admin
  - name: bundles-catalog
    x-displayName: Catalog
  - name: cart-client-side
    x-displayName: Корзина (на стороне клиента)
  - name: cart-server-side
    x-displayName: Корзина (на стороне сервера)
  - name: payment-client-side
    x-displayName: Оплата (на стороне клиента)
  - name: payment-server-side
    x-displayName: Оплата (на стороне сервера)
  - name: order
    x-displayName: Заказ
  - name: common-webhooks
    x-displayName: Вебхуки
  - name: common-pre-orders
    x-displayName: Предзаказы
  - name: common-merchant
    x-displayName: Продавец
  - description: >-
      Данный API позволяет получать продаваемые товары любого вида или
      конкретный товар.
    name: common-catalog
    x-displayName: Catalog
  - name: game-keys-catalog
    x-displayName: Catalog
  - name: game-keys-entitlement
    x-displayName: Владение играми
  - name: game-keys-admin
    x-displayName: Admin
  - name: promotions-common
    x-displayName: Общие
  - description: Этот API позволяет вам управлять купонами.
    name: promotions-coupons
    x-displayName: Купоны
  - description: Этот API позволяет вам управлять промокодами.
    name: promotions-promo-codes
    x-displayName: Промокоды
  - description: Этот API позволяет вам управлять уникальными предложениями каталога.
    name: promotions-unique-catalog-offers
    x-displayName: Уникальный каталог предложений
  - description: Этот API позволяет вам управлять скидочными акциями.
    name: promotions-discounts
    x-displayName: Скидки
  - description: Этот API позволяет вам управлять бонусными акциями.
    name: promotions-bonuses
    x-displayName: Бонусы
  - name: virtual-items-currency-admin
    x-displayName: Admin
  - name: virtual-items-currency-catalog
    x-displayName: Catalog
  - name: virtual-payment
    x-displayName: Виртуальная оплата
  - name: common-regions
    x-displayName: Общие регионы
  - name: free-item
    x-displayName: Бесплатные товары
  - name: user-limits-admin
    x-displayName: Управление
  - name: reward-chain-value-points-admin
    x-displayName: Admin
  - name: reward-chain-client
    x-displayName: Клиент
  - name: offer-chain-admin
    x-displayName: Admin
  - name: offer-chain-client
    x-displayName: Клиент
  - name: clan-reward-chain-client
    x-displayName: Клиент кланов
  - name: upsell-admin
    x-displayName: Admin
  - name: upsell-client
    x-displayName: Клиент
  - name: connector-admin
    x-displayName: Admin
  - name: daily-chain-admin
    x-displayName: Admin
  - name: daily-chain-client
    x-displayName: Клиент
x-tagGroups:
  - name: АТРИБУТЫ ТОВАРА
    tags:
      - attribute-admin
  - name: ПЕРСОНАЛИЗАЦИЯ
    tags:
      - personalized-catalog
  - name: БАНДЛЫ
    tags:
      - bundles-admin
      - bundles-catalog
  - name: КОРЗИНА И ОПЛАТА
    tags:
      - cart-client-side
      - cart-server-side
      - payment-client-side
      - payment-server-side
      - order
      - free-item
  - name: ОБЩИЕ
    tags:
      - common-webhooks
      - common-pre-orders
      - common-merchant
      - common-catalog
      - common-regions
  - name: ИГРОВЫЕ КЛЮЧИ
    tags:
      - game-keys-catalog
      - game-keys-entitlement
      - game-keys-admin
  - name: АКЦИИ
    tags:
      - promotions-common
      - promotions-coupons
      - promotions-promo-codes
      - promotions-unique-catalog-offers
      - promotions-discounts
      - promotions-bonuses
      - promo-code-user-limits-admin
      - coupon-user-limits-admin
  - name: ВИРТУАЛЬНЫЕ ПРЕДМЕТЫ И ВАЛЮТА
    tags:
      - virtual-items-currency-admin
      - virtual-items-currency-catalog
      - virtual-payment
  - name: ЛИМИТЫ
    tags:
      - user-limits-admin
  - name: ЦЕПОЧКИ НАГРАД И ПРИЗОВЫЕ БАЛЛЫ
    tags:
      - reward-chain-value-points-admin
      - reward-chain-client
      - clan-reward-chain-client
  - name: ЦЕПОЧКИ ПРЕДЛОЖЕНИЙ
    tags:
      - offer-chain-admin
      - offer-chain-client
  - name: ЕЖЕДНЕВНЫЕ ЦЕПОЧКИ
    tags:
      - daily-chain-admin
      - daily-chain-client
  - name: UPSELL
    tags:
      - upsell-admin
      - upsell-client
  - name: ИМПОРТ ТОВАРОВ
    tags:
      - connector-admin
