Clientes

Gerencie os usuários faturáveis do seu app na aba Dashboard > Commerce > Customers ou via SDK.

Um cliente é a entidade no seu app que será cobrada — geralmente um usuário, uma organização ou um projeto. Você cria um no Proyecta assim que a entidade correspondente existe no seu próprio banco de dados e, em seguida, armazena o id retornado para referenciá-lo posteriormente.

A aba Customers

Abra Dashboard > Commerce e vá para Customers para ver todos os clientes faturáveis do app atual. Cada linha exibe:

• E-mail
• Nome completo
• Data de criação

Uma caixa de busca e filtragem por e-mail ou data de criação estão disponíveis via SDK; controles mais avançados no painel estão a caminho.

SDK

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

Criar

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

Ler

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

Atualizar

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

Padrões comuns

Criar um cliente no Proyecta quando um usuário se cadastra

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.

Criar uma página de administração para navegar pelos clientes

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.

Perguntas frequentes

Devo criar um cliente no Proyecta para cada usuário ou somente para os que pagam?

Crie para todos os usuários. É gratuito, idempotente (chamadas com o mesmo e-mail retornam o mesmo cliente) e garante que você estará pronto no momento em que um usuário fizer upgrade — sem precisar correr para preencher dados retroativamente.

Um cliente pode ter várias assinaturas?

Sim. As assinaturas pertencem aos clientes, e não o contrário. Use commerce.checkout() para criar uma nova sessão de checkout de assinatura.

Como vejo o que um cliente assinou?

Por enquanto: pelo dashboard integrado do Stripe ou chamando commerce.check() para cada recurso que você quiser verificar. Uma visualização do histórico de assinaturas no painel está no roadmap.