Game session data
Player, brand, game, currency, country, language, mode, jurisdiction এবং access validity।
Documentation / Game flow
Game API flow
Player verification ও game launch থেকে bet, win, game round, operation rollback এবং financial reconciliation পর্যন্ত সম্পূর্ণ flow।
Session
player ও game launch
Balance
bet ও win
Round
game session flow
Rollback
operation recovery
Game lifecycle
Launch থেকে round closure পর্যন্ত
01
Game session তৈরি করুন
Player, game, currency, language, country, mode এবং return URL।
02
Game launch করুন
Temporary access key, launch URL এবং game availability check।
03
Financial operation process করুন
Balance check, bet, win, combined operation এবং platform response।
04
Round close ও reconcile করুন
Final result, rollback, financial ledger এবং provider report।
Overview
Game API player, round ও fund movement যুক্ত করে
Game launch এবং fund movement একই process-এর আলাদা অংশ। Session player ও launch condition নির্ধারণ করে, round provider action যুক্ত করে, আর platform API প্রতিটি debit, credit এবং rollback confirm করে।
Balance control
Platform available fund যাচাই করে এবং প্রতিটি bet, payout বা rollback একবারই apply করে।
Game financial ledger
Operation ও round ID, operation type, amount এবং balance before/after control ও reconciliation-এর জন্য সংরক্ষণ করা হয়।
Game launch
সাধারণ game launch flow
প্রথমে platform player ও game availability যাচাই করে, তারপর time-limited session তৈরি করে এবং provider থেকে launch URL নেয়।
01
Player ও game availability যাচাই করুন
Platform account status, currency, country, restriction, limit, real বা demo mode এবং game availability যাচাই করে।
02
Internal session তৈরি করুন
Player, game, brand, currency, language, IP এবং expiry data-সহ session ID তৈরি হয়।
03
Game launch URL নিন
Provider session key, notification ও return URL, device type, jurisdiction এবং interface parameter পায়।
04
Browser-এ game খুলুন
Player পাওয়া URL খোলে এবং পরবর্তী financial operation সরাসরি server-to-server চলে।
Balance operation
মূল balance operation
Provider অনুযায়ী method name ভিন্ন হলেও logic একই: balance check, bet debit, win credit এবং আগে confirmed operation rollback।
Balance check
Financial ledger পরিবর্তন না করে active session currency-তে player-এর available balance ফেরত দেয়।
Bet debit
Player, session, currency এবং available fund যাচাই করে, তারপর confirmed bet একবার debit করে।
Win credit
Unique operation ও round ID অনুযায়ী win credit করে, zero result-সহ।
এক request-এ bet ও result
Provider support করলে bet এবং game result একসঙ্গে apply করে।
Operation rollback
Original record না মুছে আগে confirmed bet বা payout-এর জন্য আলাদা correction operation তৈরি করে।
Bonus ও free spins
Real ও bonus fund আলাদা রেখে bonus campaign এবং game round data পাঠায়।
Currency ও amount precision
প্রতিটি operation currency, amount unit, decimal place এবং rounding rule যাচাই করে।
Platform response
Operation status, internal ID, current balance এবং unified error code ফেরত দেয়।
Round lifecycle
Game round lifecycle
একটি round-এ একাধিক bet ও result থাকতে পারে। এর state শুধু network request order নয়, game rule দ্বারা নির্ধারিত হয়।
Round তৈরি হয়েছে
Platform প্রথমবার round ID পেয়ে internal record তৈরি করে।
Round active
Round-এ additional bet, game action এবং intermediate win থাকতে পারে।
Bet accepted
Debit platform দ্বারা confirmed এবং provider-এর unique operation ID-এর সঙ্গে linked।
Result পাওয়া গেছে
Win বা zero result পাওয়া গেছে, তবে game rule অনুযায়ী round open থাকতে পারে।
Round closed
Provider round completion confirm করেছে এবং সব expected financial operation process হয়েছে।
Operation rollback হয়েছে
পূর্ণ original history রেখে এক বা একাধিক operation correction করা হয়েছে।
এক round-এ একাধিক operation থাকতে পারে
Round ID duplicate protection-এর একমাত্র key হওয়া উচিত নয়। প্রতিটি bet, payout এবং rollback-এর নিজস্ব unique ID থাকতে হবে।
Reliability ও reconciliation
Retry protection ও financial reconciliation
Game API-কে repeated request, response delay, operation order change এবং provider failure-এর পর recovery নিরাপদে handle করতে হবে।
Safe repeated processing
প্রতিটি financial action type-এর জন্য provider operation ID unique।
Repeated request fund আবার না সরিয়ে original result এবং current balance ফেরত দেয়।
Different amount, currency বা player-সহ retry data conflict হিসেবে reject হয়।
Rollback নির্দিষ্ট original operation-কে reference করে এবং নিজস্ব unique ID পায়।
Round ledger ও reconciliation
Session, round, provider operation এবং platform operation ID সংরক্ষণ করুন।
Operation type, amount, currency, balance before/after এবং processing time record করুন।
Posted record পরিবর্তন না করে আলাদা correction operation তৈরি করুন।
Provider report, game round, balance movement, GGR এবং পাওয়া discrepancy reconcile করুন।
Testing
Test environment-এ কী যাচাই করবেন
Test-এ game launch, player restriction, insufficient balance, repeated operation, response delay, rollback এবং closed-round reconciliation অন্তর্ভুক্ত হওয়া উচিত।
Launch ও game session
Real ও demo mode, invalid currency, blocked country, expired access এবং unavailable game।
Balance ও bet rejection
Insufficient fund, blocked player, currency mismatch এবং limit exceeded।
Delay ও unknown result
Actual debit-এর পর provider response না পেয়ে একই ID দিয়ে operation আবার পাঠায়।
Repeated bet ও win
একই ID processing শেষ হওয়ার আগে বা পরে আসে, conflicting parameter-সহও।
Operation rollback
Bet rollback, win rollback, repeated rollback এবং unknown original operation-এর reference।
Round reconciliation
Bet, win ও rollback amount, final status, balance movement এবং provider report মিলে যেতে হবে।
Launch-পূর্ব checklist
Game session, balance operation, retry protection, rollback এবং reporting যাচাইয়ের পর launch হয়।
Test ও production environment আলাদা access, API endpoint এবং launch setting ব্যবহার করে।
Game session key time-limited এবং player, game, currency ও brand-এর সঙ্গে linked।
প্রতিটি balance operation provider-এর unique ID দ্বারা সুরক্ষিত।
Repeated bet, win ও rollback দ্বিতীয়বার balance পরিবর্তন করে না।
Posted record মুছে ফেলা হয় না; আলাদা correction operation দিয়ে ঠিক করা হয়।
Event log, notification, provider report এবং round reconciliation process configured আছে।
Game API flow configure করতে চান?
Provider documentation, balance operation list, game round model, currency এবং reporting requirement দিন। APIACE game launch, bet, win, rollback ও financial reconciliation গুছিয়ে দিতে সাহায্য করবে।