Customers

Manage the billable users of your app. Browse customers in the Admin > Commerce > Customers tab.

A customer is the entity in your app that gets charged — usually a user, an organization, or a project. You create one in Proyecta as soon as the corresponding entity exists in your own database, then store the returned id so you can reference it later.

The Customers tab

Open Admin > Commerce and switch to Customers to see every billable customer for the current app. Each row shows:

• Email
• Full name
• When they were created

Richer search and filtering controls in the panel are coming.

You don’t normally create customers yourself — a record is written automatically when someone checks out. Use the Customers tab to look them up, edit their details, and grant access.

Common patterns

These are prompts, not code — describe what you want and the AI builds it:

Add an account page where a signed-in customer can see their past orders
and the details we hold on them.

On the order confirmation page, show the customer their order number and
email them a copy of the receipt.

FAQ

Should I create a Proyecta customer for every user, or only paying ones?

Create one for every user. It’s free, idempotent (calls with the same email return the same customer), and means you’re ready the moment a user upgrades — no scrambling to backfill.

Can a customer have multiple subscriptions?

Yes. Subscriptions belong to customers, not the other way around — start another checkout to create a new subscription.

How do I see what a customer is subscribed to?

Today: through the embedded Stripe dashboard, or by checking each feature you care about with useEntitlement(). A subscription history view in the panel is on the roadmap.