Manage customers

Customers are created automatically when checkout succeeds with an email. The Customers page shows lifetime spend, payment count, and MRR contribution from active subscriptions.

Identifiers

Each customer has a public ID (cus_...). Emails are unique per merchant account within each mode (Sandbox vs Live). Repeat purchases with the same email in the same mode update the existing customer rather than creating duplicates. The same email can exist once in Sandbox and once in Live.

Revenue metrics

MRR / ARR reflect active subscriptions. Projected metrics include trialing subscriptions expected to convert. Use these for dashboards; treat them as operational, not audited GAAP figures.

Free trials

A customer email may complete only one free trial per mode. After that, new subscription checkouts with trial_days bill the normal recurring price. See Subscriptions.

Related objects

Payments and subscriptions reference the customer. Refunds and plan changes do not delete the customer record. Listen for customer.created when provisioning accounts in your app.

GET /v1/customers/cus_...
Authorization: Bearer rk_live_...

{
  "id": "cus_...",
  "email": "buyer@example.com",
  "total_spent": 14900,
  "payment_count": 3
}