Cổng game casino bằng một API: hướng dẫn cho nhà vận hành dùng VND

Cổng game casino (aggregator) là gì?

Một cổng game casino, hay aggregator, gom hàng trăm nhà phát triển game về một điểm kết nối duy nhất. Nhà vận hành chỉ tích hợp một lần là có slot, casino trực tiếp, bắn cá, game crash và cá cược thể thao, thay vì ký và bảo trì từng kết nối riêng lẻ. Nền tảng của bạn giữ tài khoản và tiền của người chơi; cổng game lo phần trò chơi.

SoftAggregator là một cổng như vậy, với danh mục 40,000+ game từ 200+ nhà phát triển, và chúng tôi nhận nhà vận hành Việt Nam. Nếu bạn muốn xem kiến trúc tổng thể trước, trang API tổng hợp game casino giải thích chi tiết hơn; trang này tập trung vào những gì riêng của thị trường Việt Nam.

VND: loại tiền gốc, danh mục trả về theo tiền tệ

Trả lời ngắn: VND là loại tiền gốc của chúng tôi. Các loại tiền gốc gồm VND cùng USD, EUR, THB, CNY, KRW, IDR, PHP, MYR, SGD, JPY và nhiều loại khác; VND dùng được cho cả ba dòng sản phẩm slot, casino trực tiếp và thể thao, và tỷ giá VND có sẵn trong hệ thống. Người chơi thấy số dư và hạn mức cược bằng đồng, bạn không phải quy đổi trong lúc chơi.

Mỗi nhà phát triển cấu hình hạn mức và cách hiển thị số dư riêng cho từng loại tiền, nên hệ thống sắp xếp danh mục giúp bạn: cổng quản trị (Integration → Player currency) và getCurrencies liệt kê các loại tiền đã bật cho tài khoản, còn getGameList trả về danh sách game theo loại tiền. Game nằm trong danh mục VND là game người chơi mở được ngay bằng đồng.

Nếu loại tiền bạn cần chưa có trong danh sách gốc, tài khoản chạy bằng USD (hoặc EUR) và bạn quy đổi ở phía mình; cần một loại tiền cụ thể, hãy liên hệ chúng tôi. Danh mục game và tiền tệ được cập nhật liên tục; danh sách mới nhất luôn có trong API (getCurrencies / getGameList). Lưu ý: loại tiền của người chơi được cố định ở lần tạo đầu tiên; muốn chuyển một người chơi sang VND thì dùng user_username mới.

Số tiền lớn: chi tiết kỹ thuật riêng của VND

VND là một trong những đồng tiền có mệnh giá lớn nhất mà một hệ thống cá cược phải xử lý, và điều đó có hệ quả thật trong code.

• Số tiền trong callback là số nguyên nhân 100. Một vé cược 500.000đ đến ví của bạn dưới dạng amount=50000000. Vé 50.000.000đ thành 5.000.000.000, vượt giới hạn của kiểu số nguyên 32 bit (khoảng 2,1 tỷ). Hãy dùng BIGINT hoặc số nguyên 64 bit ở mọi nơi lưu số tiền.
• Không dùng số thực dấu phẩy động. Cộng trừ số dư bằng float ở quy mô hàng tỷ sẽ lệch vài đồng sau vài nghìn giao dịch, và lệch sổ là thứ khó giải thích nhất khi đối soát.
• Đơn vị số dư bạn trả về được chốt cho từng tài khoản. Chúng tôi gửi số tiền theo đơn vị 1/100; còn số dư bạn trả lời là đơn vị 1/100 hay đơn vị đồng thì được thống nhất và cấu hình trong lúc tích hợp. Đây là nguồn gây lỗi “số dư lớn gấp 100 lần” phổ biến nhất, nên hãy kiểm tra ngay trên tài khoản thử.
• Đơn vị là đồng. Nhiều trang tại Việt Nam hiển thị 1K = 1.000đ; mã VND của chúng tôi tính theo đồng, nên nếu giao diện của bạn dùng K thì chỉ cần quy đổi ở phía bạn.

GET {callback của bạn}?username=player123&currency=VND&action=debit
    &amount=50000000&type=bet&round_id=...&game_id=...
    &call_id=...&timestamp=...&rb=0&key=...

← {"error":0,"balance":...}   // 500.000đ đã bị trừ

Người chơi Việt Nam chờ đợi gì

Mỗi thị trường có một “bộ khung” sản phẩm riêng. Ở Việt Nam, bốn nhóm dưới đây thường chiếm phần lớn doanh thu và lưu lượng.

Bóng đá và thể thao điện tử

