Clienti

Gestisci gli utenti fatturabili della tua app. Sfoglia i clienti nel tab Dashboard > Commerce > Customers o tramite l’SDK.

Un cliente è l’entità della tua app a cui vengono addebitati i costi — di solito un utente, un’organizzazione o un progetto. Ne crei uno in Proyecta non appena l’entità corrispondente esiste nel tuo database, quindi salvi l’id restituito per poterlo referenziare in seguito.

Il tab Customers

Apri Dashboard > Commerce e passa a Customers per vedere tutti i clienti fatturabili dell’app corrente. Ogni riga mostra:

• Email
• Nome completo
• Data di creazione

Una casella di ricerca e il filtraggio per email o data di creazione sono disponibili tramite l’SDK; controlli più avanzati nel pannello sono in arrivo.

SDK

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

Creazione

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

Lettura

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

Aggiornamento

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

Pattern comuni

Crea un cliente Proyecta quando un utente si registra

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.

Costruisci un pannello di amministrazione per sfogliare i clienti

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.

Domande frequenti

Devo creare un cliente Proyecta per ogni utente, o solo per quelli a pagamento?

Creane uno per ogni utente. È gratuito, idempotente (le chiamate con la stessa email restituiscono lo stesso cliente) e ti assicura di essere pronto nel momento in cui un utente effettua l’upgrade — senza dover recuperare i dati in modo affrettato.

Un cliente può avere più abbonamenti?

Sì. Gli abbonamenti appartengono ai clienti, non il contrario. Usa commerce.checkout() per creare una nuova sessione di checkout per un abbonamento.

Come posso vedere a cosa è abbonato un cliente?

Al momento: tramite la dashboard Stripe integrata o chiamando commerce.check() per ciascuna funzionalità che ti interessa. Una vista con lo storico degli abbonamenti nel pannello è nella roadmap.