Data game session
Pemain, brand, game, mata wang, negara, bahasa, mode, yurisdiksi, dan masa terpakai akses.
Dokumentasi / Game Flow
Game API flow
Aliran lengkap dari pengesahan pemain dan game launch hingga pemprosesan pertaruhan, kemenangan, game round, pembatalan operasi, dan rekonsiliasi kewangan.
Sesi
pemain dan game launch
Baki
pertaruhan dan kemenangan
Round
aliran game session
Pembatalan
recovery operasi
Game lifecycle
Dari launch hingga round ditutup
01
Buat game session
Pemain, game, mata wang, bahasa, negara, mode, dan return URL.
02
Launch game
Temporary access key, launch URL, dan semakan ketersediaan game.
03
Proses operasi kewangan
Semakan baki, pertaruhan, 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 bahagian berbeza dari satu proses. Session menentukan pemain dan syarat launch, round menghubungkan aktiviti provider, manakala API platform mengesahkan setiap debit, credit, dan pembatalan.
Kawalan baki
Platform menyemak dana yang tersedia dan menggunakan setiap pertaruhan, payout, atau pembatalan hanya satu kali.
Game financial ledger
Operation ID dan round ID, jenis operasi, jumlah, baki sebelum dan sesudah disimpan untuk kawalan dan rekonsiliasi.
Game launch
Senario standar game launch
Platform terlebih dahulu menyemak pemain dan ketersediaan game, kemudian membuat session dengan masa terpakai terbatas dan mendapatkan launch URL dari provider.
01
Semak pemain dan ketersediaan game
Platform menyemak status akaun, mata wang, negara, sekatan, had, real-money atau demo mode, serta ketersediaan game.
02
Buat dalaman session
Session ID dibuat dengan data pemain, game, brand, mata wang, bahasa, IP, dan masa terpakai.
03
Dapatkan game launch URL
Provider menerima session key, notification URL dan return URL, jenis peranti, yurisdiksi, dan parameter antara muka.
04
Buka game di pelayar
Pemain membuka URL yang diterima, manakala operasi kewangan seterusnya dilakukan langsung server-to-server.
Operasi baki
Operasi baki utama
Nama kaedah boleh berbeza antarprovider, namun logikanya sama: semak baki, debit pertaruhan, credit kemenangan, dan membatalkan operasi yang telah disahkan.
Semak baki
Mengembalikan baki tersedia pemain dalam mata wang session aktif tanpa mengubah financial ledger.
Debit pertaruhan
Menyemak pemain, session, mata wang, dan dana tersedia, kemudian mendebit pertaruhan yang disahkan satu kali.
Credit kemenangan
Mengredit kemenangan berdasarkan operation ID dan round ID unik, termasuk hasil nol.
Pertaruhan dan hasil dalam satu request
Menggunakan pertaruhan dan hasil game secara serentak jika skema tersebut disokong provider.
Pembatalan operasi
Membuat operasi pembetulan berasingan untuk pertaruhan atau payout yang telah disahkan tanpa memadam rekod awal.
Bonus dan Free Spins
Menghantar data bonus campaign dan game round dengan memisahkan real-money dan bonus funds.
Mata wang dan ketepatan jumlah
Setiap operasi menyemak mata wang, unit jumlah, jumlah perpuluhan, dan peraturan pembundaran.
Response platform
Mengembalikan status operasi, dalaman operation ID, baki semasa ini, dan error code bersepadu.
Round lifecycle
Game round lifecycle
Satu round boleh merangkumi beberapa pertaruhan dan hasil. Statusnya ditetapkan oleh peraturan game, bukan hanya turutan network request.
Round dibuat
Platform menerima round ID untuk kali pertama dan membuat rekod dalaman.
Round aktif
Round boleh berisi pertaruhan tambahan, aktiviti game, dan kemenangan sementara.
Pertaruhan diterima
Debit disahkan platform dan dihubungkan dengan provider operation ID yang unik.
Hasil diterima
Kemenangan atau hasil nol diterima, namun round boleh tetap terbuka sesuai peraturan game.
Round ditutup
Provider mengesahkan round selesai dan semua operasi kewangan yang dijangka telah diproses.
Operasi dibatalkan
Satu atau beberapa operasi dikoreksi dengan tetap mempertahankan keseluruhan rekod awal.
Satu round boleh merangkumi beberapa operasi
Round ID tidak boleh menjadi satu-satunya duplicate-protection key. Setiap pertaruhan, payout, dan pembatalan mesti memiliki identifier unik sendiri.
Kebolehpercayaan dan rekonsiliasi
Perlindungan duplicate dan rekonsiliasi kewangan
Game API mesti menangani duplicate request, response delay, perubahan turutan operasi, dan recovery provider selepas gangguan secara selamat.
Pemprosesan semula yang selamat
Provider operation ID bersifat unik untuk setiap jenis tindakan kewangan.
Duplicate request mengembalikan hasil awal dan baki terkini tanpa memindahkan dana semula.
Retry dengan jumlah, mata wang, atau pemain berbeza 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 wang, baki sebelum dan sesudah, serta masa pemprosesan.
Jangan mengubah rekod yang telah diposting; buat operasi pembetulan berasingan.
Rekonsiliasi laporan provider, game round, pergerakan baki, GGR, dan selisih yang ditemui.
Testing
Apa yang perlu diuji di testing environment
Pengujian mesti merangkumi game launch, sekatan pemain, baki tidak mencukupi, duplicate operation, response delay, pembatalan, dan rekonsiliasi round yang telah ditutup.
Launch dan game session
Real-money dan demo mode, mata wang salah, negara dilarang, akses tamat tempoh, dan game tidak tersedia.
Baki dan penolakan pertaruhan
Dana tidak mencukupi, pemain disekat, mata wang tidak sesuai, dan had melebihi had.
Delay dan hasil tidak diketahui
Provider tidak menerima response selepas debit betul-betul berlaku kemudian menghantar semula operasi dengan identifier yang sama.
Pertaruhan dan kemenangan berulang
Identifier yang sama datang sebelum atau selepas pemprosesan selesai, termasuk dengan parameter yang bertentangan.
Pembatalan operasi
Pembatalan pertaruhan, pembatalan kemenangan, pembatalan berulang, dan referensi ke operasi awal yang tidak dikenal.
Rekonsiliasi round
Jumlah pertaruhan, kemenangan, dan pembatalan, status akhir, pergerakan baki, dan laporan provider mesti sesuai.
Senarai semak sebelum pelancaran
Pelancaran dilakukan selepas game session, operasi baki, duplicate protection, pembatalan, dan reporting disahkan.
Test dan production environment menggunakan akses, endpoint API, dan konfigurasi launch yang berbeza.
Game session key memiliki masa terpakai terbatas dan terikat pada pemain, game, mata wang, dan brand.
Setiap operasi baki dilindungi oleh provider operation ID yang unik.
Pertaruhan, kemenangan, dan pembatalan berulang tidak mengubah baki untuk kedua kalinya.
Rekod yang telah diposting tidak dipadam dan dibetulkan melalui operasi pembetulan berasingan.
Event log, notifikasi, laporan provider, dan proses round reconciliation telah disediakan.
Perlu mengawal Game API flow?
Hantar dokumentasi provider, senarai operasi baki, model game round, mata wang, dan keperluan reporting. APIACE akan membantu menyusun game launch, pertaruhan, kemenangan, pembatalan, dan rekonsiliasi kewangan.