Ngoại hạng Anh, Champions League và các giải lớn châu Âu kéo lượng cược lớn nhất, V.League có nhóm người chơi trung thành riêng. Thể thao điện tử như Liên Minh Huyền Thoại, DOTA 2 và CS thu hút người chơi trẻ. API cá cược thể thao của chúng tôi có kèo trước trận và kèo trực tiếp cho bóng đá, bóng rổ, quần vợt, cricket và eSports, chạy trên cùng một ví với casino.

Bắn cá và nổ hũ

Bắn cá là thể loại có sức hút đặc biệt ở Việt Nam, và getGameList có hẳn giá trị game_type=fishing để bạn dựng mục riêng. Với slot, người chơi thích game nhịp nhanh, có tính năng mua vòng quay miễn phí và hệ số nhân cao.

Baccarat trực tiếp

Trong casino trực tiếp, baccarat thường dẫn đầu, sau đó là rồng hổ, tài xỉu (sic bo) và roulette. Người chơi để ý tốc độ chia bài, bảng cầu dễ đọc và bàn có nhiều mức cược. Các bàn có nhiều mức cược và hạn mức hiển thị theo loại tiền của người chơi.

Điện thoại là chính

Gần như toàn bộ lượt chơi đến từ điện thoại. Hãy truyền device=mobile ở mỗi lần mở game trên di động, vì một số nền tảng game từ chối mở nếu thiếu thông tin thiết bị.

Một aggregator phải đưa cho bạn những gì

Dùng danh sách này để hỏi bất kỳ nhà cung cấp nào. Câu trả lời của chúng tôi nằm ngay trong từng dòng.

1. Một API duy nhất. Mọi phương thức đều là POST + JSON gửi tới https://api.softaggregator.com/api/v1.
2. Ví liền mạch. Tiền của người chơi nằm ở hệ thống của bạn; bạn không phải gửi trước tiền người chơi cho chúng tôi.
3. Tiền tệ địa phương. VND gốc, hoặc USD/EUR cho các loại tiền khác.
4. Ngôn ngữ sảnh. Sảnh là của bạn; chúng tôi trả về phân loại game đã chuẩn hóa, tên nhà phát triển và logo phục vụ từ CDN riêng.
5. Hỗ trợ phản hồi nhanh. Bạn làm việc trực tiếp với đội kỹ thuật qua Telegram (@mentionso) và email [email protected] trong suốt quá trình tích hợp.
6. Quy tắc callback bằng văn bản. GET, chữ ký, mã lỗi, trường chống trùng: tất cả nằm trong tài liệu.

Hai quy tắc callback hay bị bỏ qua nhất: chỉ rẽ nhánh theo action, đừng từ chối giao dịch vì một giá trị type lạ; và chấp nhận credit không có debit đi kèm, vì tiền thắng từ vòng quay miễn phí hay jackpot trong game đến dưới dạng credit đơn lẻ.

Các bước tích hợp

1. Điền biểu mẫu ở trang chủ (bằng tiếng Anh), mục Player currency nhập VND và có thể thêm USD.
2. Khi tài khoản được duyệt, đăng nhập trang quản trị, lấy api_login, api_password, salt_key và khai báo callback URL. Mỗi website có bộ khóa và callback riêng.
3. Gọi getCurrencies để xem các loại tiền đã bật cho tài khoản, rồi getGameList để dựng sảnh theo game_type.
4. Viết ba callback balance / debit / credit, chạy thử bằng getGameDemo (chế độ chơi thử không cần country).
5. Thử tiền thật với số nhỏ: createPlayer với currency=VND, getGame với lang=vi, device và country=VN; so số dư trong game với số dư trong ví.
6. Theo dõi kênh Telegram @casinogamessoftware để nhận thông báo nhà phát triển mới, thay đổi API và lịch bảo trì.

Toàn bộ trường dữ liệu, ví dụ yêu cầu và mã lỗi có trong tài liệu API. Nếu bạn định đẩy mạnh bàn baccarat, trang API casino trực tiếp mô tả các loại bàn và cách chúng chạy trên cùng một ví.

Câu hỏi thường gặp của nhà vận hành

Nguồn và ngày cập nhật

Thông tin trên trang này lấy từ hệ thống SoftAggregator và tài liệu API công khai.

• Tài liệu API SoftAggregator: softaggregator.com/docs.html (tiền tệ, callback, mã lỗi, tham số country, getPlayerHistory)
• Danh sách tiền tệ gốc: hệ thống SoftAggregator, 24/09/2026

Kiểm tra lần cuối: 24/09/2026. Nếu thấy thông tin đã cũ, hãy báo cho chúng tôi qua [email protected].

Đọc thêm