> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Customers

> Customer profiles, wallet credits, affiliates, and the support inbox.

Every buyer who completes an order on your shop gets a customer profile. From the **Customers**
tab you can see their order history, lifetime value, contact them through the inbox, credit
their wallet, promote them to an affiliate, or block them.

## What's on a customer profile

* Order history with status and amount per order.
* Lifetime value across all gateways combined.
* Contact details: email, name, phone, country, city, postal code, and linked Discord ID.
* Current wallet balance and transaction history.
* Affiliate status (if enrolled) with referral count and commission earnings.

## Wallet (store credit)

You can credit a customer's wallet from the customer detail page. Use it for:

* Refunding orders as credit instead of cash (cheaper for you, sticky for the buyer).
* Promotional gifts, win-back campaigns, apology credits.
* Affiliate commissions paid out as store credit instead of crypto.

Wallet balances have configurable expiry (off by default). The shop-wide settings live at
**Settings → Payments → Store Credit** — toggle refunds-as-credit, default expiry days, and
the per-customer balance cap.

Transaction types in the wallet ledger: `CREDIT`, `DEBIT`, `REFUND`, `PROMO`, `ADJUSTMENT`,
`PAYMENT`, `EXPIRED`. The ledger is immutable.

## Affiliates

Any customer can become an affiliate of your shop. Configure the program from **Marketing →
Rewards** (or directly from a customer's profile under **Customers → Affiliate**):

* **Affiliate revenue** — toggle on, then set the percent affiliates earn on referred sales.
* **Customer discount** — toggle on, then set the percent off the affiliate's referral link
  gives to buyers.
* **Custom link approval** — whether you manually approve custom affiliate links.

Affiliates request payouts from their customer dashboard. You approve from the **Affiliates**
section of yours. Payouts can settle to crypto or to the customer's wallet on your store
(converted-to-credit).

## Blocking customers

If a customer is fraudulent or abusive, block them from **Security → Blocked**
(`/security/blocked`), or directly from the customer's row action menu. Block by:

* Email
* IP / IP range
* Country
* Domain (in their email)
* ASN
* ISP
* City
* Crypto wallet address

Use the narrowest match that catches the abuse. Whole-country bans are blunt; ASN or IP-range
bans are usually what you want for a repeat offender.

<Card title="Next: Support tickets" href="/merchants/customers/tickets">
  How the support inbox works.
</Card>