v2.0 · Internal

Cấu trúc mô hình kinh doanh

Gamikey là Reseller trung gian — mua từ Supplier, bán lại cho Buyer, chịu toàn bộ trách nhiệm tài chính với Buyer

🛒 Buyer — Chỉ biết và tương tác với Gamikey
Gamikey.comWebsite chính · NextJS
Plati.marketMarketplace · via Digiseller
GGselMarketplace · via Digiseller
B2B / APIĐối tác trực tiếp
🔒 Phần chìm  Digiseller là engine backend xử lý Plati/GGsel — Buyer không thấy, không tương tác trực tiếp với Digiseller
Thu tiền · Giao hàng · Support · Chịu trách nhiệm hoàn toàn với Buyer
⬡ Gamikey Platform — Reseller trung tâm (PostgreSQL · VPS riêng)
Payment HubThu tiền đa kênh
Order EngineTiếp nhận đơn
Routing EngineĐiều phối Supplier
FulfillmentGiao hàng
Product CatalogueĐa nguồn · đa ngôn ngữ
CRMQuản lý khách hàng
Support & WarrantyTicket · Phân xử
Finance & PayoutP&L · Quyết toán NCC
Backend phần chìm: Digiseller Engine (xử lý Plati/GGsel) · PostgreSQL VPS (database chính, không phụ thuộc bên thứ 3) · Claude AI Cowork (automation)
Gamikey mua từ Supplier · Payout theo kỳ · Supplier không biết Buyer
📦 Supplier Layer — Nguồn cấp hàng
Gamikey SupplierEntity độc lập · auto + manual
Kinguin APIAuto · 15k+ game keys
Carrypin APIAuto · digital goods
NCC thủ công VNManual · upgrade service
AffiliateKhông mua · chỉ commission
Auto codeLấy từ kho DB
API pull keyKinguin / Carrypin
Manual codeNCC gửi code / acc
Manual serviceUpgrade thủ công
Affiliate deliverSeller gốc giao
Gamikey Supplier — Entity độc lập: Hoạt động như một NCC bình thường trong hệ thống — có bảng giá riêng, hợp đồng riêng với Platform, có thể kết nối vào Platform khác trong tương lai. Platform giao tiếp với Gamikey Supplier qua cùng Supplier API như Kinguin hay Carrypin.

Dòng tiền

Gamikey thu tiền Buyer trước, payout Supplier sau — lợi thế cash flow của Reseller model

💳
Buyer thanh toán qua Gamikey.com
VNPay · MoMo · Stripe · Crypto · Chuyển khoản
100% doanh thu
🏪
Buyer thanh toán qua Plati / GGsel
Digiseller thu hộ → Gamikey rút định kỳ qua Payoneer / WebMoney
Trừ phí Digiseller
🔑
Mua key từ Kinguin / Carrypin
Thanh toán ngay khi đặt hàng (pay-per-order) · Không tồn kho
Ngay khi có đơn
🤝
Thanh toán NCC thủ công VN
Net-terms: 7 / 14 / 30 ngày tùy hợp đồng từng NCC
Theo kỳ
🏭
Thanh toán Gamikey Supplier (nội bộ)
Transfer pricing theo hợp đồng nội bộ · Tách biệt accounting
Theo hợp đồng
💸
Phí vận hành
Digiseller fee · Payment gateway fee · VPS · Kinguin markup
Tự động trừ
Net Profit Formula
Net Profit = Revenue (Buyer)
             − COGS (Supplier cost)
             − Platform fees (Digiseller + Payment GW)
             − Refunds
             − Operating costs (VPS, nhân sự, tools)
────────────────────────────────
= Gross Margin
SupplierMô hình muaMargin ước tínhCash flowRủi ro
Gamikey Supplier Nhập bulk trước hoặc on-demand 15 – 40% Vốn lưu động nếu nhập trước Tồn kho, code lỗi
Kinguin / Carrypin Pay-per-order, không tồn kho 5 – 20% Trả ngay khi mua Thấp · Stock availability
NCC thủ công VN Thỏa thuận, net-terms 20 – 50% Thu trước, trả sau SLA, chất lượng dịch vụ
Affiliate (Digiseller) Không mua — commission Commission % Nhận sau khi sale confirm Rất thấp
⚠️ Cash flow note: Với NCC net-terms, Gamikey thu tiền Buyer ngay nhưng trả NCC sau 7–30 ngày → lợi thế. Tuy nhiên nếu Buyer refund sau khi đã payout NCC, Gamikey chịu lỗ trực tiếp. Cần quỹ dự phòng tối thiểu 30 ngày doanh thu để buffer rủi ro này.

