# 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

{% hint style="warning" %}

## **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.
  {% endhint %}