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="/ja/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)に従った2文字の大文字の国名コード。[エクソーラがサポートする国](https://developers.xsolla.com/ja/doc/shop-builder/references/supported-countries/)と[国を決定するプロセス](https://developers.xsolla.com/ja/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: >-
        カートに表示される商品価格の通貨。[ISO4217
        規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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: アイテムSKU。
      in: path
      name: item_sku
      required: true
      schema:
        example: booster_mega_1
        type: string
    item_sku_59080-path-param:
      description: アイテムSKU。
      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に基づく小文字の2文字言語コード。
      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: バンドルSKU。
      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: ユーザーのメールアドレス。
      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: バリューポイントSKU。
      in: path
      name: value_point_sku
      required: true
      schema:
        example: value_point_3
        type: string
    virtual_currency_package_sku-path-param:
      description: 仮想通貨パッケージ SKU。
      in: path
      name: virtual_currency_package_sku
      required: true
      schema:
        example: crystal-pack
        type: string
    virtual_currency_sku-path-param:
      description: 仮想通貨SKU。
      in: path
      name: virtual_currency_sku
      required: true
      schema:
        example: crystal
        type: string
    x-user-for-header:
      description: >-
        ユーザー識別子は、エクソーラログインユーザーJWTまたは[ペイステーションアクセストークン](https://developers.xsolla.com/ja/ja/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/ja/
                  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/ja/
                  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: ユーザーの支払いプロセスと決済UIを構成するための設定。
                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: >-
                  注文価格の通貨。3文字の通貨コード[ISO4217
                  規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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: ユーザーの支払いプロセスと決済UIを構成するための設定。
                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: >-
                  注文価格の通貨。3文字の通貨コード[ISO4217
                  規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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: ユーザーの支払いプロセスと決済UIを構成するための設定。
                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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                example: game_1
                maxLength: 255
                minLength: 1
                pattern: ^[a-zA-Z0-9_\-–.]*$
                type: string
              unit_items:
                description: 異なるDRMに対応したゲームキー。
                items:
                  description: ゲームキーアイテム。特定のプラットフォーム（steam、gogなど）のゲームを表します。
                  properties:
                    attributes:
                      $ref: '#/components/schemas/Game-Keys_admin-attributes'
                    drm_sku:
                      description: DRMユニーク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: >-
                              商品価格の通貨。3文字のコード[ISO4217
                              規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.Xsolla.com/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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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: アイテムSKU。
                      type: string
                  type: object
                nullable: true
                type: array
              condition:
                description: >-
                  プロモーションを適用するために、購入に含める必要があるアイテムのセット。このパラメータが`null`である場合、プロジェクト内のすべての購入にプロモーションが適用されます。
                items:
                  properties:
                    sku:
                      default: elven_sword
                      description: アイテムSKU。
                      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: アイテムSKU。
                      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: >-
                  JSON形式のデータを含むファイルのURL。ファイルは、一般に公開されているストレージサービスにホストされている必要があります。ファイルテンプレートは、パブリッシャーアカウントでの[ストア
                  > 仮想アイテム > カタログ管理 >
                  アイテムをインポート（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は、クーポンを使用してプロモーションを作成する際にエクソーラによって生成されます。
                            type: integer
                          sku:
                            description: クーポンSKU、クーポンを使用してプロモーションを作成する際にエクソーラによって生成されます。
                            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。これは、アイテムを作成する際にエクソーラによって生成されます。
                            example: 1
                            type: integer
                          order_item_id:
                            description: 注文のアイテム ID。これは、注文作成中にエクソーラによって生成されます。
                            type: integer
                          price:
                            description: アイテム価格。
                            nullable: true
                            properties:
                              amount:
                                description: 割引後のアイテム価格。
                                example: '30'
                                type: string
                              amount_without_discount:
                                description: 割引なしのアイテム価格。
                                example: '30'
                                type: string
                              currency:
                                description: >-
                                  [ISO4217](https://en.wikipedia.org/wiki/ISO_4217)形式の3文字コードの仮想通貨のSKU。[エクソーラがサポートする通貨](https://developers.xsolla.com/ja/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/ja/doc/shop-builder/features/regional-restrictions/)を参照してください。
                            nullable: true
                            type: integer
                          sku:
                            description: >-
                              作成時に指定されたアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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: >-
                            [ISO4217](https://en.wikipedia.org/wiki/ISO_4217)形式の3文字コードの実際通貨または仮想通貨のSKU。[エクソーラがサポートする通貨](https://developers.xsolla.com/ja/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)に従った2文字の大文字の国名コード。[エクソーラがサポートする国](https://developers.xsolla.com/ja/doc/shop-builder/references/supported-countries/)の詳細情報については、ドキュメントを確認してください。
                          example: US
                          type: string
                        email:
                          description: >-
                            [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/ja/api/shop-builder/operation/admin-create-region/)ときに指定された国のリストと照合されます。地域販売制限の詳細については、[ドキュメント](https://developers.xsolla.com/ja/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: >-
                  GMT+3タイムゾーンでのインポート操作完了のタイムスタンプ。エラーによりインポートが中断され、アイテムがインポートされなかった場合は、空の文字列が返されます。
                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: 特定のアイテムSKUのインポート結果とインポートエラーに関するデータを含むオブジェクト。
                properties:
                  errors_by_sku:
                    description: 特定のアイテムSKUのインポートエラーに関するデータを含むオブジェクトの配列。
                    items:
                      properties:
                        error_code:
                          description: 特定のアイテムSKUのインポートエラーコード。
                          example: 1001
                          type: integer
                        error_message:
                          description: 特定のアイテムSKUのインポートエラーの説明。
                          example: Something went wrong
                          type: string
                        sku:
                          description: インポートされたアイテムのSKU。
                          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: 認証ヘッダーが送信されていません。
    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)
                                による3文字コード。
                              example: USD
                              type: string
                          type: object
                        quantity:
                          description: アイテム数量。
                          example: 1
                          type: integer
                        sku:
                          description: >-
                            一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                          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)
                          による3文字コード。
                        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: 注文に使用する仮想通貨SKU。
                        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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                example: game_1
                type: string
              type:
                description: アイテムタイプ。 この場合、それは常に`unit`です。
                example: unit
                type: string
              unit_items:
                description: 異なるDRMに対応したゲームキー。
                items:
                  description: ゲームキーアイテム。特定のプラットフォーム（steam、gogなど）のゲームを表します。
                  properties:
                    drm_id:
                      description: DRM内部の一意のID。
                      example: 1
                      type: integer
                    drm_image:
                      description: ゲームキーDRMのアイコン。
                      example: >-
                        https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                      nullable: true
                      type: string
                    drm_name:
                      description: ゲームキーDRMの名称。
                      example: Steam
                      type: string
                    drm_sku:
                      description: DRMユニーク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)に基づく2文字コード。
                            example: US
                            nullable: true
                            type: string
                          currency:
                            description: >-
                              商品価格通貨。[ISO
                              4217](https://en.wikipedia.org/wiki/ISO_4217)
                              による3文字コード。
                            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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      example: game_1
                      type: string
                    type:
                      description: アイテムタイプ。 この場合、それは常に`unit`です。
                      example: unit
                      type: string
                    unit_items:
                      description: 異なるDRMに対応したゲームキー。
                      items:
                        description: ゲームキーアイテム。特定のプラットフォーム（steam、gogなど）のゲームを表します。
                        properties:
                          attributes:
                            $ref: '#/components/schemas/Game-Keys_admin-attributes'
                          drm_id:
                            description: DRM内部の一意のID。
                            example: 1
                            type: integer
                          drm_image:
                            description: ゲームキーDRMのアイコン。
                            example: >-
                              https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png
                            nullable: true
                            type: string
                          drm_name:
                            description: ゲームキーDRMの名称。
                            example: Steam
                            type: string
                          drm_sku:
                            description: DRMユニーク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)に基づく2文字コード。
                                  example: US
                                  nullable: true
                                  type: string
                                currency:
                                  description: >-
                                    商品価格通貨。[ISO
                                    4217](https://en.wikipedia.org/wiki/ISO_4217)
                                    による3文字コード。
                                  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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                                  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: DRM 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: DRM名。
                      example: Steam
                      type: string
                    redeem_instruction_link:
                      description: 引き換えに関する説明のリンク。
                      example: https://support.us.playstation.com
                      type: string
                    sku:
                      description: >-
                        一意のDRM
                        ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      example: steam
                      type: string
                  type: object
                type: array
            type: object
      description: DRMのリストが正常に受信されました。
    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: DRM名。
                      example: Steam
                      type: string
                    drm_sku:
                      description: >-
                        一意のDRM
                        ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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)
                            による3文字コード。
                          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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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: 仮想通貨アイテムSKU。
                            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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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: DRM名。
                            example: Steam
                            type: string
                          drm_sku:
                            description: >-
                              一意のDRM
                              ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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)
                                  による3文字コード。
                                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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                            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: 仮想通貨アイテムSKU。
                                  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: 認証ヘッダーが送信されていません。
    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)
                            による3文字コード。
                          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: アイテムSKU。
                            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)
                            による3文字コード。
                          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: 認証ヘッダーが送信されていません。
    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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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)
                            による3文字コード。
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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: 仮想通貨アイテムSKU。
                            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: 外部グループ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: 親外部グループID。
                                  example: background
                                  nullable: true
                                  type: string
                              type: object
                            type: array
                          description:
                            description: グループの説明。
                            example: Background description
                            type: string
                          external_id:
                            description: 外部グループ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: 親外部グループID。
                            example: hair
                            nullable: true
                            type: string
                        type: object
                      type: array
                    description:
                      description: グループの説明。
                      example: Hair description
                      type: string
                    external_id:
                      description: 外部グループ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: 親外部グループID。
                      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)
                      による3文字コード。
                    example: USD
                    type: string
                type: object
              promotions:
                $ref: '#/components/schemas/Catalog_item_promotions'
              sku:
                description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                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: 仮想通貨アイテムSKU。
                      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)
                            による3文字コード。
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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: 仮想通貨アイテムSKU。
                            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)
                            による3文字コード。
                          example: USD
                          type: string
                      type: object
                    promotions:
                      $ref: '#/components/schemas/Catalog_item_promotions'
                    sku:
                      description: >-
                        一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                      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: 仮想通貨アイテムSKU。
                            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`を使用してアイテムのバンドルを作成し、バンドルに含まれるアイテムの SKU を指定します。
         `partner_side_content`を使用して空のバンドルを作成し、[ウェブフック](https://developers.xsolla.com/ja/ja/webhooks/operation/personalized-partner-catalog/)を使用してユーザー側でアイテムを追加します。このタイプは、[パートナー側でのカタログ個人用設定](https://developers.xsolla.com/ja/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: >-
                  商品価格の通貨。3文字のコード[ISO4217
                  規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)。
                example: USD
                type: string
            type: object
          quantity:
            description: パッケージ内のアイテムの数量。
            example: 250
            type: integer
          sku:
            description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ダッシュ、およびアンダースコアのみが含まれます。
            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: 仮想通貨アイテムSKU。
                  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) による3文字コード。
      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: |-
              アイテム名。キーと値のペアを含める必要があり、
              キーは "^[a-z]" 書式のロケール{2}で、値は文字列です。
            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)に基づく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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
      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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
            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: 仮想通貨アイテムSKU。
            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)に従った2文字の大文字の国名コード。[エクソーラがサポートする国](https://developers.xsolla.com/ja/doc/shop-builder/references/supported-countries/)の詳細情報については、ドキュメントを確認してください。<br>例：`country=US`
          example: US
          maxLength: 2
          minLength: 2
          type: string
        currency:
          description: >-
            カートに表示されるアイテム価格の通貨。[ISO4217規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                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: ユーザーが決済UIで国を変更できるかどうか。
              example: false
              type: boolean
            value:
              description: >-
                [ISO 3166-1
                alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)に従った2文字の大文字の国名コード。`X-User-Ip`ヘッダーにIPアドレスが渡されない場合は必須です。[エクソーラがサポートする国](https://developers.xsolla.com/ja/ja/doc/shop-builder/references/supported-countries/)の詳細情報については、ドキュメントを確認してください。<br>例：`country=US`
              example: US
              type: string
          type: object
        email:
          properties:
            value:
              description: ユーザーのメールアドレス。RFC822プロトコルに基づく有効である必要があります。
              format: email
              maxLength: 255
              minLength: 3
              type: string
          type: object
        id:
          properties:
            value:
              description: >-
                ユーザーID。テストでは、任意の値を渡すことができます。実際の支払いを受け入れるには、システムのユーザーID値を使用する必要があります。このIDは[ユーザー認証](https://developers.xsolla.com/ja/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)に従って大文字2文字の国コードを使用します。
              type: string
            name:
              description: 法人のフルネームです。
              type: string
            vat_id:
              description: 納税者個別のID。
              type: string
          type: object
        name:
          properties:
            value:
              description: ユーザーのスクリーンネーム。
              maxLength: 255
              minLength: 1
              type: string
          type: object
        phone:
          properties:
            allow_modify:
              default: false
              description: >-
                ユーザーが決済UIで電話を変更できるかどうか。トークンに `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: 一意の追跡ID（マーケティングキャンペーンで使用）。
              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>

        このフィールドを通じて追加のパラメータを渡すことで、不正対策フィルターを設定することができます。[ペイステーションに関するドキュメントンをご覧ください](https://developers.xsolla.com/ja/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: ユーザーが自動的に戻り先URLにリダイレクトされるまでの遅延期間。
          example: 0
          type: integer
        redirect_button_caption:
          description: ローカライズされたリダイレクトボタンのキャプション。
          example: Text button
          type: string
        redirect_conditions:
          description: ユーザーがリターンURLにリダイレクトする引き金となる決済状態。
          enum:
            - none
            - successful
            - successful_or_canceled
            - any
          example: none
          type: string
        status_for_manual_redirection:
          description: ユーザーをリターン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)に従った3文字の通貨コード。[エクソーラがサポートする通貨](https://developers.xsolla.com/ja/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: >-
        インターフェース言語。小文字の2文字[言語コード](https://developers.xsolla.com/ja/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`に設定します。この場合、https://sandbox-secure.xsolla.comを使用してテスト決済UIにアクセスします。
      type: boolean
    Cart-Payment_settings_ui:
      additionalProperties: false
      description: インターフェイス設定。
      properties:
        currency_format:
          description: >-
            `code`に設定すると、決済UIに3 文字の[ISO
            4217](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)通貨コードが表示されます。
            デフォルトでは、3文字の通貨コードの代わりに通貨記号が表示されます。
          type: string
        desktop:
          additionalProperties: false
          description: デスクトップ版のインターフェース設定。
          properties:
            header:
              additionalProperties: false
              description: ヘッダー設定。
              properties:
                close_button:
                  default: false
                  description: >-
                    デスクトップ決済UIに**閉じる**ボタンを表示するかどうか。このボタンは決済UIを閉じて、`settings.return_url`パラメータで指定した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>ペイステーション
                    > 設定セクション</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: >-
            モバイル版の決済UIを開いた時のカート内のアイテムリストの表示。`true`の場合、リストは拡張ビューで表示されます。`false`（デフォルト）またはパラメータが渡されない場合、リストは折りたたまれたビューで表示されます。
          type: boolean
        is_independent_windows:
          default: false
          description: 埋め込みランチャーのブラウザ（WebView）から、ユーザーのデフォルトのブラウザにリダイレクトして購入させるかどうか。
          type: boolean
        is_payment_methods_list_mode:
          default: false
          description: >-
            決済UIを開く際に、ユーザーの国で利用可能な決済方法のリストを表示するかどうか。`false`の場合（デフォルト）、`settings.payment_method`パラメータで渡された決済方法、または[PayRankアルゴリズム](https://developers.xsolla.com/ja/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セキュア検証が新しいブラウザウィンドウで開くかどうか。セットアップでコンテンツセキュリティポリシー（CSP）が適用される場合は、`true`に設定します。
          type: boolean
        layout:
          description: >-
            決済UIの主要要素の位置。ゲーム内で決済UIを開いたり、注文や決済方法に関する情報の列を入れ替えたりすることができます。詳細については、[カスタマイズに関する説明](https://developers.xsolla.com/ja/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: >-
                    モバイル決済UIに**閉じる**ボタンを表示するかどうか。このボタンは決済UIを閉じて、`settings.return_url`パラメータで指定したURLにリダイレクトします。
                  type: boolean
              type: object
          type: object
        mode:
          description: >-
            決済UIのインターフェースモード。`user_account`のみに指定できます：ヘッダーにはユーザーアカウントのナビゲーションメニューのみが含まれています。ユーザーは商品を選択したり、決済を行うことはできません。このモードは、デスクトップ上でのみ使用できます。
          enum:
            - user_account
          type: string
        theme:
          default: 63295a9a2e47fab76f7708e1
          description: >-
            決済UIのテーマ。ライトテーマ（デフォルト）の場合は`63295a9a2e47fab76f7708e1`、ダークテーマの場合は`63295aab2e47fab76f7708e3`を指定できます。[カスタムテーマを作成](https://developers.xsolla.com/ja/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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                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タイムスタンプ）。
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
              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タイムスタンプ）。
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
              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: 一意のDRM 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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
              example: game_01
              type: string
            type:
              description: >-
                アイテムタイプ：`virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`。
              example: unit
              type: string
            unit_items:
              description: >-
                アイテムにユニットタイプがある場合は、ユニット内のすべてのアイテムが含まれます。ほとんどの場合、ユーザーはそのうちの1つをクーポンボーナスとして選択する必要があります。
              items:
                properties:
                  drm_name:
                    description: DRM名。
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      一意のDRM
                      ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    example: steam
                    type: string
                  is_free:
                    type: boolean
                  name:
                    description: アイテム名。
                    example: Game name
                    type: string
                  sku:
                    description: >-
                      一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    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: アイテムSKU。
                type: string
            type: object
          nullable: true
          type: array
        condition:
          description: >-
            プロモーションを適用するために、購入に含める必要があるアイテムのセット。このパラメータが`null`である場合、プロジェクト内のすべての購入にプロモーションが適用されます。
          items:
            properties:
              sku:
                default: elven_sword
                description: アイテムSKU。
                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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
              example: game_01
              type: string
            type:
              description: >-
                アイテムタイプ：`virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`。
              example: unit
              type: string
            unit_items:
              description: >-
                アイテムにユニットタイプがある場合は、ユニット内のすべてのアイテムが含まれます。ほとんどの場合、ユーザーはそのうちの1つをプロモーションコードボーナスとして選択する必要があります。
              items:
                properties:
                  drm_name:
                    description: DRM名。
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      一意のDRM
                      ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    example: steam
                    type: string
                  is_free:
                    $ref: '#/components/schemas/value-is_free'
                  name:
                    description: アイテム名。
                    example: Game name
                    type: string
                  sku:
                    description: >-
                      一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    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: アイテムSKU。
            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: アイテムSKU。
            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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
            example: game_01
            type: string
          type:
            description: >-
              アイテムタイプ：`virtual_good`/`virtual_currency`/`bundle`/`physical_good`/`unit`。
            example: unit
            type: string
          unit_items:
            description: >-
              アイテムにユニットタイプがある場合は、ユニット内のすべてのアイテムが含まれます。ほとんどの場合、ユーザーはそのうちの1つをプロモーションコードボーナスとして選択する必要があります。
            items:
              properties:
                drm_name:
                  description: DRM名。
                  example: Steam
                  type: string
                drm_sku:
                  description: 一意のDRM ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                  example: steam
                  type: string
                name:
                  description: アイテム名。
                  example: Game name
                  type: string
                sku:
                  description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                  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: >-
                ユーザーが購入できるアイテムの総数。この数値はパブリッシャーアカウントで設定するか、ストアエンティティ（制限オブジェクト）の管理者エンドポイントを使用して設定することができます。
              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: |-
        ユーザーが選択したリワード。
        オブジェクトのキーはユニットのSKUで、値はユニット内の1つのアイテムのSKUです。
      example:
        game_1: game_1_steam
        game_2: game_2_playstation
      type: object
    Promotions_sku:
      description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
      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: ユニークカタログオファー使用後に利用可能なアイテムSKUリスト。
      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)に従った2文字の大文字の国名コード。

        [エクソーラがサポートする国](https://developers.xsolla.com/ja/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: アイテムSKUの配列。
          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: アイテムSKUの空の配列
          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)
                による3文字コード。
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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: 仮想通貨アイテムSKU。
                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`の場合、バリューポイントが使用されているリワードチェーンが1つ以上あるため、バリューポイントを削除することはできません。バリューポイントを削除するには、、それを含むすべての報酬チェーンを[削除](https://developers.xsolla.com/ja/ja/api/shop-builder/operation/admin-delete-reward-chain/)します。


            `true`の場合、バリューポイントはどのリワードチェーンでも使用されないので、[削除](https://developers.xsolla.com/ja/ja/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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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: |-
              アイテム名。キーと値のペアを含める必要があり、
              キーは "^[a-z]" 書式のロケール{2}で、値は文字列です。
            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)に基づく2文字コード。
            example: US
            nullable: true
            type: string
          currency:
            description: >-
              商品価格の通貨。3文字のコード[ISO4217
              規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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: >-
                商品価格の通貨。3文字のコード[ISO4217
                規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)。
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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: 仮想通貨アイテムSKU。
                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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
      example: bundle_1
      type: string
    Virtual-Items-Currency_sku:
      description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
      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: >-
                商品価格の通貨。3文字のコード[ISO4217
                規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)。
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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: 仮想通貨アイテムSKU。
                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。SKUには、小文字と大文字のラテン英数字、ダッシュ、およびアンダースコアのみが含まれます。
                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: >-
                商品価格の通貨。3文字のコード[ISO4217
                規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/doc/pay-station/references/supported-currencies/)。
              example: USD
              type: string
          type: object
        promotions:
          $ref: '#/components/schemas/Catalog_item_promotions'
        sku:
          description: 一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
          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: 仮想通貨アイテムSKU。
                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)に従った2文字の大文字の国名コード。[エクソーラがサポートする国](https://developers.xsolla.com/ja/doc/shop-builder/references/supported-countries/)の詳細情報については、ドキュメントを確認してください。<br>例：`country=US`
            example: US
            type: string
          currency:
            description: >-
              商品価格の通貨。3文字のコード[ISO4217
              規格](https://en.wikipedia.org/wiki/ISO_4217)詳細については、ドキュメントを参照してください。[エクソーラでサポートされている通貨](https://developers.xsolla.com/ja/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: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
              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: アイテムSKU。
                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 = 毎時間
          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タイムスタンプ）。
                  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_week:
                  description: 制限が更新される曜日。1は月曜日、7は日曜日です。`weekly`制限更新期間タイプは`null`のみではありません。
                  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タイムスタンプ）。
                  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: >-
                    制限が更新される月の日。月の残り時間が短いために選択された日がない場合、更新はその月の最終日に行われます。`monthly`制限更新期間タイプは`null`のみではありません。
                  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タイムスタンプ）。
                  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/ja/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`の場合、このアイテムの購入制限は`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとに更新されます。
                  maximum: 10000
                  minimum: 1
                  type: integer
                interval_type:
                  description: 定期更新期間のタイプ。
                  enum:
                    - hourly
                  type: string
                reset_next_date:
                  description: 制限が更新された日時（UNIXタイムスタンプ）。
                  example: 1677553200
                  type: integer
              title: interval_type = 毎時間
              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: >-
        チェーンがすべてのユーザーに表示されるかどうか：

        * `true`の場合、ユーザーの認証ステータスや属性に関係なく常にチェーンが表示されます。

        *
        `false`の場合、個人用設定されたチェーンが見つからない場合にのみチェーンが表示されます。例えば、ユーザーが認証されていない場合や、その属性がパーソナライズされたチェーンと一致しない場合などです。


        パーソナライズされたチェーンのコンテキストでのみ適用され、`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タイムスタンプ）。
                  example: 1677553200
                  type: integer
              type: object
            total:
              description: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
              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: ロイヤリティポイントsku。
                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: これはデイリー報酬で設定されたステップ数です。ここでの各ステップは、デイリー報酬における1日を表します。
      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: >-
          `date_start`に基づき、24時間ごとに次のステップの報酬を解除します。進行は順序通りです。前の報酬が受け取られるまでは、新しい報酬は解除されません。ユーザーが1日以上スキップした場合でも、中断したところから再開します。ミスした日に対して複数の報酬が付与されることはありません。
        rolling_unskippable: >-
          `date_start`に基づき、24時間ごとに次のステップの報酬を解除します。進行は順序通りです。前の報酬が受け取られるまでは、新しい報酬は解除されません。ただし、ユーザーが1日でもスキップした場合、進行状況はリセットされ、最初のステップからやり直す必要があります。
    daily_chain_update_step_id:
      description: デイリー報酬ステップの一意識別子。更新時に指定することで、このステップにおけるユーザーの進捗を保持できます。
      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: >-
        アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：`en`）または5文字のロケールコード（例：`en-US`）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：`en`と`en-US`）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、[ドキュメント](/ja/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>例えば、報酬チェーンは2024年3月1日01:00（クアラルンプール時間）から毎月リセットされます。報酬チェーンが次回にリセットされる日時：2024年4月1日01:00（クアラルンプール時間）。これは、<a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>のフォーマットで`2024-04-01T01:00:00+08:00`に相当します。
        <br><br>例：`2024-04-01T01:00:00+08:00`
      format: date-time
      type: string
    displayable_reset_start_date:
      description: >-
        報酬チェーンが最初にリセットされた日時。<br><br>例えば、報酬チェーンが最初にリセットされた日時は、2024年3月1日01:00（クアラルンプール時間）、または<a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>フォーマットで「`2024-03-01T01:00:00+08:00`」です。
        <br><br>例：`2024-03-01T01:00:00+08:00`
      format: date-time
      type: string
    drm_name:
      description: ゲームキーDRMの名称。
      example: Steam
      type: string
    drm_sku:
      description: DRMユニークID。
      example: steam
      type: string
    excluded_promotions:
      description: このプロモーションを適用する際に除外するプロモーションIDのリスト。<br>Example：`[12, 789]`
      example:
        - 12
        - 789
      items:
        type: integer
      type: array
    five-letter-locale:
      description: 5文字のロケールコード。
      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: スペイン語（スペイン）
          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: ポルトガル語（ブラジル）
          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オブジェクト。属性により、アイテムを使用するために必要なプレイヤーのレベルなど、より詳細な情報をアイテムに追加することができます。属性はゲームの内部ロジックを豊かにし、専用の「取得」メソッドやウェブフックからアクセスできます。
      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>

        ユーザーのカート内の各アイテムの価格は、条件で指定された価格帯と比較されます。[ボーナス](/ja/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request)と[ディスカウント](/ja/api/shop-builder/operation/create-promo-code/#!path=discount&t=request)は、カート内のアイテムのうち、価格が条件を満たすものにのみ適用されます。<br>

        この配列を渡す場合は、[discounted_items](/ja/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: このグループの一意の識別子。通常、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: 購入制限に達した場合、その制限がリセットされるまで、カタログ取得のAPIコールにおいて該当アイテムは返されません。
        show: >-
          購入制限に達した後も、カタログ取得のAPIコールにおいて該当アイテムは返されます。

          クライアント側のカタログ取得APIコールでは、制限に達すると、該当アイテムは `can_be_bought: false`
          フラグが付与された状態で返されます。

          次回の制限リセット日は`reset_next_date`に返されます。
    limit_per_item:
      description: グローバルアイテム制限。
      example: 10
      nullable: true
      type: integer
    limit_per_user:
      anyOf:
        - type: 'null'
        - description: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
          example: 5
          type: integer
        - description: 詳細な購入制限の設定。
          properties:
            limit_exceeded_visibility:
              $ref: '#/components/schemas/limit_exceeded_visibility'
            total:
              description: 1ユーザーあたりのユーザーが購入できるアイテムの最大数。
              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: >-
        アイテムの長文説明のローカライズを含むオブジェクト。2文字の小文字の言語コード（例：`en`）または5文字のロケールコード（例：`en-US`）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のバリアント（例：`en`と`en-US`）が提供された場合、最後に提供された値が保存されます。サポートされている言語の完全なリストは、[ドキュメント](/ja/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: 該当SKUに設定されたデイリー報酬ステップの数量
          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: >-
        アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：`en`）または5文字の言語コード（例：`en-US`）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：`en`と`en-US`）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、[ドキュメント](/ja/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><br>例えば、毎月のオファーチェーンのリセットがクアラルンプール時間の2024年3月1日午前1時に開始される場合、次のリセットはクアラルンプール時間の2024年4月1日午前1時に行われます。これは、<a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>の形式で`2024-04-01T01:00:00+08:00`に相当します。<br><br>例：`2024-04-01T01:00:00+08:00`
      format: date-time
      type: string
    offer_chain_displayable_reset_start_date:
      description: >-
        オファーチェーンが最初にリセットされた日時。<br><br>例えば、クアラルンプール時間2024年3月1日午前1時に予定されている最初のリセットは、<a
        href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO
        8601</a>形式で`2024-03-01T01:00:00+08:00`
        に相当します。<br><br>例：`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/ja/api/shop-builder/operation/admin-create-offer-chain/#!path=date_start&t=request">date_start</a>パラメータから開始されます。<br><br>
        例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval =
        2`の場合、オファーチェーンは`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
      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 = 毎時間
          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 = 毎時間
          type: object
      type: object
    offer_chain_reset_next_date:
      description: >-
        計算されたオファーチェーンが次回にリセットされる日時<a
        href="https://en.wikipedia.org/wiki/Unix_time"
        target="_blank">Unixタイムスタンプ形式</a>。<br><br>例えば、毎月のオファーチェーンのリセットがクアラルンプール時間（GMT+8）の2024年3月1日午前1時に開始される場合、次のリセットはクアラルンプール時間（GMT+8）の2024年4月1日午前1時に行われます。これは、GMT+0の2024年3月31日17時に相当し、Unixタイムスタンプ形式では`1711904400000`となります。<br><br>例：`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) による3文字コード。
      example: USD
      type: string
    offer_chain_time:
      description: >-
        オファーチェーンがリセットされる、指定されたタイムゾーンでの時間（時間に丸められます）。<br><br>例えば、リセット時間がクアラルンプールタイムゾーン（GMT+8）の01:00に設定されている場合、`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 = 毎日
      type: object
    per_user_hourly_bundle:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                制限がリセットされるまでの時間間隔。 <br><br> カウントダウンは<a
                href="https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-bundle/#!path=periods/date_from&t=request">date_from</a>パラメータから開始されます。<br><br>
                例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval
                =
                2`の場合、アイテムの購入制限は`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = 毎時間
      type: object
    per_user_hourly_vc:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                制限がリセットされるまでの時間間隔。 <br><br> カウントダウンは<a
                href="https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-virtual-currency/#!path=periods/date_from&t=request">date_from</a>パラメータから開始されます。<br><br>
                例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval
                =
                2`の場合、アイテムの購入制限は`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = 毎時間
      type: object
    per_user_hourly_vcp:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                制限がリセットされるまでの時間間隔。 <br><br> カウントダウンは<a
                href="https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-virtual-currency-package/#!path=0/periods/date_from&t=request">date_from</a>パラメータから開始されます。<br><br>
                例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval
                =
                2`の場合、アイテムの購入制限は`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = 毎時間
      type: object
    per_user_hourly_vi:
      properties:
        hours_interval:
          allOf:
            - $ref: '#/components/schemas/hours_interval'
            - description: >-
                制限がリセットされるまでの時間間隔。 <br><br> カウントダウンは<a
                href="https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-virtual-item/#!path=periods/date_from&t=request">date_from</a>パラメータから開始されます。<br><br>
                例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval
                =
                2`の場合、アイテムの購入制限は`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
        interval_type:
          $ref: '#/components/schemas/interval_type_hourly'
      required:
        - interval_type
        - hours_interval
      title: interval_type = 毎時間
      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: 指定された報酬チェーンの終了日。 有効期間が1つだけ指定されている場合に限り、`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: >-
        クラン報酬チェーンツールチップポップアップウィンドウのヘッダーのローカライズ付きオブジェクト。
        小文字の2文字[言語コード](https://developers.xsolla.com/ja/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: >-
        クラン報酬チェーンツールチップポップアップウィンドウに関する説明のローカライズ付きオブジェクト。
        小文字の2文字[言語コード](https://developers.xsolla.com/ja/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>
        プロモーションは、価格が配列内のすべての条件を満たすアイテムにのみ適用されます。この配列を渡す場合は、[条件](/ja/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>
        プロモーションは、価格が配列内のすべての条件を満たすアイテムにのみ適用されます。この配列を渡す場合は、[アイテム](/ja/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: 各オブジェクトは、価格があるべきルールを説明しています。
      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>

        ユーザーのカート内の全アイテムの合計価格が、条件で指定された価格範囲と比較されます。[ボーナス](/ja/api/shop-builder/operation/create-promo-code/#!path=bonus&t=request)と[割引](/ja/api/shop-builder/operation/create-promo-code/#!path=discount&t=request)は、カートの価格が指定された条件を満たす場合に、カート内のすべてのアイテムに適用されます。<br>

        この配列を渡す場合は、[discounted_items](/ja/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: >-
                制限が更新される月の日。月の残り時間が短いために選択された日がない場合、更新はその月の最終日に行われます。`monthly`制限更新期間タイプは`null`のみではありません。
              maximum: 31
              minimum: 1
              nullable: true
              type: integer
            day_of_week:
              description: 制限が更新される曜日。1は月曜日、7は日曜日です。`weekly`制限更新期間タイプは`null`のみではありません。
              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タイムスタンプ）。
              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 = 毎時間
        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 = 毎時間
          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タイムスタンプ</a>。<br><br>例えば、報酬チェーンは2024年3月1日01:00（クアラルンプール時間
        GMT+8）から毎月リセットされます。報酬チェーンが次回にリセットされる日時：2024年4月1日01:00（クアラルンプール時間
        GMT+8）。これは、2024年3月31日17:00
        GMT+0またはUnixタイムスタンプのフォーマットで`1711904400000`に相当します。
        <br><br>例：`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/ja/api/shop-builder/operation/admin-create-reward-chain/#!path=0/date_start&t=request">date_start</a>パラメータから開始されます。<br><br>
        例えば、 `date_start = "2025-11-15T18:15:00+05:00"`かつ`hours_interval =
        2`の場合、報酬チェーンは`"2025-11-15T20:15:00+05:00"`から開始して2時間ごとにリセットされます。
      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`の場合、ユーザーが全てのステップを完了した時点でデイリー報酬がリセットされ、ステップ1から再度開始できるようになります。繰り返しは、`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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
      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>例えば、報酬チェーンのリセットの設定時間は、クアラルンプールのタイムゾーン
        (GMT+8) の 01:00 です。この場合、`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。ユーザーIDは、ユーザーをエクソーラログインプロジェクトにリンクするために使用され、ニックネームとして表示されます。[ユーザーID](https://developers.xsolla.com/ja/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth)経由での認証を使用している場合は、[ウェブフック応答](https://developers.xsolla.com/ja/webhooks/operation/user-validation-in-webshop/)で<code>name</code>パラメータを渡すことをお勧めします。このパラメータには、ニックネームとして使用されるユーザー名が含まれています。
          example: Rocket
          type: string
      type: object
    total_promotions_count:
      description: プロモーションの合計数。
      type: integer
    two-letter-locale:
      description: 2文字の小文字の言語コード。
      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: スペイン語（スペイン）
          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: アイテムSKU。
                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: アイテムSKU。
                    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: アイテムSKU。
                    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: >-
        ゲーム付きカートを販売する場合、[認証なしでエンドポイントを呼び出すこと](/ja/doc/buy-button/how-to/set-up-authentication/#guides_buy_button_selling_items_not_authenticated_users)ができます。


        そのためには：


        * ゲームのヘッダーの`x-unauthorized-id`パラメータに一意の識別子を追加します。

        * ゲームのヘッダーで`x-user`パラメータ（Base64でエンコードされた）にユーザーのメールアドレスを追加します。


        デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer
        eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。


        [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。
      scheme: bearer
      type: http
    XsollaLoginUserJWT:
      bearerFormat: JWT
      description: >-
        デフォルトでは、エクソーラログインユーザートークン（Bearerトークン）が認証に使用されます。テスト用のエクソーラログインユーザートークンでこのエンドポイントを呼び出すことができます：`Bearer
        eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI`。


        [ペイステーションアクセストークン](https://developers.xsolla.com/ja/api/pay-station/operation/create-token/)を代用として使用することができます。
      scheme: bearer
      type: http
    basicAuth:
      description: >-
        エクソーラのAPIは基礎アクセス認証を使用します。APIへのすべてのリクエストは

        `Authorization: Basic <your_authorization_basic_key>`

        ヘッダーを含む必要があり、`your_authorization_basic_key`はBase64標準に従ってエンコードされた`project_id:api_key`

        ペアです。


        必要に応じて、`project_id`の代わりに`merchant_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/ja/api/getting-started/#api_keys_overview)を参照してください。
      scheme: basic
      type: http
    basicMerchantAuth:
      description: >-
        エクソーラAPIはベーシックアクセス認証を使用します。APIへのすべてのリクエストは`Authorization: Basic
        <your_authorization_basic_key>`ヘッダーを含む必要があり、`your_authorization_basic_key`はBase64標準に従ってエンコードされた`merchant_id:api_key`ペアです。


        [パブリッシャーアカウント](https://publisher.xsolla.com/)に移動して、パラメータの値を確認します：


        * `merchant_id`が表示されます：
          * **会社設定 > 会社**セクションで
          * 任意のパブリッシャーアカウントページのブラウザアドレスバーにあるURL。URLは以下の形式です：`https://publisher.xsolla.com/<merchant_id>`
        *
        `api_key`は、作成時に一度だけパブリッシャーアカウントに表示され、お客様側で保存する必要があります。新しいキーは、次のセクションで作成することができます：
          * **会社設定 > APIキー**
          * **プロジェクト設定 > APIキー**

        APIキーの操作に関する詳細は、[APIリファレンス](https://developers.xsolla.com/ja/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コールでは、APIまたはPublisher Account
        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: >-
        指定したURLを介してJSONファイルからストアにアイテムをインポートします。JSONファイルからのインポートの詳細については、[ドキュメント](https://developers.xsolla.com/ja/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: 現在のカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。
      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: カートIDによるカートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。
      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コールには、<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: 属性リストを取得する（管理者）
      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/ja/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">属性値を更新する</a>APIコールを使用してください。</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>1属性あたり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/ja/api/shop-builder/operation/admin-update-attribute-value/"
        target="_blank">属性値を更新する</a>APIコールを使用してください。</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/ja/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/ja/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>このメソッドはページ分割されたアイテムリストを返します。1
        回のレスポンスで返されるアイテム数の上限とデフォルト値は<strong>50件</strong>です。それ以上のアイテムを取得する場合は、`limit`および
        `offset` パラメータを使用して追加のページを取得してください。例：`limit = 25`、`offset =
        100`を指定した場合、全体リストの 101 件目から始まる 25 件が返されます。</div></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: 資格付与（管理者）
      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フリープラットフォームのゲームのみ取り消すことができます。</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: 資格の取り消し（管理者）
      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: ゲームリストを取得する（管理者）
      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でゲームを取得する（管理者）
      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: ゲームキーSKUによる全コードを削除します。
      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: ゲームキーSKUによる一定数のコードを取得します。
      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: ゲームキーSKUによるコードをアップロードします。
      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: SKUによるプロジェクト内のゲームを削除します。
      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: ゲームをSKUで削除
      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: ゲームを取得する（管理者）
      tags:
        - game-keys-admin
      x-badges:
        - color: '#95ff80'
          name: Server-side
        - color: '#d7dee0'
          name: Admin
    put:
      description: SKUによるプロジェクト内のゲームを更新します。
      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: SKUによるゲームを更新
      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は、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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は、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-bundle-list/)


        このエンドポイントの別名：

        * /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は、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-bundle-list/)


        このエンドポイントの別名：

        * /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は、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-bundle-list/)


        このエンドポイントの別名：

        * /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は、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-bundle-list/)


        このエンドポイントの別名：

        *
        /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: >-
        アイテムの先行予約制限を有効/無効にします。


        Pre-Order limit
        APIは、アイテムを数量限定で販売するためのAPIです。先行予約の設定は、該当するアイテムモジュールの管理セクションから行います：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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: プロジェクト内のアップセルに関する情報を取得します：アップセルが有効かどうか、アップセルのタイプ、アップセルの一部であるアイテムのSKUリスト。
      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: プロジェクトのアップセルの一部であるアイテムSKUのリスト。
                      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: 異なるDRMに対応したゲームキー。
                            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: SKUによって識別されるバリューポイントを削除します。
      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: 管理用のプロジェクト内のSKUによってバリューポイントを取得します。
      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: SKUで特定されるバリューポイントを更新します。
      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: 仮想通貨パッケージリストを取得する（管理者）
      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: 指定されたグループ外部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: |-
        SKUに基づいて、1つまたは複数のアイテムのバリューポイント数を部分的に更新します。

        バリューポイント更新の原則：
         * アイテムがまだバリューポイントを持っていない場合、`amount`フィールドにゼロ以外の値を送信すると、バリューポイントが作成されます。
         * アイテムがすでにバリューポイントを持っている場合、`amount`フィールドに 0 以外の値を送信すると、バリューポイントが更新されます。
         * `amount`が0に設定された場合、そのアイテムの既存のバリューポイントは削除されます。

         `PUT`メソッド（[アイテムにバリューポイントを設定する](https://developers.Xsolla.com/api/shop-builder/operation/admin-set-items-value-point-reward/)）とは異なり、この`PATCH`メソッドは、プロジェクト内のアイテムの既存のバリューポイントをすべて上書きするのではなく、指定されたアイテムのみを更新します。

        1 つのリクエストで最大100アイテムまで更新できます。重複するアイテム SKU を同じリクエストに含めることはできません。
      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: >-
        SKUによって1つまたは複数のアイテムにバリューポイントを割り当てます。ユーザーはこれらのアイテムを購入した後にバリューポイントを受け取ります。


        この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>すべてのプロジェクトには、1つの応答で返されるアイテム数に制限があります。デフォルトおよび最大値は<strong>1応答あたり10アイテム</strong>です。より多くのデータを取得するには、ページネーションのために<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: >-
        指定したユーザがクーポンを使用できる残り回数を取得します。


        User limit
        APIを使用すると、ユーザーがクーポンを使用できる回数を制限することができます。ユーザー制限自体の設定は、管理セクションにアクセスしてください：

        *
        [クーポン](https://developers.xsolla.com/ja/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: >-
        ユーザーが再度購入できるように、アイテムの購入制限を更新します。


        User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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: >-
        適用される制限内で、指定されたユーザーが使用できるアイテムの残りの数を減らします。


        User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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を使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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を使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.Xsolla.com/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.Xsolla.com/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.Xsolla.com/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を使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテムタイプモジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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`である場合、このコールはすべてのユーザーに対してこの制限を更新します。


        User limit APIを使用すると、アイテムを数量限定で販売できます。購入制限を構成するには、目的のアイテム タイプ モジュールの
        管理セクションに移動します：

        *
        [ゲームキー](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-create-game/)

        * [仮想アイテム &
        仮想通貨](https://developers.xsolla.com/ja/api/shop-builder/operation/admin-get-virtual-items-list/)

        *
        [バンドル](https://developers.xsolla.com/ja/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: >-
        指定したユーザがプロモーションコードを使用できる残り回数を取得します。


        User limit
        APIを使用すると、ユーザーがプロモーションコードを使用できる回数を制限することができます。ユーザー制限自体の設定は、管理セクションにアクセスしてください：

        *
        [プロモーションコード](https://developers.xsolla.com/ja/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: >-
        して、これらのプロモーションを再度使用できるため、指定されたユーザーのすべてのプロモーションのすべての制限を更新します。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.xsolla.com/ja/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.xsolla.com/ja/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: >-
        指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を減らします。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.xsolla.com/ja/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.xsolla.com/ja/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: >-
        指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を取得します。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.xsolla.com/ja/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.xsolla.com/ja/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: >-
        指定されたユーザーが適用される制限内でプロモーションを使用できる残りの回数を増やします。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.xsolla.com/ja/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.xsolla.com/ja/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: >-
        プロモーションの増減後に適用される制限の中で、指定したユーザーが利用できる回数を設定します。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.xsolla.com/ja/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.xsolla.com/ja/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`である場合、このコールはすべてのユーザーのこの制限を更新します。


        User limit API
        を使用すると、ユーザーがプロモーションを使用できる回数を制限できます。ユーザー制限自体を構成するには、目的のプロモーションタイプの管理セクションに移動します：

        *
        [割引プロモーション](https://developers.Xsolla.com/api/shop-builder/tag/promotions-discounts/)

        *
        [ボーナスプロモーション](https://developers.Xsolla.com/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: >-
        ストアのウェブフック設定に関する情報を取得します。

        詳しくは、ウェブフックの[ドキュメント](https://developers.xsolla.com/ja/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: >-
        ストアのウェブフック設定に関する情報を更新します。

        詳しくは、ウェブフックの[ドキュメント](/ja/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: >-
                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)のウェブフックが有効かどうか。


                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)
                    のウェブフックの場合、このAPIコールで指定された設定は、[プロジェクト設定 >
                    ウェブフック](https://publisher.xsolla.com/0/projects/0/edit/webhooks/)セクションのパブリッシャーアカウントで構成された設定よりも優先されます。
                  example: true
                  type: boolean
                secret:
                  description: >-
                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)のウェブフックに署名するためのプロジェクトの秘密鍵です。


                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)では、このAPIコールで指定された鍵が、[プロジェクト設定
                    >
                    ウェブフック](https://publisher.xsolla.com/0/projects/0/edit/webhooks/)セクションのパブリッシャーアカウントで生成された鍵よりも優先されます。
                  example: my_secret
                  type: string
                url:
                  description: >-
                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)のウェブフックを受信するためのサーバーのURL。URL
                    は一般にアクセス可能で、HTTPS プロトコル (`https://example.com`など)
                    を使用する必要があります。また、ウェブフックをテストするためのツールで見つけたURLを指定することもできます。


                    [ゲームサービス](/ja/webhooks/operation/successful-order-payment/)のウェブフックでは、このAPIコールで指定された設定が、[プロジェクト設定
                    >
                    ウェブフック](https://publisher.xsolla.com/0/projects/0/edit/webhooks/)セクションのパブリッシャーアカウントで構成された設定よりも優先されます。
                  example: http://site.ru/webhook
                  type: string
                version:
                  description: >-
                    ウェブフックのバージョン。バージョン`2`では、[アイテム](/ja/webhooks/operation/successful-order-payment/#!path=items&t=request)配列には、バージョン`1`（デフォルト）には存在しないパラメータ`is_free`、`is_bonus`、および`is_bundle_content`が含まれています。
                  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: カートにアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテムは渡された値で置き換えられます。
      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: カートに特定のアイテムを入れます。カートにすでに同じSKUのアイテムがある場合、既存のアイテム位置が渡された値で置き換えられます。
      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: |-
        このコードによりクーポン特典を入手します。
        ユーザーが多くのアイテムの中から1つをボーナスとして選択できるようにするために使用することができます。
        通常のケースでは、クーポンにボーナスとしてゲームが含まれている場合、DRMを選択します（`type=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>1応答あたり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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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>1応答50アイテム</strong>です。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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>1応答50アイテム</strong>です。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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/ja/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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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: 利用可能なDRMのリストを取得します。
      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: DRMリストを取得
      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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされた結果</a>のためのユーザー固有の詳細で応答の質を高めます。</div>
      operationId: get-game-key-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: アイテムSKU。
          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: DRM名。
                    example: Steam
                    type: string
                  drm_sku:
                    description: >-
                      一意のDRM
                      ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    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)
                          による3文字コード。
                        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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    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: 仮想通貨アイテムSKU。
                          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/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされた結果</a>のためのユーザー固有の詳細で応答の質を高めます。</div>
      operationId: get-game-by-sku
      parameters:
        - $ref: '#/components/parameters/project_id-path-param'
        - description: アイテムSKU。
          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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                    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: DRM名。
                          example: Steam
                          type: string
                        drm_sku:
                          description: >-
                            一意のDRM
                            ID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                          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)
                                による3文字コード。
                              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。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
                          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: 仮想通貨アイテムSKU。
                                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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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/ja/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: >-
        カタログを作成するためにSKUによる販売可能なアイテムを取得します。

        <div
        class="note"><b>注</b><br><br>このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、<a
        href="https://developers.xsolla.com/ja/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: SKUによる販売可能なアイテムを取得する
      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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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: >-
        カタログを作成するためにSKUによる仮想通貨パッケージを取得します。

        <div
        class="note"><b>注</b><br><br>このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、<a
        href="https://developers.xsolla.com/ja/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: SKUによる販売可能なアイテムを取得する
      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: >-
        カタログを作成するためにSKUによる仮想通貨を取得します。

        <div
        class="note"><b>注</b><br><br>このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、<a
        href="https://developers.xsolla.com/ja/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: SKUによる仮想通貨を取得する
      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>1応答50アイテム</strong>です。ページごとに多くのデータを取得するには、<b>制限</b>と<b>オフセット</b>フィールドを使用します。</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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: >-
        クライアント側での検索のために、すべての仮想アイテムのリストを取得します。


        <div
        class="notice"><strong>注意</strong><br><br>アイテムのSKU、名前、グループ、および説明のみを返します</div>
        <br> <div
        class="note"><b>注意事項</b><br><br>アイテムカタログAPIコールの利用は、認証なしで可能ですが、<a
        href="https://developers.xsolla.com/ja/doc/shop-builder/features/personalization/"
        target="_blank">パーソナライズされたカタログ</a>を取得するには、「認証」ヘッダーにユーザーのJWTを渡す必要があります。</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>1応答50アイテム</strong>です。ページごとにさらに多くのデータを取得するには、「<b>制限</b>」と「<b>オフセット</b>」フィールドを使用します。</div>
        <br> <div
        class="note"><b>注</b><br><br>このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、<a
        href="https://developers.Xsolla.com/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: >-
        カタログを作成するためにSKUによる仮想アイテムを取得します。

        <div
        class="note"><b>注</b><br><br>このエンドポイントは認証なしでアクセスでき、一般的なデータを返します。しかし、認証は、利用可能なユーザー制限やプロモーションのような、<a
        href="https://developers.xsolla.com/ja/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: SKUによる仮想アイテムを取得する
      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は、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。


        決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：`https://secure.xsolla.com/paystation4/?token={token}`で`{token}`受信したトークン。


        テスト目的には、以下のリンクを使用してください：`https://sandbox-secure.xsolla.com/paystation4/?token={token}`。


        <div
        class="notice"><strong>注意</strong><br><br>このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、<a
        href="https://developers.xsolla.com/ja/doc/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は、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。


        決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：`https://secure.xsolla.com/paystation4/?token={token}`で`{token}`受信したトークン。


        テスト目的には、以下のリンクを使用してください：`https://sandbox-secure.xsolla.com/paystation4/?token={token}`。


        <div
        class="notice"><strong>注意</strong><br><br>このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、<a
        href="https://developers.xsolla.com/ja/doc/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は、ユーザーの国を決定するために使用され、注文に対応する通貨と利用可能な決済方法を適用するために使用されます。


        決済UIを新しいウィンドウで開くには、以下のリンクをご利用ください：`https://secure.xsolla.com/paystation4/?token={token}`で`{token}`受信したトークン。


        テスト目的には、以下のリンクを使用してください：`https://sandbox-secure.xsolla.com/paystation4/?token={token}`。


        <div
        class="notice"><strong>注意</strong><br><br>このメソッドはIPを使用してユーザーの国を決定し、注文の通貨を選択するため、このメソッドはクライアント側からのみ使用し、サーバー側からは使用しないことが重要です。サーバー側からこの方法を使用すると、通貨が正しく判定されず、<a
        href="https://developers.xsolla.com/ja/doc/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/ja
                    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: |-
        このコードによりプロモーションコードの特典を入手します。
        ユーザーが多くのアイテムの中から1つをボーナスとして選択できるようにするために使用することができます。
        通常のケースでは、プロモーションコードにボーナスとしてゲームが含まれている場合、DRMを選択します（`type=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。これは認証時にエクソーラに送信されるIDで、ユーザーをエクソーラログインプロジェクトにリンクします。
                      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>このメソッドはページ分割されたアイテムリストを返します。1
        回のレスポンスで返されるアイテム数の上限とデフォルト値は<strong>50件</strong>です。それ以上のアイテムを取得する場合は、`limit`および
        `offset` パラメータを使用して追加のページを取得してください。例：`limit = 25`、`offset =
        100`を指定した場合、全体リストの 101 件目から始まる 25 件が返されます。</div></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>すべてのプロジェクトには、1つの応答で返されるアイテム数に制限があります。デフォルトおよび最大値は<strong>1応答50アイテム</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`の注文ステータスになります。


        新しいウィンドウで決済UIを開くには、以下のリンクを使用してください：`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/ja/doc/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>1応答あたり50アイテム</strong>です。ページごとにより多くのデータを取得するには、<b>LIMIT</b>と<b>OFFSET</b>フィールドを使用してください。</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/ja/doc/shop-builder/features/coupons/)を削除します。削除されたプロモーション：

        * プロジェクトで設定されたプロモーションのリストから消えます。

        * アイテムカタログに適用されなくなります。


        削除後、プロモーションを復元することはできません。

        削除されたプロモーションのクーポンコードは、既存のプロモーションに[追加する](https://developers.xsolla.com/ja/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: >-
        注文とその支払いトークンを生成します。注文はリクエストボディに渡されたアイテムに基づいて生成されます。


        決済UIを新しいウィンドウで開くには、次のリンクを使用します：`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>パラメータは、注文の通貨を選択するために使用されます。ユーザーの国が不明な場合は、
        <code>X-User-Ip</code>ヘッダーにユーザーのIPを指定することもできます。<br>この方法の正しい動作には、これら2つのオプションのいずれかが必要です。<br>選択した通貨は、<a
        href="https://developers.xsolla.com/ja/doc/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/ja/doc/shop-builder/features/promo-codes/)を削除します。削除されたプロモーション：

        * プロジェクトで設定されたプロモーションのリストから消える。

        * アイテムカタログとカートに適用されなくなる。


        削除後、プロモーションを復元することはできません。

        削除されたプロモーションのプロモーションコードを既存のプロモーションに[追加](https://developers.xsolla.com/ja/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/ja/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/ja/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: アイテムSKU。
                          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>1応答あたり10アイテム</strong>です。ページごとにより多くのデータを取得するには、<b>LIMIT</b>と<b>OFFSET</b>フィールドを使用してください。</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/ja/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: 管理者
  - description: >-
      ユーザー属性に応じたルールを指定することができるAPIです。

      ユーザーが具体的なルールの条件をすべて満たした場合、パーソナライズされたアイテムが表示されます。


      パーソナライズされたプロモーションについては、[プロモーションセクション](/ja/api/shop-builder/tag/promotions-discounts)を参照してください。


      購入前に属性を渡すには、[Xsolla Login
      API](/ja/api/login/operation/update-users-attributes-from-server/)を使うか、[Pay
      Station
      API](/ja/api/pay-station/operation/create-token)を使ってトークンを生成する際にそれをuser.attributesプロパティに渡します。
    name: personalized-catalog
    x-displayName: 個人用カタログ
  - name: bundles-admin
    x-displayName: 管理者
  - name: bundles-catalog
    x-displayName: カタログ
  - 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: カタログ
  - name: game-keys-catalog
    x-displayName: カタログ
  - name: game-keys-entitlement
    x-displayName: 資格
  - name: game-keys-admin
    x-displayName: 管理者
  - 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: 管理者
  - name: virtual-items-currency-catalog
    x-displayName: カタログ
  - 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: 管理者
  - name: reward-chain-client
    x-displayName: クライアント
  - name: offer-chain-admin
    x-displayName: 管理者
  - name: offer-chain-client
    x-displayName: クライアント
  - name: clan-reward-chain-client
    x-displayName: クランクライアント
  - name: upsell-admin
    x-displayName: 管理者
  - name: upsell-client
    x-displayName: クライアント
  - name: connector-admin
    x-displayName: 管理者
  - name: daily-chain-admin
    x-displayName: 管理者
  - 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: アップセル
    tags:
      - upsell-admin
      - upsell-client
  - name: アイテムインポート
    tags:
      - connector-admin
