Khách hàng

Quản lý những người dùng có thể thanh toán trong ứng dụng của bạn. Xem danh sách trong tab Dashboard > Commerce > Customers hoặc thông qua SDK.

Khách hàng (customer) là thực thể trong ứng dụng của bạn sẽ bị tính phí — thường là một người dùng, một tổ chức, hoặc một dự án. Bạn tạo một customer trong Proyecta ngay khi thực thể tương ứng xuất hiện trong cơ sở dữ liệu của mình, rồi lưu lại id được trả về để tham chiếu về sau.

Tab Customers

Mở Dashboard > Commerce và chuyển sang Customers để xem toàn bộ khách hàng có thể thanh toán của ứng dụng hiện tại. Mỗi dòng hiển thị:

• Email
• Họ tên đầy đủ
• Thời điểm tạo

Tính năng tìm kiếm và lọc theo email hoặc ngày tạo có thể sử dụng qua SDK; các tùy chọn nâng cao hơn trong panel đang được phát triển.

SDK

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

Tạo mới

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

Đọc dữ liệu

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

Cập nhật

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

Các pattern phổ biến

Tạo Proyecta customer khi người dùng đăng ký

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.

Xây dựng trang quản trị duyệt danh sách khách hàng

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.

Câu hỏi thường gặp

Tôi có nên tạo Proyecta customer cho mọi người dùng, hay chỉ những người đã trả phí?

Hãy tạo cho tất cả mọi người dùng. Thao tác này miễn phí, có tính idempotent (các lần gọi với cùng email sẽ trả về cùng một customer), và đảm bảo bạn sẵn sàng ngay khi người dùng nâng cấp — không cần phải vội vàng bổ sung dữ liệu sau.

Một customer có thể có nhiều subscription không?

Có. Subscription thuộc về customer, không phải ngược lại. Dùng commerce.checkout() để tạo một phiên checkout subscription mới.

Làm sao để xem một customer đang đăng ký những gì?

Hiện tại: thông qua embedded Stripe dashboard hoặc bằng cách gọi commerce.check() cho từng tính năng bạn muốn kiểm tra. Tính năng xem lịch sử subscription trong panel đang có trong roadmap.