SSG Gaming

I-API Yemikhiqizo I-single wallet ne-transfer wallet

I-single wallet ne-transfer wallet

Ukuqhathanisa kobuchwepheshe kwamamodeli amabili e-wallet asetshenziselwa ukuxhuma ibhalansi yomdlali yomqhubi ne-casino game API: ubani ophethe imali, yiziphi izingcingo ezidlula kunethiwekhi ngesikhathi sokubheja, ukwehluleka kululanyiswa kanjani, nokuthi yini okufanele uyakhe ohlangothini lwakho.

Ngokushesha

IsiciI-single walletI-transfer wallet
Ukuphatha ibhalansiIsizindalwazi sakho siphethe ibhalansi eyodwa kuphela. Umhlinzeki akakaze agcine imali yabadlali.Umhlinzeki ugcina ibhalansi yomdlalo ehlukile. Imali ingena iphume ngezingcingo zokudlulisa.
Izingcingo ngesikhathi sokubhejaKonke ukubheja nokuwina kubangela i-callback yeseva-kuya-kuseva kuwe (ibhalansi, i-debit, i-credit, i-rollback).Azikho. Umdlalo usebenza ngebhalansi yohlangothi lomhlinzeki. Izingcingo zenzeka kuphela uma kudluliselwa ngaphakathi nangaphandle.
Ukutholakala okudingekayoAma-endpoint e-wallet yakho kufanele aphendule yonke i-callback, imvamisa phakathi kwamakhulu ambalwa ama-millisecond. Uma ehlile, umdlalo uyama.Kudingeka kuphela ekudluliseni. Imizuliswano iyaqhubeka uma uhlelo lwakho lucishe kancane.
Imodeli yokuvumelanaIleja yakho ingumthombo weqiniso wesikhathi sangempela. Imizuliswano yemidlalo kuphela edinga ukuqhathaniswa, hhayi amabhalansi.Amaleja amabili avumelana kuphela emingceleni yokudlulisa. Kudinga ukuqhathanisa ezingeni lokudlulisa.
Ukululama ekwehlulekeniUkuphelelwa yisikhathi kuxazululwa ngokuzama futhi okune-idempotency nezingcingo ze-rollback ezihlanganiswe ne-ID yokuhwebelana.Ukudlulisa kunezigaba ezimbili: kulindile, bese kuphumelela noma kwehluleka. Umbuzo wesimo uxazulula imiphumela engaziwa.
Umzamo wokuxhumaUphezulu. Wakha futhi uqhube insizakalo ye-callback esheshayo ene-idempotency neleja.Uphansi. Ubiza ama-REST endpoint amathathu noma amane, ngaphandle kwethrafikhi engenayo okufanele uyivikele noma uyikhulise.
Okwenzeka kumdlaliIbhalansi eyodwa, asikho isinyathelo sokudlulisa. Kufanele amabhonasi, ukudlala imikhiqizo eyahlukene nokubonisa ibhalansi bukhoma.Imali idluliselwa ngaphakathi ngaphambi kokudlala futhi iphume ngemuva. Kwengeza ukubambezeleka okufushane nobungozi bebhalansi esalayo uma umdlali ehamba phakathi neseshini.
Okuvamile ukufanelekaAbaqhubi abane-wallet noma inkundla yabo nokulawula okuqinile kwezimali nemikhankaso.Abaqhubi abafuna ukuqala ngokushesha noma abangenayo insizakalo ye-wallet yesikhathi sangempela.

I-single wallet (seamless)

Kumodeli ye-single wallet (seamless) uhlelo lwakho luyi-wallet. Uma umdlali ebheja i-SSG API ibiza i-callback endpoint yakho, ushintsha ibhalansi kuleja yakho, bese uphendula ngebhalansi entsha. Ayikho imali ephuma esizindalwazini sakho.

Ukuhamba kwezingcingo

