Tích hợp API live casino

Có hai cách đưa các bàn trực tiếp trên elite đến người chơi của bạn. Nhà vận hành đã có hệ thống hội viên và ví thì tích hợp API live dealer; nhà vận hành chưa có thì mở trang đăng nhập mang thương hiệu riêng trên tên miền của mình. Cả hai cách dùng chung bàn, Console và cách tính phí. Baccarat, Rồng Hổ, Texas Hold'em và Niu Niu đều dùng cùng một API, nên game mới không cần tích hợp lại.

Hai cách đưa bàn đến người chơi

	Tích hợp API	Trang đăng nhập mang thương hiệu riêng
Phù hợp với	Nhà vận hành đã có hệ thống hội viên và ví	Nhà vận hành chưa có hệ thống hội viên
Tài khoản người chơi	Tự động tạo ở lần khởi chạy game hoặc lần chuyển tiền vào đầu tiên	Tạo trong Console; người chơi đăng nhập bằng tên tài khoản và mật khẩu
Số dư	Chuyển vào, chuyển ra qua API ví chuyển khoản	Điều chỉnh trong Console
Điểm truy cập	Website hoặc ứng dụng của bạn, bằng chuyển hướng hoặc iframe	Tên miền riêng của bạn (Gói Chính thức), với một trong bốn mẫu giao diện
Phát triển	Tích hợp phía máy chủ	Không cần

Tổng quan API live dealer

Hạng mục	Bạn nhận được
Chữ ký	Mọi yêu cầu được ký bằng HMAC-SHA256 (X-Api-Key, X-Timestamp, X-Nonce, X-Signature); timestamp lệch không quá ±300 giây, nonce không bao giờ dùng lại, kèm danh sách trắng IP tùy chọn
Khởi chạy game	POST /player/launch trả về URL dùng một lần, hiệu lực 60 giây, vào sảnh hoặc một bàn chỉ định; bố cục máy tính hoặc điện thoại, 9 ngôn ngữ, chuyển hướng hoặc iframe
Ví chuyển khoản	Chuyển vào, chuyển ra, tra cứu giao dịch chuyển khoản và đọc số dư; txnId giúp mọi giao dịch chuyển khoản đều idempotent
Đồng bộ dữ liệu cược	GET /bets theo con trỏ (cursor); sửa kết quả và hủy ván đến dưới dạng phiên bản mới của cùng phiếu cược; kèm tổng hợp hằng ngày theo từng người chơi
Webhook	POST có chữ ký khi ván được kết toán, sửa kết quả hoặc hủy, khi người chơi bị buộc thoát và khi tài khoản thay đổi; tự thử lại trong khoảng 24 giờ (Gói Chính thức và sandbox)
Bàn và tài khoản	Liệt kê, bật và tắt bàn, đọc kết quả ván, kiểm tra tín dụng trả trước và mức sử dụng hằng ngày

Các liên kết trong bảng dẫn đến tài liệu API chi tiết bằng tiếng Anh.

Chỉ gọi từ máy chủ đến máy chủ

Back end của bạn gọi API. Secret tuyệt đối không được đưa vào trình duyệt hay ứng dụng.

API ví chuyển khoản hoạt động thế nào

Mỗi người chơi có một ví game trên elite. Hệ thống của bạn chuyển tiền vào bằng POST /wallet/deposit và chuyển ra bằng POST /wallet/withdraw. Trong game, tiền cược bị trừ khi cược được chấp nhận; tiền thắng cùng các khoản phát sinh do sửa kết quả và hủy ván được cộng tự động, nên số dư luôn là số dư khả dụng.

• Chuyển khoản là giao dịch một bước: phản hồi thành công nghĩa là giao dịch đã hoàn tất.
• txnId là mã giao dịch chuyển khoản của bạn, đồng thời là khóa idempotency. Khi hết thời gian chờ (timeout), hãy gửi lại đúng txnId với cùng nội dung, hoặc tra cứu giao dịch — tuyệt đối không thử lại bằng txnId mới.
• Số tiền là chuỗi thập phân với tối đa bốn chữ số thập phân, và tiền tệ của người chơi được cố định khi tạo người chơi.

Các bước tích hợp live casino điển hình

Mỗi bước có hướng dẫn chi tiết (tiếng Anh) ở liên kết đi kèm.

1. Đăng ký: bạn nhận được một tài khoản sandbox đi kèm với tiền thử nghiệm, cùng khóa API sandbox và khóa API chính thức (Bắt đầu nhanh).
2. Thực hiện lệnh gọi có chữ ký đầu tiên với GET /tables. Nếu chữ ký không khớp, so sánh dữ liệu đầu vào bằng công cụ gỡ lỗi chữ ký (Xác thực và chữ ký).
3. Khởi chạy game cho một người chơi thử nghiệm từ back end của bạn (Khởi chạy game).
4. Chuyển tiền vào và ra, kể cả thử lại sau timeout (Ví chuyển khoản).
5. Đồng bộ dữ liệu cược vào cơ sở dữ liệu của bạn, dùng khóa (slipId, rev) (Đồng bộ dữ liệu cược).
6. Thêm Webhook để nhận thông báo kết toán sớm hơn; GET /bets vẫn là nguồn dữ liệu chuẩn (Webhook).
7. Vận hành chính thức: danh sách kiểm tra vận hành trong Console chạy thử lệnh gọi có chữ ký, khởi chạy game, chuyển vào, chuyển ra và đồng bộ dữ liệu cược bằng khóa sandbox. Sau đó chuyển sang khóa chính thức trên cùng host, thiết lập danh sách trắng IP, rồi nạp tiền để nâng cấp lên Gói Chính thức.

