Mã quà

Đường dẫn: Menu → Người chơi & giao dịch → Mã quà (/games/{gameId}/promo-codes)

Ai dùng được

Đây là quyền endpoint theo backend/src/admin_portal/core/permissions.py; các thao tác nhạy cảm như PII có kiểm tra step-up riêng. Super Admin vượt ma trận bằng quyền khẩn cấp.

Tài nguyên endpoint	Hành động cần	Vai trò được backend cho phép
live_reward	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor
live_reward	WRITE	Super Admin, Live Ops, Economy Admin
live_reward	PUBLISH	Super Admin, Live Ops, Economy Admin

Điều kiện hiển thị: Có game đang chọn và quyền LIVE_REWARD/READ; tạo mã yêu cầu LIVE_REWARD/WRITE, phát hành theo endpoint PUBLISH.

Màn hình này dùng để làm gì

Quản lý mã quà gắn với chiến dịch. Dữ liệu nghiệp vụ được giới hạn theo gameId đang chọn.

Các thao tác thường gặp

1. Tạo mã riêng hoặc batch mã; lưu mã thô/CSV an toàn vì chỉ hiển thị hoặc tải một lần.
2. Vô hiệu hóa lô khi cần dừng mã chưa đổi; lưu ý mã đã đổi và quà đã phát không bị thu hồi.

Lưu ý an toàn

Rà soát giới hạn sử dụng, thời hạn và phạm vi trước khi phát hành; không chia sẻ mã nội bộ công khai.

Chú ý

Trước khi xác nhận thay đổi có thể ảnh hưởng người chơi, kiểm tra đúng game, đối tượng, giá trị và lý do. Không dùng dữ liệu người chơi thật trong ví dụ hoặc ảnh chụp.

Lỗi thường gặp

“Không tìm thấy mã” → kiểm tra mã/lô và game scope; “Không thể hoàn tất thao tác” → đọc detail API và xác minh mã chưa bị vô hiệu hóa.

Liên quan

Quy trình thường gặp · Audit Log · Vai trò và quyền

Kiểm tra lần cuối với Portal v1.2.2. Hướng dẫn được đối chiếu mã nguồn; chưa chạy thao tác trên dev stack.