PlayerOperatorSSG APIloop1. open game2. launch(playerId, token)3. launchUrl4. spin5. debit(txId, roundId, amount)6. OK, balance7. credit(txId, roundId, win)8. OK, balance9. rollback(txId) [on timeout]
  1. Ukuqalisa: i-backend yakho icela i-SSG i-URL yomdlalo ne-ID yomdlali nethokheni yeseshini.
  2. Ukubheja: emzuliswaneni ngamunye i-SSG ibiza i-debit ne-txId eyingqayizivele. Uhlola imali, ubhala umugqa weleja bese ubuyisela ibhalansi entsha.
  3. Ukuwina: i-SSG ibiza i-credit nemali ewinwe (engaba uziro) yomzuliswano ofanayo.
  4. Ukwehluleka: uma ucingo luphelelwa yisikhathi i-SSG iphinda izame ne-txId efanayo, futhi ngemuva komkhawulo wokuzama ithumela i-rollback.

Izindlela ze-callback (isibonelo)

IndlelaInhlosoIzinkambu ezibalulekileI-idempotent
balanceBuyisela ibhalansi yamanje yomdlali.playerId, currencyYebo (ukufunda kuphela)
debitBeja: susa inani.playerId, txId, roundId, gameId, amount, currencyNge-txId
creditLungisa ukuwina: engeza inani.playerId, txId, roundId, amount, currencyNge-txId
rollbackKhansela i-debit noma i-credit yangaphambili ngemuva kwephutha.txId, refTxIdNge-txId

Isibonelo sesicelo se-debit

{
  "method": "debit",
  "playerId": "p_839201",
  "txId": "tx_20261007_000184",
  "roundId": "r_77f3a1",
  "gameId": "slots_fruit_01",
  "currency": "MYR",
  "amount": "2.50",
  "ts": 1791338577,
  "sign": "hex(HMAC-SHA256(secret, canonical))"
}

Isibonelo sempendulo

{
  "status": "OK",
  "txId": "tx_20261007_000184",
  "balance": "97.50",
  "currency": "MYR"
}
// errors: INSUFFICIENT_FUNDS, PLAYER_NOT_FOUND,
//         DUPLICATE_TX (return original result), INTERNAL_ERROR

Imithetho okufanele insizakalo ye-wallet yakho iyilandele

I-idempotency
I-debit noma i-credit ephindiwe ne-txId efanayo kufanele ibuyisele umphumela wokuqala futhi ingaphindi ihambise imali. Yiphoqelele nge-unique index ku-txId.
Ukubhala kweleja okuphelele
Hlola ibhalansi, faka umugqa weleja bese ubuyekeza ibhalansi ekuhwebelaneni okukodwa kwesizindalwazi, ukuze ukubheja okubili ngasikhathi sinye kungeqi imali ekhona.
I-rollback ngaphambi kwe-debit
I-rollback ingafika ye-txId ongakaze uyibone ngoba i-debit yokuqala iphelelwe yisikhathi. Gcina uphawu ukuze i-debit efika sekwephuzile naleyo txId yenqatshwe.
Isabelo sokubambezeleka
Hlose i-p99 engaphansi kuka-500 ms kuhlanganise nenethiwekhi. Gcina indlela ye-callback ekufundeni okukodwa okune-index nasekubhaleni okukodwa, futhi ugcine imibuzo yemibiko ingekho kuyo.
Ifomethi yemali
Phatha amanani njengemicu yedesimali noma amayunithi amancane aphelele. Ungalokothi usebenzise i-floating point, futhi uqinisekise imali ngokuqhathanisa ne-akhawunti yomdlali.
Amabhonasi nama-free spin
I-free spin iyi-debit engu-0 elandelwa yi-credit yokuwina. Gcina amabhalansi emikhankaso ehlukile kubhalansi yemali kuleja yakho.
Ukuphepha
Qinisekisa isiginesha ye-HMAC-SHA256 phezu kwesicelo esijwayelekile, yenqaba izikhathi ezindala, vumela ama-IP omthombo e-SSG kuphela, futhi udinge i-TLS 1.2 noma ngaphezulu.
Ukuqhathanisa
Qhathanisa imibiko yemizuliswano yansuku zonke evela ku-SSG neleja yakho nge-roundId. Umehluko ukhomba ama-callback noma ama-rollback aphuthiwe.

