ลูกค้า

จัดการผู้ใช้ที่เรียกเก็บเงินได้ในแอปของคุณ ดูข้อมูลได้ที่แท็บ Dashboard > Commerce > Customers หรือผ่าน SDK

ลูกค้า (customer) คือหน่วยในแอปของคุณที่ถูกเรียกเก็บเงิน — โดยทั่วไปคือผู้ใช้ องค์กร หรือโปรเจกต์ คุณสร้างข้อมูลลูกค้าใน Proyecta ทันทีที่หน่วยนั้นมีอยู่ในฐานข้อมูลของคุณ จากนั้นเก็บ id ที่ได้รับคืนเพื่อใช้อ้างอิงในภายหลัง

แท็บ Customers

เปิด Dashboard > Commerce แล้วสลับไปที่ Customers เพื่อดูลูกค้าที่เรียกเก็บเงินได้ทั้งหมดของแอปปัจจุบัน แต่ละแถวจะแสดง:

• อีเมล
• ชื่อเต็ม
• วันที่สร้าง

ช่องค้นหาและการกรองตามอีเมลหรือวันที่สร้างสามารถใช้งานได้ผ่าน 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 สำหรับผู้ใช้ทุกคน หรือเฉพาะคนที่จ่ายเงินเท่านั้น?

สร้างให้กับผู้ใช้ทุกคน เพราะไม่มีค่าใช้จ่าย เป็น idempotent (การเรียกด้วยอีเมลเดิมจะคืนค่าลูกค้าคนเดิมเสมอ) และทำให้คุณพร้อมรับมือทันทีเมื่อผู้ใช้อัปเกรด โดยไม่ต้องรีบกลับมาเพิ่มข้อมูลทีหลัง

ลูกค้าหนึ่งคนมีหลาย subscription ได้ไหม?

ได้ Subscription ผูกอยู่กับลูกค้า ไม่ใช่ในทางกลับกัน ใช้ commerce.checkout() เพื่อสร้าง checkout session สำหรับ subscription ใหม่

ดูได้อย่างไรว่าลูกค้าสมัคร subscription อะไรอยู่บ้าง?

ในขณะนี้: ผ่าน Stripe dashboard ที่ฝังอยู่ หรือโดยการเรียก commerce.check() สำหรับแต่ละฟีเจอร์ที่ต้องการตรวจสอบ ส่วนหน้าแสดงประวัติ subscription ในแผงควบคุมอยู่ใน roadmap แล้ว