Viewing Customers
Customer list
Navigate to Customers in the sidebar to see all customers for your account. The list is paginated and sorted by creation date by default.
Search fields:
- Name
- Reference (your internal identifier)
- External reference ID (
cus_xxx) - Custom attribute values
Customer detail
Click any customer to open their detail view, which shows:
- Core fields — name, email, reference, status, currency, timezone
- Contact details — phone numbers, billing address, shipping address
- Payment instruments — saved cards and bank accounts
- Payment plans — active and historical plans
- Payment history — all payment intents associated with this customer
- Activity log — a record of all changes to the customer record
Customer statuses
| Status | Description |
|---|---|
active | Customer is in good standing |
hold | Payment method recovery in progress — new payments are paused |
cancelled | Customer has been deactivated |
A customer on hold has one or more payment plans that failed and need a new payment method. Recovery emails are sent automatically when this status is triggered.
External reference ID
The external reference ID (cus_xxx) is the stable identifier for a customer across the API:
curl https://staging-api.elasticpay.co/api/v1/customers/cus_0abc123def456 \ -H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"