Pelanggan

Kelola pengguna berbayar dari aplikasimu. Telusuri pelanggan di tab Dashboard > Commerce > Customers atau melalui SDK.

Pelanggan adalah entitas dalam aplikasimu yang dikenakan tagihan — biasanya seorang pengguna, organisasi, atau proyek. Kamu membuat satu entitas di Proyecta segera setelah entitas yang bersangkutan ada di database-mu sendiri, lalu menyimpan id yang dikembalikan agar bisa dirujuk nanti.

Tab Customers

Buka Dashboard > Commerce dan beralih ke Customers untuk melihat semua pelanggan berbayar pada aplikasi saat ini. Setiap baris menampilkan:

• Email
• Nama lengkap
• Waktu pembuatan akun

Kotak pencarian dan filter berdasarkan email atau tanggal pembuatan tersedia melalui SDK; kontrol yang lebih lengkap di panel akan segera hadir.

SDK

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

Buat

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

Baca

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

Perbarui

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

Pola umum

Buat pelanggan Proyecta saat pengguna mendaftar

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.

Buat halaman admin untuk menelusuri pelanggan

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.

FAQ

Haruskah saya membuat pelanggan Proyecta untuk setiap pengguna, atau hanya yang berbayar?

Buat untuk setiap pengguna. Ini gratis, bersifat idempoten (panggilan dengan email yang sama akan mengembalikan pelanggan yang sama), dan memastikan kamu siap pada saat pengguna melakukan upgrade — tanpa perlu buru-buru mengisi data yang tertinggal.

Bisakah satu pelanggan memiliki beberapa langganan?

Bisa. Langganan dimiliki oleh pelanggan, bukan sebaliknya. Gunakan commerce.checkout() untuk membuat sesi checkout langganan baru.

Bagaimana cara melihat apa yang dilanggan oleh seorang pelanggan?

Saat ini: melalui dashboard Stripe yang tertanam atau dengan memanggil commerce.check() untuk setiap fitur yang kamu butuhkan. Tampilan riwayat langganan di panel sudah masuk dalam roadmap.