I-transfer wallet

Kumodeli ye-transfer wallet umhlinzeki ugcina ibhalansi yomdlalo yomdlali ngamunye. I-backend yakho idlulisela imali ngaphakathi ngaphambi kokudlala futhi iyikhiphe ngemuva. Ngesikhathi sokudlala awekho ama-callback ohlelweni lwakho, ngakho udinga kuphela izingcingo ze-REST eziphumayo.

Ukuhamba kwezingcingo

PlayerOperatorSSG APIplay1. transferIn(txId, amount)2. PENDING or SUCCESS3. launch(playerId)4. launchUrl5. spin (no callbacks to Operator)6. getBalance(playerId)7. balance8. transferOut(txId, all)9. SUCCESS, amount
  1. Ukudlulisela ngaphakathi: i-backend yakho ibiza i-transferIn ne-txId eyingqayizivele nenani. Umphumela uba yi-PENDING noma i-SUCCESS.
  2. Ukudlala: qalisa umdlalo. Konke ukubheja nokuwina kushintsha ibhalansi yohlangothi lomhlinzeki ngaphandle kwama-callback kuwe.
  3. Ukudlulisela ngaphandle: uma umdlali ehamba, biza i-transferOut yebhalansi yonke bese uyibuyisela kuleja yakho ku-SUCCESS.
  4. Umphumela ongaziwa: uma ucingo lokudlulisa luphelelwa yisikhathi, buza i-getTransferStatus ne-txId efanayo ngaphambi kokwenza noma yini.

Izindlela ze-API (isibonelo)

IndlelaInhlosoIzinkambu ezibalulekileI-idempotent
transferInDlulisa imali isuka ku-wallet yakho iye kubhalansi yomdlalo yomdlali.playerId, txId, amount, currencyNge-txId
transferOutDlulisa imali isuka kubhalansi yomdlalo ibuyele ku-wallet yakho.playerId, txId, amount | allNge-txId
getBalanceFunda ibhalansi yomdlalo yomdlali.playerIdYebo (ukufunda kuphela)
getTransferStatusBuyisela i-PENDING, i-SUCCESS noma i-FAILED ye-txId.txIdYebo (ukufunda kuphela)

Imithetho okufanele i-backend yakho iyilandele

I-txId eyodwa ngenhloso ngayinye
Dala i-txId ngaphambi kocingo lokuqala futhi uyisebenzise kabusha kukho konke ukuzama futhi. Ungadali i-txId entsha kuze kwaziwe isimo sangaphambilini.
Qala nge-debit kuleja yakho
Ekudluliseleni ngaphakathi, bekela inani kuleja yakho ngaphambi kokubiza i-SSG, bese uyiqinisekisa noma uyikhulule uma isimo sesiphelele.
Shanela amabhalansi asalayo
Qhuba umsebenzi othola abadlali abanebhalansi yomdlalo kodwa abangenayo iseshini esebenzayo, bese uyidlulisela ngaphandle. Lokhu kuhlanganisa abadlali abavala isiphequluli phakathi neseshini.
Ukubheja kanye nemibiko
Njengoba ungaboni ukubheja bukhoma, bala inani elibhejiwe, ukubheja kwamabhonasi nemikhawulo yobungozi kusukela emibikweni yemizuliswano ekhishwe ku-SSG, hhayi kuma-callback.
Ukuqhathanisa
Qhathanisa konke ukudlulisela ngaphakathi nangaphandle namarekhodi e-SSG nge-txId, futhi uxwayise nganoma iyiphi i-PENDING endala kunesikhathi sakho sokuphelelwa.
Ukuphepha
Sayina izicelo nge-HMAC-SHA256, biza kuphela nge-TLS 1.2 noma ngaphezulu, gcina okhiye be-API endaweni yezimfihlo, futhi ukhawulele ukuthi yimaphi amaseva akho angabiza i-SSG.

Izimo zokwehluleka

