Müşteriler

Uygulamanızın faturalandırılabilir kullanıcılarını yönetin. Dashboard > Commerce > Customers sekmesinden veya SDK aracılığıyla müşterilere göz atın.

Müşteri, uygulamanızda ücretlendirilen varlıktır — genellikle bir kullanıcı, bir organizasyon veya bir proje. Kendi veritabanınızda ilgili varlık oluşturulur oluşturulmaz Proyecta’da bir müşteri kaydı oluşturur ve dönen id değerini ileride başvurmak için saklarsınız.

Customers Sekmesi

Dashboard > Commerce bölümünü açın ve mevcut uygulamaya ait tüm faturalandırılabilir müşterileri görmek için Customers sekmesine geçin. Her satırda şunlar gösterilir:

• E-posta
• Ad soyad
• Oluşturulma tarihi

Arama kutusu ve e-posta ya da oluşturma tarihine göre filtreleme SDK üzerinden kullanılabilir; panelde daha gelişmiş kontroller yakında gelecek.

SDK

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

Oluşturma

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

Okuma

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

Güncelleme

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

Yaygın Kullanım Kalıpları

Kullanıcı kayıt olduğunda bir Proyecta müşterisi oluşturun

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.

Yönetici müşteri tarayıcısı oluşturun

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.

Sık Sorulan Sorular

Her kullanıcı için mi yoksa yalnızca ödeme yapanlar için mi Proyecta müşterisi oluşturmalıyım?

Her kullanıcı için oluşturun. Bu işlem ücretsizdir, idempotent’tir (aynı e-postayla yapılan çağrılar aynı müşteriyi döndürür) ve bir kullanıcı üst plana geçmek istediği anda hazır olmanızı sağlar — geriye dönük veri doldurmakla uğraşmazsınız.

Bir müşterinin birden fazla aboneliği olabilir mi?

Evet. Abonelikler müşterilere aittir, tersi geçerli değildir. Yeni bir abonelik checkout oturumu oluşturmak için commerce.checkout() kullanın.

Bir müşterinin nelere abone olduğunu nasıl görebilirim?

Şu an için: gömülü Stripe dashboard’u üzerinden veya önemsediğiniz her özellik için commerce.check() çağrısı yaparak görebilirsiniz. Panelde abonelik geçmişi görünümü yol haritasında yer almaktadır.