# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.inveterate.com/dev/stack-reference-docs/customer-metafields.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.