---
title: "MemberLevel"
description: "客户的会员等级信息。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/member-level'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/member-level.md'
---
# MemberLevel

客户的会员等级信息。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `levelCode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  该客户当前等级的编码。
  
  最大长度限制：25

* `levelName`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  该客户当前的等级名称。
  
  最大长度限制：25

* `membershipType`

  [MembershipType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/membership-type.md)

  该客户当前等级的会员类型。

* `levelOrder`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  等级序号。`level_order`越大，等级越高级，等级顺序越靠后。

* `levelIcon`

  [String](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  等级`icon`。

* `upgradeStandard`

  [UpgradeStandard](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/upgrade-standard.md)

  客户通过购买普通商品（包含购买礼品卡）达成升级条件时，系统执行升级的标准类型。
  仅当 `membershipType` = `BASIC` 或 `DUAL` 时有效。

* `levelThreshold`

  [UnsignedInt64](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/unsigned-int-64.md)

  客户通过消费升级会员等级时，所需达到的门槛金额。仅当 `membershipType` 为 `BASIC` 或 `DUAL` 时有效。该字段的值为店铺币种金额乘以 100 后的数值。<br/>例如，升级门槛金额为 10 美元，该字段值为 `1000`。

* `lockinStandard`

  [LockinStandard](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/lockin-standard.md)

  商家配置了保级的规则时，消费者通过消费升级后的保级标准类型。
  仅当 `membershipType` = `BASIC` 或 `DUAL` 时有效。

* `lockinRule`

  [UnsignedInt64](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/unsigned-int-64.md)

  商家配置保级的规则后，客户满足保级条件时需要消费的具体金额。仅当 `membershipType` = `BASIC` 或 `DUAL` 时有效。

* `paidPrice`

  [[LevelSkuInfo]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/level-sku-info.md)

  客户升级方式为消费升级时，付费升级时需要达成的付费价格。当`membership_type` = `PAID` 或 `DUAL` 时有效。

* `paidExpiryDateType`

  [PaidExpiryDateType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/paid-expiry-date-type.md)

  付费会员有效期的时间类型。

* `paidExpiryDateValue`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  付费会员有效期的时间值。

* `upgradePaidPriceSpu`

  [UpgradePaidPriceSpu](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/upgrade-paid-price-spu.md)

  可升级等级的会员通过付费升级时需要达成的付费价格区间，仅当该等级绑定付费会员商品为多款式商品时有效。
  处于`upgrade_level_code` 等级的客户支付 `upgrade_paid_price` 可升级。
  仅当 `membership_ype` = `PAID` 或 `DUAL`  ，且`paid_upgrade_standard`=`CUSTOMISED`时有效。

* `upgradePaidPriceSku`

  [[UpgradePaidPriceSku]](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/upgrade-paid-price-sku.md)

  可升级等级的会员通过付费升级时需要达成的付费价格，仅当该等级绑定付费会员商品仅有单个商品款式时有效。
  处于`upgrade_level_code`等级的客户支付`upgrade_paid_price`可升级。
  仅当 `membership_ype` = `PAID` 或 `DUAL`，且`paid_upgrade_standard`=`CUSTOMISED`时有效。

* `paidUpgradeStandard`

  [PaidUpgradeStandard](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/paid-upgrade-standard.md)

  客户通过付费购买会员时，系统执行升级的标准类型。
  仅当 `membershipType` = `PAID` 或 `DUAL` 时有效。

## Field from

* [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/queries/store-membership-type.md).storeMembershipType