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 | Awaiting a payment method, or payment-method recovery in progress — new payments are paused |
cancelled | Customer has been deactivated |
A customer goes on hold in two situations: when they were created with a payment method still to be collected (e.g. you chose Email the customer, or haven’t yet completed Collect Payment Details), or when an existing plan’s payment method fails and needs replacing. In the recovery case, a recovery email is sent automatically. In both cases the customer returns to active automatically once a payment method is successfully collected — no manual change is needed.
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"