Workflow xử lý đơn hàng

Từ lúc Buyer thanh toán đến khi nhận hàng — theo từng loại Supplier

Gamikey Supplier — Entity độc lập, đa phương thức. Không chỉ kho code sẵn: có thể auto từ DB, giao code thủ công, hoặc xử lý upgrade service trực tiếp.
1
Buyer thanh toán → Order: paid
Webhook payment xác nhận · Finance ghi revenue +X · Routing: source=gamikey_supplier, fulfillment=auto_code
2
Platform lấy code từ inventory DB
SELECT với pessimistic lock → mark is_sold=true, order_id=Y
SELECT code FROM inventory_codes WHERE product_id=X AND is_sold=false LIMIT 1 FOR UPDATE
3
Giao code tự động + ghi Finance
Email + Digiseller delivery API → Order: delivered · Finance COGS -cost · Check tồn kho còn lại → alert nếu thấp
1
Buyer thanh toán → tạo Supplier Order
Routing: fulfillment=manual_code → notify Gamikey Supplier qua portal/email
2
Gamikey Supplier chuẩn bị và gửi code về Platform
Gamikey Supplier giao code/tài khoản → Platform nhận, lưu DB · Buyer không biết có Gamikey Supplier phía sau
3
Platform giao cho Buyer
Platform là điểm duy nhất liên lạc với Buyer → Order: delivered
1
Buyer cung cấp thông tin tài khoản cần upgrade
Routing: fulfillment=manual_service · Platform forward thông tin cho Gamikey Supplier (ẩn danh tính)
2
Gamikey Supplier thực hiện upgrade
Xử lý thủ công → confirm done với Platform · SLA tracking
3
Platform notify Buyer hoàn thành
Email xác nhận + hướng dẫn kiểm tra → Order: delivered
Kinguin / Carrypin API — Mua key on-demand khi có đơn. Không tồn kho, không rủi ro vốn lưu động. Phù hợp giai đoạn đầu MVP.
1
Buyer thanh toán → Finance: revenue +X
Routing: source=kinguin/carrypin, fulfillment=api_pull
2
Gamikey gọi Supplier API mua key
Finance ghi COGS -cost_supplier ngay · Tạo supplier_orders record
POST /v2/order {productId, qty, price} → nhận supplier_order_id
3
Nhận key từ Supplier (Webhook hoặc Poll)
Keys về → lưu inventory_codes (is_sold=true ngay) · Không qua kho
GET /v2/order/{id}/keys
4
Giao key cho Buyer qua Platform
Email + Digiseller delivery → Order: delivered · Margin = sell − cost_supplier − fees
NCC thủ công VN — NCC có thể giao code, tài khoản, hoặc thực hiện dịch vụ nâng cấp. Gamikey là điểm duy nhất Buyer tiếp xúc.
1
Buyer thanh toán → notify NCC
Platform gửi yêu cầu cho NCC: loại SP, số lượng, deadline SLA · Email / Telegram / Zalo
2
NCC chuẩn bị và gửi code/tài khoản về Platform
NCC giao qua portal hoặc email bảo mật → Platform nhận, kiểm tra, lưu DB
3
Platform giao cho Buyer · Ghi công nợ NCC
Buyer không biết NCC · Công nợ NCC +X → thanh toán theo kỳ
1
Buyer cung cấp thông tin cần upgrade
Platform forward cho NCC (chỉ info cần thiết, ẩn danh tính đầy đủ của Buyer)
2
NCC xử lý + báo hoàn thành
NCC confirm done → Platform verify → supplier_order: delivered · Ghi công nợ
3
Platform notify Buyer + close order
Email xác nhận → Order: completed · Thanh toán NCC theo kỳ (7/14/30 ngày)
Affiliate (Digiseller) — Gamikey không mua, không giao. Chỉ listing link affiliate, hưởng commission. Gamikey không chịu trách nhiệm support với đơn affiliate — cần nêu rõ trong ToS.
1
Buyer click link affiliate của Gamikey trên Plati/GGsel
Digiseller tracking affiliate code · Buyer mua và thanh toán với seller gốc
2
Seller gốc giao hàng trực tiếp cho Buyer
Gamikey không tham gia giao hàng, không chịu trách nhiệm warranty với đơn này
3
Digiseller trả commission cho Gamikey
Commission % × sell price → tích lũy → sync về Finance DB định kỳ · Zero COGS

