Clientes

Administra los usuarios facturables de tu app. Explora clientes en la pestaña Dashboard > Commerce > Customers o mediante el SDK.

Un cliente es la entidad en tu app a la que se le cobra — generalmente un usuario, una organización o un proyecto. Lo creas en Proyecta en cuanto la entidad correspondiente existe en tu propia base de datos y luego almacenas el id devuelto para poder referenciarlo más adelante.

La pestaña Customers

Abre Dashboard > Commerce y cambia a Customers para ver todos los clientes facturables de la app actual. Cada fila muestra:

• Correo electrónico
• Nombre completo
• Cuándo fueron creados

Un cuadro de búsqueda y filtrado por correo electrónico o fecha de creación están disponibles a través del SDK; controles más completos en el panel están por venir.

SDK

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

Crear

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

Leer

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

Actualizar

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

Patrones comunes

Crear un cliente en Proyecta cuando un usuario se 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.

Construir un navegador de clientes para administradores

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.

Preguntas frecuentes

¿Debo crear un cliente en Proyecta para cada usuario o solo para los que pagan?

Crea uno para cada usuario. Es gratuito, idempotente (las llamadas con el mismo correo electrónico devuelven el mismo cliente) y significa que estarás listo en el momento en que un usuario haga upgrade — sin necesidad de correr a rellenar datos retroactivamente.

¿Puede un cliente tener múltiples suscripciones?

Sí. Las suscripciones pertenecen a los clientes, no al revés. Usa commerce.checkout() para crear una nueva sesión de checkout de suscripción.

¿Cómo veo a qué está suscrito un cliente?

Por ahora: a través del dashboard de Stripe integrado o llamando a commerce.check() para cada feature que te interese. Una vista del historial de suscripciones en el panel está en el roadmap.