IsimoI-single walletI-transfer wallet
Ukuphelelwa yisikhathi kwenethiwekhiNgesikhathi sokubheja i-SSG iphinda izame i-txId efanayo, bese ithumela i-rollback ngemuva komkhawulo wokuzama. Kufanele ube ne-idempotency.Kuthinteka ukudlulisa kuphela. Buza i-getTransferStatus ne-txId efanayo, bese wenza.
Uhlelo lwakho alusebenziAbadlali abakwazi ukuqala noma ukuqhubeka nemizuliswano. Imizuliswano evulekile iyahlehliswa.Abadlali baqhubeka bedlala ngebhalansi yabo yomdlalo ekhona. Ukudlulisa okusha kuvinjiwe.
Isicelo esiphindiweBuyisela impendulo egciniwe yaleyo txId futhi ungashintshi lutho.Buyisela umphumela ogciniwe waleyo txId futhi ungashintshi lutho.
Umdlali uyanqamuka phakathi nomzuliswanoUmzuliswano uphela kumhlinzeki futhi i-credit ithunyelwa njengokujwayelekile.Umzuliswano uyaphela futhi imali ihlala kubhalansi yomdlalo kuze kube nokudlulisela ngaphandle noma umsebenzi wokushanela.
Ukungafani kwebhalansiImvamisa i-callback noma i-rollback ephuthiwe. Kutholakala ngokuqhathanisa imibiko yemizuliswano nge-roundId.Imvamisa ukudlulisa okusalile noma okulindile. Kutholakala ngokuqhathanisa ukudlulisa nge-txId.

Iyiphi okufanele uyikhethe

Khetha i-single wallet uma

  • Usuqhuba insizakalo ye-wallet noma yeleja yesikhathi sangempela.
  • Udinga ibhalansi eyodwa ku-sportsbook, ku-casino nasemikhankasweni.
  • Udinga idatha yokubheja bukhoma yobungozi, ukubheja kwamabhonasi noma imikhawulo yokudlala ngokuzibophezela.
  • Ithimba lakho lingaqhuba insizakalo esheshayo etholakala kakhulu.

Khetha i-transfer wallet uma

  • Ufuna ukuqala ngokushesha ngobunjiniyela obuncane.
  • Awukabi nayo insizakalo ye-wallet yesikhathi sangempela.
  • Ukhetha izingcingo eziphumayo kuphela, ngaphandle kwe-callback yomphakathi okufanele uyivikele.
  • Izikhathi ezimfushane zebhalansi esalayo ziyamukeleka futhi ungaqhuba umsebenzi wokushanela.

Abaqhubi abaningi baqala nge-transfer wallet ukuze baqale ukusebenza, bese bethuthela ku-single wallet uma insizakalo yabo ye-wallet isilungile. Sibuze ukuthi ukushintsha kwenziwa kanjani ngezigaba.

Uhlu lokuhlola lokuxhuma

  • I-unique index ku-txId nezibambi ze-idempotent zazo zonke izingcingo ezihambisa imali
  • Ukuhlola isiginesha ye-HMAC, ukubekezelela isikhathi nohlu lwama-IP avunyelwe
  • Amanani aphephile kwidesimali nokuqinisekisa imali
  • Ukuhlolwa kokuphelelwa yisikhathi, ukuzama futhi ne-rollback ku-sandbox, kuhlanganise nokuzama futhi okwephuzile
  • Umsebenzi wokuqhathanisa wansuku zonke nge-roundId (single) noma i-txId (transfer)
  • Ukuqapha nezexwayiso: ukubambezeleka kwe-callback, izinga lamaphutha, ukudlulisa okulindile, amabhalansi asalayo

Khuluma nonjiniyela wokuxhuma

Singahamba nonjiniyela bakho ku-sandbox futhi sikusize ukhethe imodeli efanele inkundla yakho. Ukuxhuma kuqinisekisiwe ngaphansi kwezinsuku eziyisikhombisa.

Thumela i-imeyili kubathengisi Xoxa ku-Telegram Buyela ku-Product API

sales@ssggaming.com