Data game session
Pemain, brand, game, mata uang, negara, bahasa, mode, yurisdiksi, dan masa berlaku akses.
Dokumentasi / Game Flow
Game API flow
Alur lengkap dari verifikasi pemain dan game launch hingga pemrosesan taruhan, kemenangan, game round, pembatalan operasi, dan rekonsiliasi keuangan.
Sesi
pemain dan game launch
Saldo
taruhan dan kemenangan
Round
alur game session
Pembatalan
recovery operasi
Game lifecycle
Dari launch hingga round ditutup
01
Buat game session
Pemain, game, mata uang, bahasa, negara, mode, dan return URL.
02
Launch game
Temporary access key, launch URL, dan pemeriksaan ketersediaan game.
03
Proses operasi finansial
Pemeriksaan saldo, taruhan, kemenangan, operasi gabungan, dan response platform.
04
Tutup dan rekonsiliasi round
Hasil akhir, pembatalan, financial ledger, dan laporan provider.
Ringkasan
Game API menghubungkan pemain, round, dan pergerakan dana
Game launch dan pergerakan dana adalah bagian berbeda dari satu proses. Session menentukan pemain dan kondisi launch, round menghubungkan aktivitas provider, sedangkan API platform mengonfirmasi setiap debit, credit, dan pembatalan.
Kontrol saldo
Platform memeriksa dana yang tersedia dan menerapkan setiap taruhan, payout, atau pembatalan hanya satu kali.
Game financial ledger
Operation ID dan round ID, jenis operasi, jumlah, saldo sebelum dan sesudah disimpan untuk kontrol dan rekonsiliasi.
Game launch
Skenario standar game launch
Platform terlebih dahulu memeriksa pemain dan ketersediaan game, kemudian membuat session dengan masa berlaku terbatas dan mendapatkan launch URL dari provider.
01
Periksa pemain dan ketersediaan game
Platform memeriksa status akun, mata uang, negara, pembatasan, limit, real-money atau demo mode, serta ketersediaan game.
02
Buat internal session
Session ID dibuat dengan data pemain, game, brand, mata uang, bahasa, IP, dan masa berlaku.
03
Dapatkan game launch URL
Provider menerima session key, notification URL dan return URL, jenis perangkat, yurisdiksi, dan parameter antarmuka.
04
Buka game di browser
Pemain membuka URL yang diterima, sedangkan operasi finansial berikutnya dilakukan langsung server-to-server.
Operasi saldo
Operasi saldo utama
Nama metode dapat berbeda antarprovider, namun logikanya sama: cek saldo, debit taruhan, credit kemenangan, dan membatalkan operasi yang sudah dikonfirmasi.
Cek saldo
Mengembalikan saldo tersedia pemain dalam mata uang session aktif tanpa mengubah financial ledger.
Debit taruhan
Memeriksa pemain, session, mata uang, dan dana tersedia, lalu mendebit taruhan yang dikonfirmasi satu kali.
Credit kemenangan
Mengredit kemenangan berdasarkan operation ID dan round ID unik, termasuk hasil nol.
Taruhan dan hasil dalam satu request
Menerapkan taruhan dan hasil game secara bersamaan jika skema tersebut didukung provider.
Pembatalan operasi
Membuat operasi koreksi terpisah untuk taruhan atau payout yang sudah dikonfirmasi tanpa menghapus catatan awal.
Bonus dan Free Spins
Mengirim data bonus campaign dan game round dengan memisahkan real-money dan bonus funds.
Mata uang dan presisi jumlah
Setiap operasi memeriksa mata uang, unit jumlah, jumlah desimal, dan aturan pembulatan.
Response platform
Mengembalikan status operasi, internal operation ID, saldo saat ini, dan error code terpadu.
Round lifecycle
Game round lifecycle
Satu round dapat mencakup beberapa taruhan dan hasil. Statusnya ditentukan oleh aturan game, bukan hanya urutan network request.
Round dibuat
Platform menerima round ID untuk pertama kali dan membuat catatan internal.
Round aktif
Round dapat berisi taruhan tambahan, aktivitas game, dan kemenangan sementara.
Taruhan diterima
Debit dikonfirmasi platform dan dihubungkan dengan provider operation ID yang unik.
Hasil diterima
Kemenangan atau hasil nol diterima, namun round dapat tetap terbuka sesuai aturan game.
Round ditutup
Provider mengonfirmasi round selesai dan semua operasi finansial yang diharapkan telah diproses.
Operasi dibatalkan
Satu atau beberapa operasi dikoreksi dengan tetap mempertahankan seluruh riwayat awal.
Satu round dapat mencakup beberapa operasi
Round ID tidak boleh menjadi satu-satunya duplicate-protection key. Setiap taruhan, payout, dan pembatalan harus memiliki identifier unik sendiri.
Keandalan dan rekonsiliasi
Perlindungan duplikasi dan rekonsiliasi keuangan
Game API harus menangani duplicate request, response delay, perubahan urutan operasi, dan recovery provider setelah gangguan secara aman.
Pemrosesan ulang yang aman
Provider operation ID bersifat unik untuk setiap jenis tindakan finansial.
Duplicate request mengembalikan hasil awal dan saldo terbaru tanpa memindahkan dana kembali.
Retry dengan jumlah, mata uang, atau pemain berbeda ditolak sebagai konflik data.
Pembatalan mengacu pada operasi awal tertentu dan juga mendapat identifier unik sendiri.
Round ledger dan rekonsiliasi
Simpan session ID, round ID, provider operation ID, dan platform operation ID.
Catat jenis operasi, jumlah, mata uang, saldo sebelum dan sesudah, serta waktu pemrosesan.
Jangan mengubah catatan yang sudah diposting; buat operasi koreksi terpisah.
Rekonsiliasi laporan provider, game round, pergerakan saldo, GGR, dan selisih yang ditemukan.
Testing
Apa yang perlu diuji di test environment
Pengujian harus mencakup game launch, pembatasan pemain, saldo tidak cukup, duplicate operation, response delay, pembatalan, dan rekonsiliasi round yang sudah ditutup.
Launch dan game session
Real-money dan demo mode, mata uang salah, negara dilarang, akses kedaluwarsa, dan game tidak tersedia.
Saldo dan penolakan taruhan
Dana tidak cukup, pemain diblokir, mata uang tidak cocok, dan limit terlampaui.
Delay dan hasil tidak diketahui
Provider tidak menerima response setelah debit benar-benar terjadi lalu mengirim ulang operasi dengan identifier yang sama.
Taruhan dan kemenangan berulang
Identifier yang sama datang sebelum atau setelah pemrosesan selesai, termasuk dengan parameter yang bertentangan.
Pembatalan operasi
Pembatalan taruhan, pembatalan kemenangan, pembatalan berulang, dan referensi ke operasi awal yang tidak dikenal.
Rekonsiliasi round
Jumlah taruhan, kemenangan, dan pembatalan, status akhir, pergerakan saldo, dan laporan provider harus sesuai.
Checklist sebelum peluncuran
Peluncuran dilakukan setelah game session, operasi saldo, duplicate protection, pembatalan, dan reporting diverifikasi.
Test dan production environment menggunakan akses, endpoint API, dan konfigurasi launch yang berbeda.
Game session key memiliki masa berlaku terbatas dan terikat pada pemain, game, mata uang, dan brand.
Setiap operasi saldo dilindungi oleh provider operation ID yang unik.
Taruhan, kemenangan, dan pembatalan berulang tidak mengubah saldo untuk kedua kalinya.
Catatan yang sudah diposting tidak dihapus dan diperbaiki melalui operasi koreksi terpisah.
Event log, notifikasi, laporan provider, dan proses round reconciliation telah disiapkan.
Perlu mengatur Game API flow?
Kirim dokumentasi provider, daftar operasi saldo, model game round, mata uang, dan kebutuhan reporting. APIACE akan membantu menyusun game launch, taruhan, kemenangan, pembatalan, dan rekonsiliasi keuangan.