Product API Single wallet dhidi ya transfer wallet
Single wallet dhidi ya transfer wallet
Ulinganisho wa kiufundi wa mifumo miwili ya pochi inayotumika kuunganisha salio la mchezaji la mwendeshaji na API ya michezo ya kasino: nani anashikilia pesa, ni maombi gani yanavuka mtandao wakati wa dau, jinsi hitilafu zinavyorekebishwa, na unachopaswa kujenga upande wako.
Kwa haraka
| Kipengele | Single wallet | Transfer wallet |
|---|---|---|
| Uhifadhi wa salio | Hifadhidata yako inashikilia salio pekee. Mtoa huduma hashikilii kamwe pesa za wachezaji. | Mtoa huduma anashikilia salio tofauti la mchezo. Pesa zinaingia na kutoka kwa maombi ya uhamisho. |
| Maombi wakati wa dau | Kila dau na ushindi husababisha callback ya seva kwa seva kwako (balance, debit, credit, rollback). | Hakuna. Mchezo unaendeshwa dhidi ya salio la upande wa mtoa huduma. Maombi hufanyika tu wakati wa kuingiza na kutoa pesa. |
| Upatikanaji unaohitajika | Endpoints za pochi yako lazima zijibu kila callback, kwa kawaida ndani ya milisekunde mia chache. Zikiwa chini, mchezo unasimama. | Unahitajika kwa uhamisho tu. Raundi zinaendelea hata mfumo wako ukiwa nje ya mtandao kwa muda mfupi. |
| Mfumo wa uthabiti | Leja yako ndiyo chanzo cha ukweli kwa wakati halisi. Raundi za michezo pekee zinahitaji upatanisho, si salio. | Leja mbili zinazokubaliana tu kwenye mipaka ya uhamisho. Zinahitaji upatanisho wa kiwango cha uhamisho. |
| Urejeshaji baada ya hitilafu | Muda unapoisha, hutatuliwa kwa kujaribu tena kwa idempotency na maombi ya rollback yanayotambuliwa kwa ID ya muamala. | Uhamisho ni wa awamu mbili: pending, kisha success au failed. Swali la hali hutatua matokeo yasiyojulikana. |
| Juhudi za muunganisho | Juu zaidi. Unajenga na kuendesha huduma ya callback yenye kasi kubwa, idempotency na leja. | Chini zaidi. Unaita endpoints tatu au nne za REST, bila trafiki inayoingia ya kulinda au kupanua. |
| Uzoefu wa mchezaji | Salio moja, bila hatua ya uhamisho. Inafaa bonasi, kucheza bidhaa mbalimbali na kuonyesha salio moja kwa moja. | Pesa zinaingizwa kabla ya kucheza na kutolewa baadaye. Inaongeza ucheleweshaji mfupi na hatari ya salio kukwama mchezaji akiondoka katikati ya kipindi. |
| Inafaa kwa kawaida | Waendeshaji wenye pochi au jukwaa lao wenyewe na udhibiti mkali wa fedha na ofa. | Waendeshaji wanaotaka kuanza haraka au wasio na huduma ya pochi ya wakati halisi. |
Single wallet (seamless)
Katika mfumo wa single wallet (seamless) mfumo wako ndio pochi. Mchezaji anapoweka dau SSG API inaita endpoint yako ya callback, unabadilisha salio kwenye leja yako, na unajibu kwa salio jipya. Hakuna pesa zinazotoka kwenye hifadhidata yako.
Mtiririko wa maombi
- Uzinduzi: backend yako inaomba SSG URL ya mchezo pamoja na ID ya mchezaji na tokeni ya kipindi.
- Dau: kwa kila raundi SSG inaita debit kwa txId ya kipekee. Unakagua salio, unaandika safu ya leja na kurudisha salio jipya.
- Ushindi: SSG inaita credit kwa malipo ya ushindi (yanaweza kuwa sifuri) kwa raundi ileile.
- Hitilafu: ombi likichukua muda mrefu mno SSG inajaribu tena kwa txId ileile, na baada ya kikomo cha majaribio inatuma rollback.
Mbinu za callback (mfano)
| Mbinu | Madhumuni | Sehemu muhimu | Idempotent |
|---|---|---|---|
balance | Rudisha salio la sasa la mchezaji. | playerId, currency | Ndiyo (kusoma tu) |
debit | Weka dau: toa kiasi. | playerId, txId, roundId, gameId, amount, currency | Kwa txId |
credit | Lipa ushindi: ongeza kiasi. | playerId, txId, roundId, amount, currency | Kwa txId |
rollback | Futa debit au credit ya awali baada ya hitilafu. | txId, refTxId | Kwa txId |
Mfano wa ombi la 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))"
}Mfano wa jibu
{
"status": "OK",
"txId": "tx_20261007_000184",
"balance": "97.50",
"currency": "MYR"
}
// errors: INSUFFICIENT_FUNDS, PLAYER_NOT_FOUND,
// DUPLICATE_TX (return original result), INTERNAL_ERRORKanuni ambazo huduma yako ya pochi lazima ifuate
- Idempotency
- Debit au credit inayorudiwa yenye txId ileile lazima irudishe matokeo ya awali na isihamishe pesa tena. Itekeleze kwa index ya kipekee kwenye txId.
- Uandishi wa leja kwa pamoja
- Kagua salio, ingiza safu ya leja na usasishe salio ndani ya muamala mmoja wa hifadhidata, ili madau mawili ya wakati mmoja yasizidishe matumizi.
- Rollback kabla ya debit
- Rollback inaweza kufika kwa txId usiyowahi kuiona kwa sababu debit ya awali ilichukua muda mrefu mno. Hifadhi alama ili debit iliyochelewa yenye txId hiyo ikataliwe.
- Bajeti ya muda wa kujibu
- Lenga p99 chini ya 500 ms ikijumuisha mtandao. Weka njia ya callback iwe usomaji mmoja wenye index na uandishi mmoja, na weka maswali ya ripoti nje yake.
- Muundo wa pesa
- Chukulia kiasi kama mfuatano wa desimali au vipimo vidogo vya nambari kamili. Usitumie kamwe floating point, na hakiki sarafu dhidi ya akaunti ya mchezaji.
- Bonasi na spins za bure
- Spin ya bure ni debit ya 0 ikifuatwa na credit ya ushindi. Weka salio la ofa tofauti na salio la pesa taslimu kwenye leja yako.
- Usalama
- Thibitisha sahihi ya HMAC-SHA256 juu ya ombi la kanuni, kataa timestamps zilizopitwa na wakati, ruhusu IP za chanzo za SSG pekee, na hitaji TLS 1.2 au zaidi.
- Upatanisho
- Linganisha ripoti za kila siku za raundi kutoka SSG na leja yako kwa roundId. Tofauti zinaonyesha callbacks au rollbacks zilizokosekana.
Transfer wallet
Katika mfumo wa transfer wallet mtoa huduma anashikilia salio la mchezo kwa kila mchezaji. Backend yako inaingiza pesa kabla ya kucheza na kuzitoa baadaye. Wakati wa kucheza hakuna callbacks kwa mfumo wako, kwa hiyo unahitaji maombi ya REST yanayotoka tu.
Mtiririko wa maombi
- Kuingiza: backend yako inaita transferIn kwa txId ya kipekee na kiasi. Matokeo ni PENDING au SUCCESS.
- Kucheza: zindua mchezo. Madau yote na ushindi hubadilisha salio la upande wa mtoa huduma bila callbacks kwako.
- Kutoa: mchezaji anapoondoka, ita transferOut kwa salio lote na uliweke tena kwenye leja yako ikiwa SUCCESS.
- Matokeo yasiyojulikana: ombi la uhamisho likichukua muda mrefu mno, uliza getTransferStatus kwa txId ileile kabla ya kufanya kitu kingine.
Mbinu za API (mfano)
| Mbinu | Madhumuni | Sehemu muhimu | Idempotent |
|---|---|---|---|
transferIn | Hamisha pesa kutoka pochi yako kwenda salio la mchezo la mchezaji. | playerId, txId, amount, currency | Kwa txId |
transferOut | Hamisha pesa kutoka salio la mchezo kurudi kwenye pochi yako. | playerId, txId, amount | all | Kwa txId |
getBalance | Soma salio la mchezo la mchezaji. | playerId | Ndiyo (kusoma tu) |
getTransferStatus | Rudisha PENDING, SUCCESS au FAILED kwa txId. | txId | Ndiyo (kusoma tu) |
Kanuni ambazo backend yako lazima ifuate
- txId moja kwa kila nia
- Tengeneza txId kabla ya ombi la kwanza na uitumie tena kwa kila jaribio. Usiunde txId mpya hadi hali ya ile ya awali ijulikane.
- Toa kwenye leja yako kwanza
- Kwa kuingiza, hifadhi kiasi kwenye leja yako kabla ya kuita SSG, kisha kithibitishe au kiachilie hali inapokuwa ya mwisho.
- Fagia salio lililokwama
- Endesha kazi inayotafuta wachezaji wenye salio la mchezo bila kipindi kinachoendelea, kisha inalitoa. Hii inashughulikia wachezaji wanaofunga kivinjari katikati ya kipindi.
- Masharti ya kubeti na ripoti
- Kwa kuwa huoni madau moja kwa moja, kokotoa mauzo, masharti ya bonasi na vikomo vya hatari kutoka ripoti za raundi zinazovutwa kutoka SSG, si kutoka callbacks.
- Upatanisho
- Linganisha kila uhamisho wa kuingiza na kutoa dhidi ya rekodi za SSG kwa txId, na toa tahadhari kwa PENDING yoyote iliyozidi muda wako wa kusubiri.
- Usalama
- Weka sahihi kwenye maombi kwa HMAC-SHA256, ita tu kupitia TLS 1.2 au zaidi, hifadhi funguo za API kwenye hifadhi ya siri, na zuia seva zipi zako zinaweza kuita SSG.
Hali za hitilafu
| Hali | Single wallet | Transfer wallet |
|---|---|---|
| Muda wa mtandao kuisha | Wakati wa dau SSG inajaribu tena txId ileile, kisha inatuma rollback baada ya kikomo cha majaribio. Lazima uwe idempotent. | Uhamisho pekee ndio unaathirika. Uliza getTransferStatus kwa txId ileile, kisha chukua hatua. |
| Mfumo wako uko chini | Wachezaji hawawezi kuanza au kuendelea na raundi. Raundi zilizo wazi zinarudishwa nyuma. | Wachezaji wanaendelea kucheza kwa salio lao la mchezo lililopo. Uhamisho mpya umezuiwa. |
| Ombi lililorudiwa | Rudisha jibu lililohifadhiwa kwa txId hiyo na usibadilishe chochote. | Rudisha matokeo yaliyohifadhiwa kwa txId hiyo na usibadilishe chochote. |
| Mchezaji anakatika katikati ya raundi | Raundi inamalizika kwa mtoa huduma na credit inatumwa kama kawaida. | Raundi inamalizika na pesa zinabaki kwenye salio la mchezo hadi kutoa au kazi ya kufagia. |
| Salio kutolingana | Kwa kawaida callback au rollback iliyokosekana. Hugunduliwa kwa kulinganisha ripoti za raundi kwa roundId. | Kwa kawaida uhamisho uliokwama au unaosubiri. Hugunduliwa kwa kulinganisha uhamisho kwa txId. |
Uchague ipi
Chagua single wallet ikiwa
- Tayari unaendesha huduma ya pochi au leja ya wakati halisi.
- Unahitaji salio moja kwa sportsbook, kasino na ofa.
- Unahitaji data ya madau moja kwa moja kwa hatari, masharti ya bonasi au vikomo vya michezo ya kuwajibika.
- Timu yako inaweza kuendesha huduma yenye kasi kubwa na upatikanaji wa juu.
Chagua transfer wallet ikiwa
- Unataka kuanza haraka kwa kazi ndogo zaidi ya uhandisi.
- Bado huna huduma ya pochi ya wakati halisi.
- Unapendelea maombi yanayotoka tu, bila callback ya umma ya kulinda.
- Vipindi vifupi vya salio lililokwama vinakubalika na unaweza kuendesha kazi ya kufagia.
Waendeshaji wengi huanza na transfer wallet ili kuanza kazi, kisha huhamia single wallet huduma yao ya pochi ikiwa tayari. Tuulize jinsi mabadiliko yanavyopangwa.
Orodha ya ukaguzi wa muunganisho
- Index ya kipekee kwenye txId na handlers za idempotent kwa kila ombi linalohamisha pesa
- Ukaguzi wa sahihi ya HMAC, uvumilivu wa timestamp na orodha ya IP zinazoruhusiwa
- Kiasi salama cha desimali na uhakiki wa sarafu
- Majaribio ya muda kuisha, kujaribu tena na rollback kwenye sandbox, ikiwemo jaribio lililochelewa
- Kazi ya kila siku ya upatanisho kwa roundId (single) au txId (transfer)
- Ufuatiliaji na tahadhari: muda wa callback, kiwango cha hitilafu, uhamisho unaosubiri, salio lililokwama
Ongea na mhandisi wa muunganisho
Tunaweza kuwaongoza wahandisi wako kwenye sandbox na kukusaidia kuchagua mfumo unaofaa jukwaa lako. Muunganisho umehakikishwa chini ya siku saba.
Tuma barua pepe kwa mauzo Ongea nasi kwenye Telegram Rudi kwa Product API
sales@ssggaming.com