Cấu hình Domain & Thương hiệu

Sau khi triển khai Console và Landing Page, bạn cần cấu hình domain và thương hiệu trên Seller Portal để hệ thống nhận diện người dùng thuộc đại lý của bạn.

Truy cập cấu hình

1. Đăng nhập Seller Portal
2. Vào menu Configuration (Cấu hình) và chọn tab Branding
3. Click Banner Generator hoặc truy cập vào link để tạo logo
4. Cập nhật logo vào Seller Portal

Cài đặt cửa hàng (Store Settings)

Tên doanh nghiệp (Business Name)

Nhập tên doanh nghiệp/thương hiệu của bạn. Tên này sẽ hiển thị cho người dùng cuối trên Console.

Trạng thái cửa hàng (Store Active)

• Bật (Active): Người dùng có thể truy cập và sử dụng Console
• Tắt (Inactive): Console sẽ hiển thị thông báo bảo trì, người dùng không thể truy cập

Chú ý

Khi tắt cửa hàng, tất cả người dùng cuối sẽ không thể đăng nhập hoặc thực hiện giao dịch. Chỉ tắt khi cần bảo trì.

Cấu hình Domain

Thiết lập URL cửa hàng

1. Trong phần Domain Configuration, nhập URL đầy đủ của Console:

   https://console.yourdomain.com

2. URL phải bắt đầu bằng https:// hoặc http://

3. Hệ thống tự động trích xuất domain gốc từ URL

Tại sao cần đăng ký domain?

• Backend sử dụng domain từ request để xác định người dùng thuộc đại lý nào
• Khi người dùng đăng ký trên Console của bạn, hệ thống tự động gắn họ với tài khoản đại lý của bạn
• Thông tin branding (logo, favicon) được trả về dựa trên domain

Mẹo

Nếu bạn sử dụng subdomain khác nhau cho Landing Page và Console (ví dụ: proxy.yourdomain.com và console.yourdomain.com), bạn chỉ cần đăng ký domain của Console trên Seller Portal.

Cấu hình OpenGraph (Chia sẻ mạng xã hội)

Thiết lập thông tin hiển thị khi link Console được chia sẻ trên Facebook, Twitter, Telegram, v.v.

Trường	Mô tả	Giới hạn
OG Title	Tiêu đề hiển thị	Tối đa 60 ký tự
OG Description	Mô tả ngắn	Tối đa 160 ký tự
OG Image URL	URL ảnh preview	Phải là URL http(s) hợp lệ

Cấu hình Logo & Favicon

Các loại logo cần upload

Loại	Mục đích	Ghi chú
Light Logo	Logo hiển thị ở chế độ sáng	Nền trong suốt khuyến nghị
Dark Logo	Logo hiển thị ở chế độ tối	Nền trong suốt khuyến nghị
Light Icon	Favicon ở chế độ sáng	Kích thước nhỏ (32x32 hoặc 64x64)
Dark Icon	Favicon ở chế độ tối	Kích thước nhỏ (32x32 hoặc 64x64)
Social Share Image	Ảnh OG khi chia sẻ trên mạng xã hội	Khuyến nghị 1200x630px

Cách upload logo

1. Nhấn vào card logo tương ứng
2. Chọn file ảnh từ máy tính
3. Chờ upload hoàn tất
4. Logo tự động áp dụng cho Console

Banner Generator

Seller Portal cung cấp link đến công cụ Banner Generator để bạn tạo ảnh OG/social share chuyên nghiệp mà không cần designer.

Xóa logo

Nhấn nút xóa trên card logo để xóa và quay về mặc định.

Cách hoạt động white-label

Khi người dùng truy cập Console:

1. Console gửi request đến API với domain hiện tại
2. API tra cứu domain → tìm đại lý tương ứng
3. API trả về thông tin branding (logo, favicon, tên doanh nghiệp)
4. Console hiển thị giao diện với thương hiệu của đại lý
5. Favicon tự động cập nhật theo chế độ sáng/tối

Xác nhận cấu hình thành công

Sau khi cấu hình xong, kiểm tra:

1. Truy cập Console từ domain đã đăng ký
2. Logo hiển thị đúng thương hiệu
3. Favicon hiển thị đúng
4. Chuyển đổi dark mode → logo thay đổi tương ứng
5. Chia sẻ link trên mạng xã hội → preview hiển thị đúng OG

Bước tiếp theo

• Cấu hình Thanh toán — thiết lập cổng thanh toán
• Quản lý Giá & Mã giảm giá — đặt giá bán và tạo coupon