Customer Metafields

When a member is created in our system, Inveterate adds values to Shopify customer metafields. These metafields make it easier to reference membership-related data on the storefront (or in integrations).

All customer metafields below use:

• Namespace: inveterate

• Owner type: CUSTOMER

Metafields

(Inveterate) Balance

Metafield

• Namespace: inveterate

• Key: balance

• Type: number_decimal

Description This field is the store credits balance of the customer. This number indicates the amount of store credits they have received, but have not yet redeemed.

---

(Inveterate) Next Payment

Metafield

• Namespace: inveterate

• Key: next_payment

• Type: single_line_text_field

Description This field displays the next payment date for the customer's membership. It is stored in ISO format (e.g. 2026-02-05).

---

(Inveterate) Referrals

Metafield

• Namespace: inveterate

• Key: referrals

• Type: single_line_text_field

Description This field displays a list of all completed referrals made by the member.

---

(Inveterate) Experience Segment

Metafield

• Namespace: inveterate

• Key: segment_id

• Type: single_line_text_field

Description This field stores the member’s Experience Segment identifier.

---

(Inveterate) Payment Amount

Metafield

• Namespace: inveterate

• Key: payment_amount

• Type: single_line_text_field

Description This field displays the amount the member has agreed to pay for the membership.

---

(Inveterate) Payment Currency

Metafield

• Namespace: inveterate

• Key: payment_amount_currency

• Type: single_line_text_field

Description This field displays the currency for the member’s membership payment amount (for example, USD).

---

(Inveterate) Credits Earned

Metafield

• Namespace: inveterate

• Key: credits_earned

• Type: number_decimal

Description This field stores the total amount of credits earned by the member

Usage Notes

• These metafields may be surfaced in Inveterate webhook payloads depending on the event type.

• Availability and values are managed automatically by Inveterate based on membership activity.

• Metafields may not be populated for customers who are not members.