Refund & Dispute Flow

Gamikey chịu trách nhiệm với Buyer trước — sau đó xử lý với Supplier. Gamikey đóng vai trọng tài khi có tranh chấp.

Nguyên tắc: Buyer chỉ cần liên hệ một điểm duy nhất là Gamikey. Gamikey lookup Supplier liên quan, xử lý nội bộ với Supplier, và thông báo kết quả cho Buyer.
1
Buyer mở Support Ticket
Chọn loại: warranty · code lỗi · không nhận được hàng · khiếu nại khác → System tạo ticket, gán SLA tự động
2
Platform lookup Supplier liên quan
JOIN order_items → supplier_orders → xác định Supplier (Gamikey Supplier / Kinguin / NCC VN...) → gán ticket
SELECT supplier_id FROM supplier_orders WHERE order_id = X
3
Gửi request xử lý đến Supplier
Notify Supplier: thông tin đơn, mô tả vấn đề, deadline phản hồi theo SLA · Supplier phản hồi trong X giờ
4
Supplier ra quyết định → 3 nhánh bên dưới
✅ A — Hoàn trả · Supplier chấp nhận lỗi
A1
Gamikey hoàn tiền cho Buyer ngay
Không chờ Supplier — Gamikey hoàn trước · Finance: refund -X (Gamikey chịu tạm)
A2
Gamikey claim lại từ Supplier
Trừ vào lần payout tiếp theo (deductions trong supplier_payouts) · Hoặc Kinguin refund API
A3
Ticket closed · Finance reconciled
🔄 B — Thay thế · Supplier gửi sản phẩm mới
B1
Supplier gửi code / tài khoản thay thế về Platform
Supplier chịu cost thay thế · Platform nhận và kiểm tra trước khi giao
B2
Platform giao thay thế cho Buyer
Email code mới / thực hiện lại upgrade → Buyer confirm hoạt động
B3
Ticket closed · Không phát sinh thêm cost cho Gamikey
❌ C — Từ chối · Supplier từ chối kèm lý do
C1
Platform forward lý do từ chối cho Buyer
Thông báo rõ ràng · Buyer có 2 lựa chọn: chấp nhận đóng ticket hoặc leo thang tranh chấp
C2
Buyer leo thang → Gamikey mở Dispute
Thu thập bằng chứng từ cả 2 phía · Gamikey phân xử độc lập
C3
Gamikey ra quyết định phân xử
Nghiêng về Buyer: Hoàn tiền cho Buyer + penalty Supplier
Nghiêng về Supplier: Thông báo Buyer với lý do chi tiết · Close ticket
Chia sẻ: Hoàn một phần tùy mức độ lỗi mỗi bên
C4
Execute quyết định → Close · Cập nhật Supplier trust score
Ghi nhận dispute record · Ảnh hưởng đến priority routing của Supplier trong tương lai
SLA cần định nghĩa trong hợp đồng Supplier: Phản hồi trong X giờ · Gamikey hoàn Buyer trong Y giờ sau quyết định · Dispute resolution tối đa Z ngày làm việc · Penalty nếu vi phạm SLA lặp lại.

Ma trận rủi ro & Mitigation

Phân tích rủi ro theo mức độ và phương án xử lý — cập nhật theo Reseller model thực tế