Sandbox, OpenAPI, Postman và công cụ gỡ lỗi chữ ký

• Sandbox: không bao giờ tính phí, tối đa 500 người chơi thử nghiệm và 20 yêu cầu mỗi giây; Webhook của sandbox cũng được gửi.
• Đặc tả OpenAPI 3.1 dạng YAML và JSON, là nguồn của tài liệu tham chiếu API (tiếng Anh).
• Bộ sưu tập Postman bằng tiếng Anh và tiếng Trung phồn thể, có sẵn script tạo chữ ký.
• Công cụ gỡ lỗi chữ ký: tính chữ ký API và Webhook từng bước ngay trong trình duyệt; secret không bao giờ bị gửi đi.
• Mã mẫu tạo chữ ký bằng Node.js, PHP, C#, Java, Python và Go.

Tất cả đều tải về được tại Công cụ và tải về (tiếng Anh).

Giới hạn tần suất (rate limit)

Gói	Yêu cầu mỗi giây	Đột biến ngắn tối đa
Gói Chính thức	100	200
Sandbox	20	40
Gói Demo miễn phí	5	10

Giới hạn áp dụng theo từng tài khoản nhà vận hành. Khi vượt giới hạn, bạn nhận 429 RATE_LIMITED: hãy giãn thời gian rồi thử lại với nonce mới. Đọc dữ liệu cược theo trang, tối đa 1.000 phiếu mỗi trang, thay vì đọc từng phiếu. Xem Giới hạn tần suất và hạn mức (tiếng Anh).

Tùy chọn white label: trang đăng nhập mang thương hiệu trên tên miền riêng

Không có lập trình viên, bạn vẫn có thể vận hành dưới thương hiệu của mình:

• Tạo tài khoản người chơi và điều chỉnh số dư ngay trong Console.
• Trỏ tên miền riêng (ví dụ play.yourbrand.com) về elite bằng bản ghi CNAME.
• Tại Thương hiệu & đăng nhập → Trang web tùy chỉnh, chọn một trong bốn mẫu. Logo của bạn thay cho logo elite trong sảnh, tại bàn và trên màn hình tải, và người chơi có thể thêm trang vào màn hình chính.
• Trang web tùy chỉnh có trong Gói Chính thức. Khi chưa có tên miền riêng, người chơi vẫn có thể đăng nhập trên trang đăng nhập công khai của elite.

Bạn cũng vận hành bàn riêng?

Nếu bàn cũng là của bạn, kết quả ván có giao diện riêng: GFI (tiếng Anh), cho phép hệ thống kết quả của bạn đẩy các sự kiện ván có chữ ký, bên cạnh máy tính bảng dealer và EWIN AI VISION. Xem Phần mềm Baccarat trực tiếp, Rồng Hổ, Texas Hold'em và Niu Niu trực tiếp và Cách dựng studio live casino.

Câu hỏi thường gặp

elite dùng mô hình ví nào?

Ví chuyển khoản. Hệ thống của bạn chuyển tiền vào và rút ra khỏi ví game của từng người chơi qua API; cược và trả thưởng trong game được xử lý trong chính ví đó.

Tôi có thể thử nghiệm trước khi trả phí không?

Có. Sandbox không bao giờ tính phí, và Gói Demo miễn phí cho phép bạn thử toàn bộ quy trình trước khi nạp tiền và nâng cấp.

Tôi có thể nhúng game vào website của mình không?

Có. Dùng URL khởi chạy làm src của iframe (giữ allow="autoplay; fullscreen") hoặc chuyển hướng đến URL đó. Game không phụ thuộc cookie nên hoạt động được trong iframe của bên thứ ba; trên điện thoại, chuyển hướng toàn trang thường cho kết quả tốt hơn.

Game mới có cần tích hợp lại không?

Không. Mọi game dùng chung API khởi chạy, ví, dữ liệu cược và Webhook; dữ liệu cược chỉ thêm vài trường riêng của từng game, như khoản tạm giữ của Niu Niu và rake của Hold'em.

Có chia doanh thu không?

Không. Bạn trả phí bàn hằng tháng tính theo ngày, cộng phí truyền phát theo GB, cả hai trừ vào tín dụng trả trước; xem phần Bảng giá.

Bắt đầu tích hợp ngay hôm nay. Đăng ký miễn phí để nhận Console và khóa API chỉ trong vài phút, hoặc xem tổng quan nền tảng và trang chính thức của elite.