Skip to main content

MyCustomerTier

The buyer's current customer-tier status for the active outlet: effective tier, its discount %, this month's spend, and progress to the next tier. Drives the loyalty TierCard. Tier resolution matches the price the buyer is actually charged.

type MyCustomerTier {
  autoTieringEnabled: Boolean!
  locked: Boolean!
  monthlySpend: Float!
  nextTierDiscountPercentage: Float
  nextTierName: String
  nextTierThreshold: Float
  remainingToNextTier: Float
  tierDiscountPercentage: Float!
  tierKey: String!
  tierName: String!
  tierThreshold: Float!
}

Fields

`MyCustomerTier.autoTieringEnabled` ● `Boolean!` non-null scalar

Whether auto-tiering is enabled for this organization.

`MyCustomerTier.locked` ● `Boolean!` non-null scalar

Whether this customer is manually pinned to a tier (auto-tiering skips them).

`MyCustomerTier.monthlySpend` ● `Float!` non-null scalar

Current calendar-month order total (drives auto-tiering).

`MyCustomerTier.nextTierDiscountPercentage` ● `Float` scalar

Discount % the next tier unlocks (e.g. 15 for Diamond).

`MyCustomerTier.nextTierName` ● `String` scalar

Name of the next tier up, if any.

`MyCustomerTier.nextTierThreshold` ● `Float` scalar

Monthly-spend threshold of the next tier.

`MyCustomerTier.remainingToNextTier` ● `Float` scalar

Spend remaining to reach the next tier.

`MyCustomerTier.tierDiscountPercentage` ● `Float!` non-null scalar

Discount % applied by this tier (0 when the tier has no scheme).

`MyCustomerTier.tierKey` ● `String!` non-null scalar

Effective tier key (e.g. GOLD).

`MyCustomerTier.tierName` ● `String!` non-null scalar

Display name of the effective tier (e.g. Gold).

`MyCustomerTier.tierThreshold` ● `Float!` non-null scalar

This tier's OWN spend floor — the lower bound of a current-tier-to-next-tier progress bar.

Returned By

myCustomerTier query

Fields
Returned By