Клієнти

Керуйте платіжними користувачами вашого застосунку. Переглядайте клієнтів на вкладці Dashboard > Commerce > Customers або через SDK.

Клієнт — це сутність у вашому застосунку, з якої стягується оплата: зазвичай користувач, організація або проєкт. Ви створюєте її в Proyecta одразу, як тільки відповідна сутність з’являється у вашій базі даних, а потім зберігаєте повернутий id, щоб посилатися на нього надалі.

Вкладка Customers

Відкрийте Dashboard > Commerce і перейдіть на вкладку Customers, щоб побачити всіх платіжних клієнтів поточного застосунку. Кожен рядок містить:

• Email
• Повне ім’я
• Дату створення

Пошук і фільтрація за email або датою створення доступні через SDK; розширені елементи керування в панелі з’являться пізніше.

SDK

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

Створення

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

Читання

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

Оновлення

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

Типові патерни

Створення клієнта Proyecta під час реєстрації користувача

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.

Створення адмін-браузера клієнтів

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.

Часті запитання

Чи варто створювати клієнта Proyecta для кожного користувача, чи лише для тих, хто платить?

Створюйте для кожного користувача. Це безкоштовно, ідемпотентно (виклики з однаковим email повертають того самого клієнта) і означає, що ви готові в момент, коли користувач перейде на платний план, — без необхідності наздоганяти й заповнювати дані заднім числом.

Чи може клієнт мати кілька підписок?

Так. Підписки належать клієнтам, а не навпаки. Використовуйте commerce.checkout(), щоб створити нову checkout-сесію для підписки.

Як переглянути, на що підписаний клієнт?

Наразі: через вбудований дашборд Stripe або викликаючи commerce.check() для кожної функції, яка вас цікавить. Перегляд історії підписок у панелі запланований у roadmap.