Klanten

Beheer de factureerbare gebruikers van je app. Bekijk klanten via het tabblad Dashboard > Commerce > Customers of via de SDK.

Een klant is de entiteit in je app die wordt gefactureerd — doorgaans een gebruiker, een organisatie of een project. Je maakt er één aan in Proyecta zodra de bijbehorende entiteit bestaat in je eigen database, en slaat vervolgens de teruggegeven id op zodat je er later naar kunt verwijzen.

Het tabblad Customers

Open Dashboard > Commerce en schakel over naar Customers om alle factureerbare klanten van de huidige app te zien. Elke rij toont:

• E-mailadres
• Volledige naam
• Aanmaakdatum

Een zoekvak en filtering op e-mailadres of aanmaakdatum zijn beschikbaar via de SDK; uitgebreidere besturingselementen in het paneel komen eraan.

SDK

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

Aanmaken

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

Ophalen

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

Bijwerken

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

Veelvoorkomende patronen

Maak een Proyecta-klant aan wanneer een gebruiker zich registreert

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.

Bouw een beheerderspagina voor klantbeheer

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.

Veelgestelde vragen

Moet ik voor elke gebruiker een Proyecta-klant aanmaken, of alleen voor betalende gebruikers?

Maak er één aan voor elke gebruiker. Het is gratis, idempotent (aanroepen met hetzelfde e-mailadres retourneren dezelfde klant), en zorgt ervoor dat je er klaar voor bent op het moment dat een gebruiker upgradet — zonder dat je achteraf gegevens hoeft aan te vullen.

Kan een klant meerdere abonnementen hebben?

Ja. Abonnementen horen bij klanten, niet andersom. Gebruik commerce.checkout() om een nieuwe checkout-sessie voor een abonnement aan te maken.

Hoe zie ik waar een klant op geabonneerd is?

Momenteel: via het ingebedde Stripe-dashboard of door commerce.check() aan te roepen voor elke functie die je wilt controleren. Een weergave van abonnementsgeschiedenis in het paneel staat op de roadmap.