Tích Hợp Thương Mại Vào Ứng Dụng

Bắt đầu thanh toán và kiểm soát các tính năng cao cấp ngay từ code ứng dụng của bạn.

Sau khi đã kết nối Stripe và tạo sản phẩm, ứng dụng của bạn có thể nhận thanh toán. Trong một ứng dụng được xây bằng Proyecta, việc này chạy từ trình duyệt thông qua public commerce API — bạn không cần dựng backend nào, và cũng không có secret key nào tham gia.

Danh mục cửa hàng là nội dung. Nếu sản phẩm của bạn là một sellable collection được hỗ trợ bởi nội dung (xem Products & Features), bạn đọc danh mục và hiển thị giá thông qua API Content — dữ liệu sản phẩm nằm ở đó. Bạn vẫn bắt đầu thanh toán theo cách tương tự, truyền vào variant_id của sản phẩm Commerce được liên kết.

import * as platform from '@/lib/platformClient.ts';
import { useEntitlement } from '@/hooks/useEntitlement.ts';

Bắt đầu thanh toán

commerceCheckout tạo một phiên thanh toán do Stripe host và trả về URL để đưa người mua tới đó. Bạn không cần tạo khách hàng trước — nền tảng sẽ tự ghi nhận khách hàng từ chính phiên thanh toán:

const { url } = await platform.commerceCheckout({
    lineItems: [{ variantId: 'var_pro_monthly', quantity: 1 }],
    successUrl: 'https://myapp.com/welcome',
    cancelUrl: 'https://myapp.com/pricing',
    customerEmail: shopperEmail, // optional — prefills Stripe checkout
});

window.location.href = url;

Hỗ trợ nhiều dòng sản phẩm. Đối với đăng ký, quantity là số lượng chỗ ngồi (seat count). Nếu người mua có nhập mã giảm giá, hãy truyền kèm mã đó — server sẽ xác thực và tính mức giảm dựa trên dữ liệu commerce của bạn, không bao giờ dựa trên số tiền do trình duyệt gửi lên.

Kiểm soát một tính năng cao cấp

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

Khóa ở đây là slug của tính năng (ví dụ: pro_features), không phải id của đối tượng tính năng. Việc kiểm tra diễn ra ở phía server và gắn với phiên đăng nhập, nên không thể bị giả mạo từ trình duyệt. Xem Products & Features để hiểu mô hình quyền lợi.

Để AI tự động kết nối

• "Build a /pricing page that shows my products and starts a checkout when a button is clicked."
• "Gate the /pro route so only customers with pro_features access can see it."
• "Add a cart with a coupon code field and a Checkout button."