Kunden

Verwalte die zahlungspflichtigen Nutzer deiner App. Sieh dir Kunden im Tab Dashboard > Commerce > Customers an oder nutze das SDK.

Ein Kunde ist die Entität in deiner App, die belastet wird – in der Regel ein Nutzer, eine Organisation oder ein Projekt. Du erstellst einen Kunden in Proyecta, sobald die entsprechende Entität in deiner eigenen Datenbank vorhanden ist, und speicherst die zurückgegebene id, um später darauf verweisen zu können.

Der Customers-Tab

Öffne Dashboard > Commerce und wechsle zu Customers, um alle zahlungspflichtigen Kunden der aktuellen App zu sehen. Jede Zeile zeigt:

• E-Mail-Adresse
• Vollständiger Name
• Erstellungszeitpunkt

Eine Suchfunktion sowie die Filterung nach E-Mail-Adresse oder Erstellungsdatum stehen über das SDK zur Verfügung; umfangreichere Steuerelemente im Panel sind in Planung.

SDK

import Proyecta from '@proyecta-ai/sdk';
const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY });

Erstellen

const customer = await proyecta.commerce.customers.create({
    email: 'alice@example.com',
    name: 'Alice Liddell',
    phone: '+14155551234', // E.164 format
    address: {
        line1: '123 Wonderland Ave',
        city: 'San Francisco',
        state: 'CA',
        postal_code: '94110',
        country: 'US',
    },
});

Lesen

// Single customer
const customer = await proyecta.commerce.customers.get({ customerId: 'cus_123' });

// Paginate
const result = await proyecta.commerce.customers.list({ limit: '20' });
for (const customer of result.data) {
    console.log(customer.name, customer.email);
}

Aktualisieren

await proyecta.commerce.customers.update({ customerId: 'cus_123', email: 'new@example.com', address: { ... } });

Häufige Anwendungsfälle

Einen Proyecta-Kunden beim Registrieren eines Nutzers erstellen

When a new user finishes signup, call proyecta.commerce.customers.create
with their email and name. Store the returned id on the user record as
proyecta_customer_id.

Ein Admin-Kundenbrowser-Interface aufbauen

Build an admin page at /admin/customers that lists every Proyecta customer
with their email, name, created date, and a link to view their detail page.
Use proyecta.commerce.customers.list to paginate through all customers.

FAQ

Soll ich für jeden Nutzer einen Proyecta-Kunden anlegen oder nur für zahlende?

Lege einen für jeden Nutzer an. Es ist kostenlos, idempotent (Aufrufe mit derselben E-Mail-Adresse geben denselben Kunden zurück) und stellt sicher, dass du bereit bist, sobald ein Nutzer ein Upgrade durchführt – kein hektisches Nachpflegen von Daten.

Kann ein Kunde mehrere Abonnements haben?

Ja. Abonnements gehören zu Kunden, nicht umgekehrt. Verwende commerce.checkout(), um eine neue Abonnement-Checkout-Session zu erstellen.

Wie sehe ich, welche Abonnements ein Kunde hat?

Derzeit: über das eingebettete Stripe-Dashboard oder durch den Aufruf von commerce.check() für jedes Feature, das dich interessiert. Eine Abonnementverlaufsansicht im Panel ist für die Zukunft geplant.