Clients

Gérez les utilisateurs facturables de votre app dans l’onglet Dashboard > Commerce > Customers ou via le SDK.

Un client est l’entité de votre app qui est facturée — généralement un utilisateur, une organisation ou un projet. Vous en créez un dans Proyecta dès que l’entité correspondante existe dans votre propre base de données, puis vous stockez l’id retourné pour pouvoir y faire référence ultérieurement.

L’onglet Customers

Ouvrez Dashboard > Commerce et basculez vers Customers pour voir tous les clients facturables de l’app actuelle. Chaque ligne affiche :

• L’adresse e-mail
• Le nom complet
• La date de création

Une barre de recherche et un filtrage par e-mail ou date de création sont disponibles via le SDK ; des contrôles plus avancés dans le panneau sont prévus prochainement.

SDK

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

Créer

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

Lire

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

Mettre à jour

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

Cas d’usage courants

Créer un client Proyecta lors de l’inscription d’un utilisateur

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.

Construire une interface d’administration pour parcourir les clients

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

Dois-je créer un client Proyecta pour chaque utilisateur, ou seulement pour ceux qui paient ?

Créez-en un pour chaque utilisateur. C’est gratuit, idempotent (des appels avec le même e-mail retournent le même client) et vous permet d’être prêt dès qu’un utilisateur passe à un plan supérieur — sans avoir à tout reconstituer à la hâte.

Un client peut-il avoir plusieurs abonnements ?

Oui. Les abonnements appartiennent aux clients, et non l’inverse. Utilisez commerce.checkout() pour créer une nouvelle session de checkout d’abonnement.

Comment voir à quoi un client est abonné ?

Actuellement : via le dashboard Stripe intégré ou en appelant commerce.check() pour chaque fonctionnalité qui vous intéresse. Un historique des abonnements dans le panneau est prévu dans la roadmap.