📦
Kinguin / Carrypin hết stock khi có đơn
Buyer đã thanh toán nhưng Supplier không còn hàng → phải refund hoặc delay
✓ Check stock availability trước khi nhận payment · Reserve stock với deposit nếu volume lớn
Trung bình
🔑
Key không hoạt động / đã được dùng
Buyer nhận key lỗi → phải refund hoặc thay thế ngay · Ảnh hưởng reputation
✓ Verify code trước khi giao nếu có thể · SLA claim ngay với Supplier · Kho buffer code thay thế
Trung bình
NCC thủ công trễ SLA
Manual supplier không giao hàng đúng hạn → Buyer khiếu nại · Gamikey phải xử lý
✓ SLA contract chặt + penalty clause · Auto escalate nếu quá deadline · Supplier trust score tracking
Cao
💱
Biến động tỷ giá USD/VND
Mua bằng USD, bán bằng VND → nếu VND mất giá, margin bị ăn mòn
✓ Review và cập nhật bảng giá VND hàng tuần · Build tỷ giá buffer 2–3% vào giá bán
Trung bình
💸
Refund sau khi đã payout NCC
Buyer refund hợp lệ nhưng đã thanh toán NCC → Gamikey chịu lỗ tạm thời
✓ Quỹ dự phòng tối thiểu 30 ngày doanh thu · Claim lại NCC qua deduction trong payout kỳ sau
Trung bình
📜
Kinguin Terms of Service — Resell restrictions
Một số publisher cấm bán key qua marketplace thứ 3 (Plati/GGsel) · Vi phạm có thể bị suspend account
✓ Đọc kỹ ToS trước khi list · Chỉ bán trên Gamikey.com với sản phẩm có gray area · Liên hệ Kinguin support xác nhận
Cần check ngay
🔒
Database / VPS downtime
VPS tự host có thể downtime → gián đoạn toàn bộ hệ thống
✓ Daily backup · Monitoring 24/7 · Failover plan · Chọn VPS provider có SLA 99.9%
Trung bình
🤖
Airtable API 406 blocking (đã gặp)
Netlify shared IP bị Airtable block → gián đoạn sync
✓ Đã xử lý: chuyển sang PostgreSQL VPS riêng · Airtable chỉ dùng làm giao diện nhập liệu, không làm DB chính
Đã xử lý
🚫
Supplier dispute leo thang — Gamikey phải chịu
Buyer và Supplier đều có lý → Gamikey phải phân xử và có thể chịu chi phí
✓ Dispute policy rõ ràng trong ToS · Supplier trust score ảnh hưởng routing · Penalty clause trong hợp đồng Supplier
Trung bình

Phân loại sản phẩm theo Supplier & Fulfillment

Chiến lược ưu tiên: bắt đầu với API Supplier (Kinguin) — không tồn kho, không vốn lưu động, rủi ro thấp nhất

Loại sản phẩm Supplier Fulfillment Margin Tồn kho Ưu tiên
Game keys
Steam, Xbox, PSN, Nintendo...
Kinguin API / Gamikey Supplier bulk Auto code 10–25% Không / Có 🥇 MVP đầu tiên
Software license
Office, Adobe, Antivirus...
Kinguin / Gamikey Supplier Auto code 15–35% 🥇 Ưu tiên cao
AI Tools subscription
ChatGPT Plus, Midjourney...
Gamikey Supplier / NCC VN Manual code / service 20–40% Tuỳ 🥈 Phase 2
Nâng cấp tài khoản
Spotify, Netflix, YouTube Premium...
NCC VN thủ công / Gamikey Supplier Manual service 25–50% Không 🥈 Phase 2
VPN / Security
NordVPN, ExpressVPN...
Kinguin / Carrypin API Auto code 8–18% Không 🥈 Phase 2
Gift cards
Amazon, Google Play, iTunes...
Kinguin API Auto code 3–10% Không 🥉 Volume play
Design tools
Canva Pro, Figma, Adobe CC...
Gamikey Supplier / NCC VN Auto code / manual 20–45% Tuỳ 🥈 Phase 2
Affiliate products
Sản phẩm NCC khác trên Digiseller
Affiliate — không mua Seller gốc giao Commission % Không Bổ sung
Chiến lược MVP: Tập trung 100% vào Game keys + Software license qua Kinguin API. Lý do: không cần tồn kho, không vốn lưu động, auto fulfillment, rủi ro thấp nhất. Sau khi hệ thống ổn định và có dòng tiền mới mở rộng sang manual service có margin cao hơn.
⚠️ Việt hóa catalogue Kinguin: Pull sản phẩm từ Kinguin API → Claude AI tự động dịch tên + mô tả sang tiếng Việt → Review qua Airtable → Publish lên Gamikey.com. Pipeline này cần build trong Phase 2.