Dữ liệu game session
Player, brand, game, currency, country, language, mode, jurisdiction và thời hạn access.
Documentation / Gaming Flow
Gaming API flow
Toàn bộ quy trình từ xác minh người chơi và launch game đến xử lý bet, win, game round, hủy giao dịch và đối soát tài chính.
Session
player và game launch
Balance
bet và win
Round
luồng game session
Hủy
khôi phục giao dịch
Vòng đời game
Từ launch đến đóng round
01
Tạo game session
Player, game, currency, language, country, mode và return URL.
02
Launch game
Temporary access key, launch URL và kiểm tra khả dụng của game.
03
Xử lý giao dịch tài chính
Kiểm tra balance, bet, win, combined operation và response của platform.
04
Đóng và đối soát round
Kết quả cuối, hủy, financial ledger và provider report.
Tổng quan
Gaming API liên kết player, round và luồng tiền
Game launch và luồng tiền là hai phần khác nhau của cùng một quy trình. Session xác định player và điều kiện launch, round liên kết các hành động của provider, còn API của platform xác nhận mọi debit, credit và cancellation.
Kiểm soát balance
Platform kiểm tra số dư khả dụng và chỉ áp dụng mỗi bet, payout hoặc cancellation một lần.
Financial ledger của game
Operation ID và round ID, loại giao dịch, amount, balance trước và sau được lưu để kiểm soát và đối soát.
Game launch
Gaming flow launch điển hình
Platform trước tiên xác minh player và khả dụng của game, sau đó tạo session có thời hạn và nhận launch URL từ provider.
01
Xác minh player và khả dụng của game
Platform kiểm tra account status, currency, country, restriction, limit, real-money hoặc demo mode và khả dụng của game.
02
Tạo internal session
Tạo session ID với thông tin player, game, brand, currency, language, IP và thời hạn.
03
Nhận game launch URL
Provider nhận session key, notification URL và return URL, device type, jurisdiction và interface parameter.
04
Mở game trong browser
Player mở URL được trả về, còn các giao dịch tài chính tiếp theo được xử lý trực tiếp giữa các server.
Giao dịch balance
Các giao dịch balance chính
Tên method khác nhau giữa các provider, nhưng logic vẫn giống nhau: kiểm tra balance, debit bet, credit win và hủy giao dịch đã được xác nhận trước đó.
Kiểm tra balance
Trả về balance khả dụng của player theo currency của session đang active mà không thay đổi financial ledger.
Debit bet
Xác minh player, session, currency và số dư khả dụng, sau đó debit bet đã xác nhận đúng một lần.
Credit win
Credit tiền thắng bằng operation ID và round ID duy nhất, kể cả kết quả bằng không.
Bet và kết quả trong một request
Áp dụng bet và kết quả game cùng lúc khi provider hỗ trợ model này.
Hủy giao dịch
Tạo một adjustment operation riêng cho bet hoặc payout đã được xác nhận trước đó mà không xóa bản ghi gốc.
Bonus và Free Spins
Truyền dữ liệu bonus campaign và game round, đồng thời tách biệt real funds và bonus funds.
Currency và độ chính xác amount
Mỗi giao dịch kiểm tra currency, đơn vị amount, số chữ số thập phân và quy tắc rounding.
Response của platform
Trả về operation status, internal ID, balance hiện tại và error code thống nhất.
Vòng đời round
Vòng đời game round
Một round có thể gồm nhiều bet và result. Trạng thái của round được xác định theo luật game, không chỉ theo thứ tự network request.
Round đã tạo
Platform nhận round ID lần đầu và tạo internal record.
Round đang active
Round có thể chứa thêm bet, game action và win trung gian.
Bet đã được chấp nhận
Debit được platform xác nhận và liên kết với operation ID duy nhất của provider.
Đã nhận kết quả
Đã nhận win hoặc kết quả bằng không, nhưng round có thể vẫn mở theo luật game.
Round đã đóng
Provider đã xác nhận round kết thúc và tất cả giao dịch tài chính dự kiến đã được xử lý.
Giao dịch đã bị hủy
Một hoặc nhiều giao dịch đã được điều chỉnh trong khi vẫn giữ toàn bộ lịch sử gốc.
Một round có thể gồm nhiều giao dịch
Round ID không được là idempotency key duy nhất. Mỗi bet, payout và cancellation phải có mã định danh duy nhất riêng.
Độ tin cậy và đối soát
Bảo vệ duplicate và đối soát tài chính
Gaming API phải xử lý an toàn request lặp lại, response delay, giao dịch sai thứ tự và recovery của provider sau sự cố.
Xử lý lặp lại an toàn
Provider operation ID là duy nhất cho từng loại hành động tài chính.
Request lặp lại trả về kết quả gốc và balance hiện tại mà không dịch chuyển tiền lần nữa.
Retry với amount, currency hoặc player khác sẽ bị từ chối do xung đột dữ liệu.
Cancellation tham chiếu đến giao dịch gốc cụ thể và cũng có mã định danh duy nhất riêng.
Round ledger và đối soát
Lưu session ID, round ID, provider operation ID và platform operation ID.
Ghi lại loại giao dịch, amount, currency, balance trước và sau, cùng processing time.
Không sửa bản ghi đã ghi nhận; hãy tạo một adjustment operation riêng.
Đối soát provider report, game round, biến động balance, GGR và các chênh lệch đã phát hiện.
Testing
Cần kiểm tra gì trong test environment
Kiểm tra phải bao phủ game launch, restriction của player, không đủ balance, giao dịch lặp lại, response delay, cancellation và đối soát round đã đóng.
Launch và game session
Real-money và demo mode, currency không hợp lệ, country bị cấm, access hết hạn và game không khả dụng.
Balance và từ chối bet
Không đủ tiền, player bị khóa, currency không khớp và vượt limit.
Delay và kết quả chưa xác định
Provider không nhận được response sau khi debit thực tế đã xảy ra và gửi lại giao dịch với cùng ID.
Bet và win lặp lại
Cùng một ID đến trước hoặc sau khi xử lý hoàn tất, kể cả với tham số xung đột.
Hủy giao dịch
Hủy bet, hủy win, hủy lặp lại và tham chiếu đến giao dịch gốc không tồn tại.
Đối soát round
Amount bet, win và cancellation, status cuối, biến động balance và provider report phải khớp nhau.
Checklist trước launch
Launch chỉ thực hiện sau khi đã kiểm tra game session, balance operation, bảo vệ duplicate, cancellation và reporting.
Test và production environment sử dụng credential, API endpoint và launch setting khác nhau.
Game session key có thời hạn và được liên kết với player, game, currency và brand.
Mỗi balance operation được bảo vệ bằng provider ID duy nhất.
Bet, win và cancellation lặp lại không thay đổi balance lần thứ hai.
Bản ghi đã ghi nhận không bị xóa mà được điều chỉnh bằng adjustment operation riêng.
Đã cấu hình event log, alert, provider report và quy trình đối soát round.
Cần cấu hình Gaming API flow?
Gửi provider documentation, danh sách balance operation, model game round, currency và yêu cầu reporting. APIACE sẽ giúp xây dựng game launch, bet, win, cancellation và đối soát tài chính.