Customer Management

mavi pay automatically creates a customer record every time someone makes a purchase. The customer management section of your dashboard gives you a complete view of who your customers are, what they have bought, and how to manage their subscriptions.

Customer Profiles

Each customer profile is identified by their email address and contains:

• Email -- The email used at checkout.
• Name -- If provided during checkout.
• Country -- Detected from the payment method.
• Created date -- When the customer first purchased from you.
• Lifetime value -- Total revenue from this customer across all orders.
• Active benefits -- Currently active entitlements (license keys, downloads, Discord access, custom).

View all customers in your merchant dashboard under Customers.

Order History

Each customer profile includes a full order history:

Click any order to view full details, including payment method, Stripe payment ID, and webhook delivery status.

Subscription Management

For customers with active subscriptions, you can:

• View subscription status -- Active, past due, cancelled, or expired.
• View billing history -- All invoices and payment attempts for the subscription.
• Cancel a subscription -- End the subscription at the end of the current billing period. The customer retains access to benefits until the period ends.
• Revoke immediately -- Cancel and revoke benefit access immediately, without waiting for the period to end. Use this for policy violations or fraud.

Customers can also manage their own subscriptions through the customer portal. A link to the portal is included in their confirmation email and can be accessed from any receipt.

Customer Portal

mavi pay provides a hosted customer portal where your customers can:

• View their purchase history.
• Access active benefits (download files, view license keys).
• Manage their subscriptions (cancel, update payment method).
• Download invoices and receipts.

The portal URL is unique per customer and is included in every order confirmation email.

Searching and Filtering

The customer list supports:

• Search by email or name.
• Filter by product purchased, subscription status, or date range.
• Sort by lifetime value, most recent order, or creation date.

Exporting Customer Data

Export your customer list as CSV from the dashboard. The export includes:

• Email, name, country
• Lifetime value
• Number of orders
• Active subscriptions
• Subscription status

This is useful for email marketing, accounting, and GDPR data requests.

GDPR Compliance

mavi pay is operated from Belgium and is fully GDPR compliant. As a merchant, you are the data controller for your customers' personal data. mavi pay acts as a data processor.

You can:

• Export a customer's data at any time to fulfil a data access request (GDPR Article 15).
• Delete a customer's personal data to fulfil a data erasure request (GDPR Article 17). Order records are anonymised but retained for financial reporting obligations.

API Access

Manage customers programmatically via the API:

# List all customers
curl -H "Authorization: Bearer <your-api-key>" \
  https://api.mavifinans.sh/api/v1/customers

# Get a specific customer
curl -H "Authorization: Bearer <your-api-key>" \
  https://api.mavifinans.sh/api/v1/customers/<customer-id>

Customer data is also included in webhook payloads for order and subscription events.

Next Steps

• Set up products to start building your catalogue.
• Attach benefits to deliver value to your customers automatically.
• Review your finances to track revenue per customer.