SSG Gaming

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

KipengeleSingle walletTransfer wallet
Uhifadhi wa salioHifadhidata 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 dauKila 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 unaohitajikaEndpoints 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 uthabitiLeja 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 hitilafuMuda 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 muunganishoJuu 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 mchezajiSalio 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 kawaidaWaendeshaji 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

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. Uzinduzi: backend yako inaomba SSG URL ya mchezo pamoja na ID ya mchezaji na tokeni ya kipindi.
  2. Dau: kwa kila raundi SSG inaita debit kwa txId ya kipekee. Unakagua salio, unaandika safu ya leja na kurudisha salio jipya.
  3. Ushindi: SSG inaita credit kwa malipo ya ushindi (yanaweza kuwa sifuri) kwa raundi ileile.
  4. Hitilafu: ombi likichukua muda mrefu mno SSG inajaribu tena kwa txId ileile, na baada ya kikomo cha majaribio inatuma rollback.

Mbinu za callback (mfano)

MbinuMadhumuniSehemu muhimuIdempotent
balanceRudisha salio la sasa la mchezaji.playerId, currencyNdiyo (kusoma tu)
debitWeka dau: toa kiasi.playerId, txId, roundId, gameId, amount, currencyKwa txId
creditLipa ushindi: ongeza kiasi.playerId, txId, roundId, amount, currencyKwa txId
rollbackFuta debit au credit ya awali baada ya hitilafu.txId, refTxIdKwa 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_ERROR

Kanuni 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

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. Kuingiza: backend yako inaita transferIn kwa txId ya kipekee na kiasi. Matokeo ni PENDING au SUCCESS.
  2. Kucheza: zindua mchezo. Madau yote na ushindi hubadilisha salio la upande wa mtoa huduma bila callbacks kwako.
  3. Kutoa: mchezaji anapoondoka, ita transferOut kwa salio lote na uliweke tena kwenye leja yako ikiwa SUCCESS.
  4. Matokeo yasiyojulikana: ombi la uhamisho likichukua muda mrefu mno, uliza getTransferStatus kwa txId ileile kabla ya kufanya kitu kingine.

Mbinu za API (mfano)

MbinuMadhumuniSehemu muhimuIdempotent
transferInHamisha pesa kutoka pochi yako kwenda salio la mchezo la mchezaji.playerId, txId, amount, currencyKwa txId
transferOutHamisha pesa kutoka salio la mchezo kurudi kwenye pochi yako.playerId, txId, amount | allKwa txId
getBalanceSoma salio la mchezo la mchezaji.playerIdNdiyo (kusoma tu)
getTransferStatusRudisha PENDING, SUCCESS au FAILED kwa txId.txIdNdiyo (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

HaliSingle walletTransfer wallet
Muda wa mtandao kuishaWakati 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 chiniWachezaji hawawezi kuanza au kuendelea na raundi. Raundi zilizo wazi zinarudishwa nyuma.Wachezaji wanaendelea kucheza kwa salio lao la mchezo lililopo. Uhamisho mpya umezuiwa.
Ombi lililorudiwaRudisha jibu lililohifadhiwa kwa txId hiyo na usibadilishe chochote.Rudisha matokeo yaliyohifadhiwa kwa txId hiyo na usibadilishe chochote.
Mchezaji anakatika katikati ya raundiRaundi 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 kutolinganaKwa 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