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
| Isici | I-single wallet | I-transfer wallet |
|---|---|---|
| Ukuphatha ibhalansi | Isizindalwazi sakho siphethe ibhalansi eyodwa kuphela. Umhlinzeki akakaze agcine imali yabadlali. | Umhlinzeki ugcina ibhalansi yomdlalo ehlukile. Imali ingena iphume ngezingcingo zokudlulisa. |
| Izingcingo ngesikhathi sokubheja | Konke 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 okudingekayo | Ama-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 yokuvumelana | Ileja yakho ingumthombo weqiniso wesikhathi sangempela. Imizuliswano yemidlalo kuphela edinga ukuqhathaniswa, hhayi amabhalansi. | Amaleja amabili avumelana kuphela emingceleni yokudlulisa. Kudinga ukuqhathanisa ezingeni lokudlulisa. |
| Ukululama ekwehlulekeni | Ukuphelelwa 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 wokuxhuma | Uphezulu. 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 kumdlali | Ibhalansi 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 ukufaneleka | Abaqhubi 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
- Ukuqalisa: i-backend yakho icela i-SSG i-URL yomdlalo ne-ID yomdlali nethokheni yeseshini.
- Ukubheja: emzuliswaneni ngamunye i-SSG ibiza i-debit ne-txId eyingqayizivele. Uhlola imali, ubhala umugqa weleja bese ubuyisela ibhalansi entsha.
- Ukuwina: i-SSG ibiza i-credit nemali ewinwe (engaba uziro) yomzuliswano ofanayo.
- Ukwehluleka: uma ucingo luphelelwa yisikhathi i-SSG iphinda izame ne-txId efanayo, futhi ngemuva komkhawulo wokuzama ithumela i-rollback.
Izindlela ze-callback (isibonelo)
| Indlela | Inhloso | Izinkambu ezibalulekile | I-idempotent |
|---|---|---|---|
balance | Buyisela ibhalansi yamanje yomdlali. | playerId, currency | Yebo (ukufunda kuphela) |
debit | Beja: susa inani. | playerId, txId, roundId, gameId, amount, currency | Nge-txId |
credit | Lungisa ukuwina: engeza inani. | playerId, txId, roundId, amount, currency | Nge-txId |
rollback | Khansela i-debit noma i-credit yangaphambili ngemuva kwephutha. | txId, refTxId | Nge-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_ERRORImithetho 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
- Ukudlulisela ngaphakathi: i-backend yakho ibiza i-transferIn ne-txId eyingqayizivele nenani. Umphumela uba yi-PENDING noma i-SUCCESS.
- Ukudlala: qalisa umdlalo. Konke ukubheja nokuwina kushintsha ibhalansi yohlangothi lomhlinzeki ngaphandle kwama-callback kuwe.
- Ukudlulisela ngaphandle: uma umdlali ehamba, biza i-transferOut yebhalansi yonke bese uyibuyisela kuleja yakho ku-SUCCESS.
- Umphumela ongaziwa: uma ucingo lokudlulisa luphelelwa yisikhathi, buza i-getTransferStatus ne-txId efanayo ngaphambi kokwenza noma yini.
Izindlela ze-API (isibonelo)
| Indlela | Inhloso | Izinkambu ezibalulekile | I-idempotent |
|---|---|---|---|
transferIn | Dlulisa imali isuka ku-wallet yakho iye kubhalansi yomdlalo yomdlali. | playerId, txId, amount, currency | Nge-txId |
transferOut | Dlulisa imali isuka kubhalansi yomdlalo ibuyele ku-wallet yakho. | playerId, txId, amount | all | Nge-txId |
getBalance | Funda ibhalansi yomdlalo yomdlali. | playerId | Yebo (ukufunda kuphela) |
getTransferStatus | Buyisela i-PENDING, i-SUCCESS noma i-FAILED ye-txId. | txId | Yebo (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
| Isimo | I-single wallet | I-transfer wallet |
|---|---|---|
| Ukuphelelwa yisikhathi kwenethiwekhi | Ngesikhathi 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 alusebenzi | Abadlali abakwazi ukuqala noma ukuqhubeka nemizuliswano. Imizuliswano evulekile iyahlehliswa. | Abadlali baqhubeka bedlala ngebhalansi yabo yomdlalo ekhona. Ukudlulisa okusha kuvinjiwe. |
| Isicelo esiphindiwe | Buyisela impendulo egciniwe yaleyo txId futhi ungashintshi lutho. | Buyisela umphumela ogciniwe waleyo txId futhi ungashintshi lutho. |
| Umdlali uyanqamuka phakathi nomzuliswano | Umzuliswano uphela kumhlinzeki futhi i-credit ithunyelwa njengokujwayelekile. | Umzuliswano uyaphela futhi imali ihlala kubhalansi yomdlalo kuze kube nokudlulisela ngaphandle noma umsebenzi wokushanela. |
| Ukungafani kwebhalansi | Imvamisa 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