Kunder

Hantera de fakturerbara användarna i din app. Bläddra bland kunder under fliken Dashboard > Commerce > Customers eller via SDK:n.

En kund är den enhet i din app som debiteras — vanligtvis en användare, en organisation eller ett projekt. Du skapar en i Proyecta så snart motsvarande enhet finns i din egen databas och lagrar sedan det returnerade id:t så att du kan referera till det senare.

Fliken Customers

Öppna Dashboard > Commerce och växla till Customers för att se alla fakturerbara kunder för den aktuella appen. Varje rad visar:

• E-postadress
• Fullständigt namn
• När de skapades

En sökruta och filtrering på e-postadress eller skapandedatum är tillgängliga via SDK:n; mer avancerade kontroller i panelen är på väg.

SDK

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

Skapa

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',
    },
});

Läsa

// 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);
}

Uppdatera

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

Vanliga mönster

Skapa en Proyecta-kund när en användare registrerar sig

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.

Bygg en adminvy för kunder

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.

Vanliga frågor

Ska jag skapa en Proyecta-kund för varje användare, eller bara för betalande?

Skapa en för varje användare. Det är gratis, idempotent (anrop med samma e-postadress returnerar samma kund) och innebär att du är redo i samma ögonblick som en användare uppgraderar — utan att behöva fylla i uppgifter i efterhand.

Kan en kund ha flera prenumerationer?

Ja. Prenumerationer tillhör kunder, inte tvärtom. Använd commerce.checkout() för att skapa en ny checkout-session för en prenumeration.

Hur ser jag vad en kund prenumererar på?

För närvarande: via den inbäddade Stripe-dashboarden eller genom att anropa commerce.check() för varje funktion du bryr dig om. En vy för prenumerationshistorik i panelen finns på roadmapen.