बैकेंड स्तर पर पदोन्नति और बोनस का प्रबंधन

पूरा लेख

💡 18+. प्लेटफार्मों/ऑपरेटरों और प्रदाताओं के लिए इंजीनियरिंग और व्या खेलने के लिए कॉल नहीं। "वॉलेट" द्वारा हम ACID गारंटी के साथ लेजर/वॉलेट का मतलब है, "बोनस" द्वारा - प्रमोटर जो खेल के संतुलन और शर्तों को प्रभावित करते हैं।

1) प्रोमो को एक अलग बैकएंड में क्यों ले जाएं

मौद्रिक अपरिवर्तनीय। बोनस ≠ "जोड़ासंतुलन": यह शर्तों के साथ एक अनुबंध है (वेगर, गेम में योगदान, अधिकतम शर्त/जीत)।

परिवर्तन की दर। मार्केटिंग टीमें प्रतिदिन अभियान जारी करती हैं - आपको एक घोषणात्मक नियम इंजन और रोलबैक

विरोधी दुरुपयोग/अनुपालन। KYC/RG/AML, वेग, विभाजन, महंगे ऑफर के लिए चार-आंख के कार्य।

अवलोकन और रिपोर्टिंग। एसएलओ, प्रोमो लागत, जीजीआर/एनजीआर/एलटीवी पर प्रभाव।

सिद्धांत: प्रोमो कोर अपनी स्वयं की स्थिति मशीनों के साथ एक अलग सेवा है, और पैसा केवल बटुए के माध्यम से, पहचान से चलता है।

2) बोनस टाइपोलॉजी और अपरिवर्तनीय

जमा मैच (एक्स से पहले 100%): कैप्चर डिपॉजिट, वेगर एक्स × के बाद अर्जित।

कैशबैक: टाइम विंडो/गेम द्वारा गणना की गई, चिपचिपा/गैर-चिपचिपा हो सकता है।

नि: शुल्क स्पिन/मुफ्त दांव: कूपन/टोकन प्रति स्पिन/शर्त के साथ, निश्चित आरटीपी पूल।

Quests/मिशन: कार्य प्रगति - इनाम।

टूर्नामेंट/उड़ान की घटनाएं: घटनाओं, रेटिंग, पुरस्कार राशि का योगदान।

अपरिवर्तनीय:

स्टिकी: जब तक शर्तें पूरी नहीं हो जाती तब तक आउटपुट नहीं किया जा सक
मैक्स शर्त/मैक्स जीत: बोनस फंड से शर्त/भुगतान पर सीमा।
योगदान: खेल द्वारा योगदान (जैसे) स्लॉट = 100%, लाइव = 10%)।
समाप्ति: बोनस वैधता अवधि और वेगर विंडो।

3) बोनस सेवा वास्तुकला


व्यवस्थापक ─Promo ─Rules इंजन API/पात्रता
│
├─Bonus लेजर (ऑफ़र की स्थिति)
├─Wagering इंजन (प्रगति)
├─Anti -अब्यूज़ (सीमा/धोखाधड़ी/वेग)
 (घटनाएं)   

Wallet/Ledger── आइडेम्पोटेंट कमांड्स ───┘

नियम इंजन - घोषणात्मक शर्तें (खंड, भू/लाइसेंस, चैनल, केवाईसी/आरजी)।

वैगरिंग इंजन - 'बेट। सेटेड '/' वॉलेट से योगदान गिनता है। नामे	क्रेडिट '।
बोनस लेजर बोनस/मिशन राज्यों पर सत्य का एक स्रोत है।
आउटबॉक्स/सीडीसी - विश्वसनीय प्रकाशन 'बोनस। जारी किया गया	प्रगति। अद्यतन

4) डेटा मॉडल (सरलीकृत)

'bonus _ grant'

'grant _ id, player_id, offer_id, प्रकार, मुद्रा, amount_minor, चिपचिपा, wager_x, max_bet_minor, max_win_minor, contribution_schema_id,, स्थिति (जारी किया गया)	सक्रिय	रुक गया	पूर्ण	समाप्त हो	निरस्त), issued_at, expires_at, brand_id,, क्षेत्र, idempotency_key'

'दांव प्रगति'

'grant _ id, , , , ,

'कंट्रिब्यूशन _ स्कीमा'

' schema _ id, नियम: [{game _ type:" स्लॉट:", pct: 100}, {game _ type:" लाइव", pct: 10}]'

'bonus _ ledger _ entry' (ऑडिट)

'entry _ id, grant_id, कार्रवाई (अंक)	उपभोग करें	निरस्त	समाप्त हो	समायोजित करें), amount_minor, कारण, occurred_at, trace_id'

5) स्थिति मशीन और सागा

5. 1 अंक - सागा

1. पात्रता। जाँच (खंड, आरजी/केवाईसी, वेग)

2. अनुदान। बनाएं (स्थिति = 'जारी')

3. बटुआ। क्रेडिट [बोनस] (अज्ञात; चिपचिपा - बोनस उप-संतुलन के लिए)

4. सक्रिय करें (स्थिति = 'सक्रिय')

5. उत्सर्जन 'बोनस। जारी किया गया '

रोलबैक: जब चरण 3 'अनुदान पर गिरता है। '+ घटना' बोनस रद्द करें। निरस्त कर दिया '।

5. 2 वेगर प्रगति

Na 'bet। 'गणना योगदान =' स्टेक _ माइनर (या जीत/हानि नियमों के अनुसार)।

परमाणु रूप से 'वेगर _ प्रगति' अद्यतन करें; जब 100% तक पहुंच जाता है - 'पूर्ण'।

5. 3 खत्म (उपभोग)

पूरा → 'बटुआ। convert_bonus_to_cash' (यदि गैर-चिपचिपा है) या आउटपुट प्रतिबंधों को हटा दें।

उत्सर्जन 'बोनस। भस्म हो गया '।

5. 4 समाप्ति/याद

'expires _ at' या धोखाधड़ी नियम → 'revoke' (idempotent) द्वारा, नीति के अनुसार मुआवजा संभव है।

6) पर्स अनुबंध (केवल एपीआई के माध्यम से, हमेशा पहचानने वाला)

अर्क बोनस


POST/v1/बटुआ/क्रेडिट
हेडर: X-Idempotency-Key: bonus_grant_123
{
"" राशि ": {" माइनर _ यूनिट्स ": 100000," मुद्रा ":" ईयूआर "}," "संदर्भ": {"ग्रांट _ आईडी": "जीआर _ 123", "ऑफ़र _ आईडी": "ऑफ़र _ 777"
}
→ 200 {"स्थिति ": "क्रेडिट "," एंट्री _ आईडी":" ई _ 9001"}

जब शर्तें पूरी हों तो कैश में बदलें


POST/v1/बटुआ/परिवर्तित करें
हेडर: X-Idempotency-Key: bonus_convert_gr_123
{
"" " " " " ", "संदर्भ ": {"ग्रांट _ आईडी":" जीआर _ 123"}
}
→ 200 {"स्थिति ": "परिवर्तित "," एंट्री _ आईडी":" ई _ 9010"}

आरजीएस/वॉलेट गार्ड पक्ष पर अधिकतम शर्त/अधिकतम जीत की जाँच करें:

अनुरोध 'दांव। अधिकृत 'कोड' BONUS _ MAX _ BET _ EXCEEDED 'द्वारा अस्वीकार कर दिया जाता है।

7) प्रोमो सेवा का एपीआई (टेम्प्लेट)

प्रस्ताव बनाएँ (व्यवस्थापक)


POST/v1/ऑफ़र
{
"नाम": "आपका स्वागत है 100% ", "प्रकार": "जमा _ मैच", "परम": {"मैच _ pct": 100, "कैप _ माइनर": 10000, "दांव _ x": 20, "चिपचिपा": "सही", "पात्रता": "ब्रांड्स"], "खंड": "नया _ जमाकर्ता"}, "अनुसूची": {"शुरू": "2025-10-20T00: 00:00 जेड", "अंत": "2025-11-30T23: 59: 59Z"}
}
→ 201 {"ऑफर _ आईडी ":" ऑफ _ 777"}

बोनस जारी करें (रनटाइम)


POST/v1/बोनस/अनुदान
हेडर: X-Idempotency-Key: grant_p001_of777
{
"" player_id":"p_001,""offer_id":"of_777,""trigger":"deposit_captured,""amount_minor":10000
}
→ 200 {"ग्रांट _ आईडी ": "जीआर _ 123"," स्थिति":" सक्रिय"}

दांव प्रगति (पढ़ें)


GET/ v1/bonus/grants/gr_123/progress
→ 200 {"आवश्यक _ माइनर ": 200000, "योगदान _ माइनर": 45000," शेष _ माइनर": 155000," पीसीटी": 0। 225}

शून्य/रेवोक


POST/ v1/bonus/grants/gr_123/revoke
हेडर: X-Idempotency-Key: revoke_gr_123
{"कारण ": "धोखाधड़ी _ वेग"}
→ 200 {"स्थिति ":" निरस्त"}

सभी राइट कॉल 'X-Idempotency-Key' और 'X-Trace-Id' के साथ हैं।

8) दुरुपयोग और अनुपालन

वेग सीमा: मुद्दे/रूपांतरण/जमा प्रयास (रेडिस काउंटर + टीटीएल + लुआ)।

ट्रिगर डेडअप: एक जमा - नियम द्वारा एक अनुदान।

विभाजन और आरजी: स्व-बहिष्कृत/सीमा को बाहर करना; प्रति ब्रांड/क्षेत्र लाइसेंस।

ऑफ़ र के संघर्ष का ब्लॉक: केवल एक स्वागत बोनस एक समय में सक्रिय है; प्राथमिकताएं।

विसंगति डिटेक्टर: कई खाते/उपकरण/एएसएन, वेगर के तेजी से "शून्य"।

बड़े अनुदान और मैनुअल समायोजन पर "चार आँखें"।

सभी नियम/अनुदान/रूपांतरण परिवर्तनों का WORM लेखा परीक्षा।

9) अवलोकन, मैट्रिक्स और एसएलओ

एसएलओ (स्थल):

'अनुदान। अंक p95 '(issue→credited) ≤ 300-500 мс।
'दांव _ प्रगति p95' ≤ 200 ms से अपडेट करें। बेट। सेटलमेंट '।
घटनाओं का बोनस। 'p95 बस में ≤ जो हुआ उससे 2 मिनट।
"खोया/डुप्लिकेटेड अनुदान/रूपांतरण" = 0।

मेट्रिक्स:

दर/विलंबता по 'मुद्दा/परिवर्तित/निरस्त', त्रुटि-दर (व्यवसाय/4xx/5xx), 'IDEMPOTENCY _ MISMATCH'।
वागर रूपांतरण, औसत 'टाइम-टू-कम्प्लीट', अनुपात अतिदेय।
प्रोमो लागत: cohorts पर 'promo _ cost' (मामूली) और 'promo _ roi'।
एंटी-एब्यूज: अधिकतम शर्त/जीत द्वारा खारिज किए गए वेग ट्रिगर।

ट्रैकिंग: चेन 'ट्रिगर ग्रांट वॉलेट पर ओपनटेलीमेट्री। ऋण - प्रगति। अद्यतन → परिवर्तित करें '।

10) आरजीएस/गेम के साथ एकीकरण

फ्री स्पिन/फ्री बेट्स कूपन - 'एंटिटलमेंट्स' एपीआई के माध्यम से: टोकन जारी करना, रनटाइम में स्क्रैपिंग, उपयोग द्वारा टेलीमेट्री।

मैक्स शर्त/जीत - 'दांव में नियम। 'и' दांव को अधिकृत करें। समझौता करें '; वापसी कोड 'BONUS _ RULE _ VIOLATION'।

अंशदान - शर्त स्तर पर योजना। '(' game _ type/provider _ id 'द्वारा), स्कीमा संस्करण.

11) DWH/BI और रिपोर्ट

आउटबॉक्स इवेंट्स → लेक (कांस्य) → सिल्वर (डेडअप, SCD2) → गोल्ड शोकेस:

'fact _ bonus _ grants', 'fact _ wager _ progress', 'fact _ bonus _ cost', 'fact _ promo _ roi'।
एसएलए ताजगी: सिल्वर ≤ 15 मिनट, गोल्ड ≤ 30-60 मिनट।
पैनल: ऑफ़ र/सेगमेंट द्वारा रूपांतरण, समय-से-पूर्ण, खेल द्वारा योगदान, दुरुपयोग की घटनाएं।

12) सुरक्षा और निवास

mTLS + OAuth2 CC; scope'ы 'प्रोमो: इश्यू', 'प्रोमो: कन्वर्ट', 'प्रोमो: रिवोक'।

कुंजी/टोकन - प्रति ब्रांड/क्षेत्र, अल्पकालिक; तिजोरी/एचएसएम में रहस्य।

PII अलगाव: 'player _ id' - उर्फ; RLS по 'ब्रांड/क्षेत्र'।

दर सीमा और जारी करने का कोटा; रेट्रे तूफानों से सुरक्षा।

13) चेकलिस्ट

प्लेटफ़ॉर्म/ऑपरेटर

सभी मौद्रिक लेनदेन 'आइडेम्पोटेंसी-की' के साथ वॉलेट के माध्यम से जाते हैं।
नियम/पात्रता सत्यापित हैं; पलायन पर घटनाओं का "डबल अक्षर"।
अंशदान योजनाएं केंद्रीकृत हैं, परीक्षणों से आच्छादित हैं।
वेग और विरोधी धोखाधड़ी सक्षम; बड़ी रकम पर "चार आँखें"।
आउटबॉक्स/सीडीसी, डीएलक्यू और 'बोनस' के लिए प्रबंधित रीप्ले। '.
SLO डैशबोर्ड, OpenTelemetry, WORM ऑडिट।
ROI और अनुपालन (RG/AML) के लिए DWH स्टोरफ्रंट।

एकीकरण (RGS/बटुआ/CRM)

अधिकतम शर्त/जीत की जाँच; व्यापार त्रुटि कोड वापस।
मैं 'ट्रेस _ आईडी' और 'idempotency _ key' फेंकता हूं।
डेडअप ट्रिगर और डिलीवरी गारंटी (वेबहुक हस्ताक्षरित)।

14) लाल झंडे (विरोधी पैटर्न)

बोनस को "मैन्युअल रूप से" सीधे बैलेंस में चार्ज करना, वॉलेट को दरकिनार करना।

पहचान की कमी - दोहरे अनुदान/रूपांतरण।

दांव को 'बेट' द्वारा माना जाता है, न कि 'बेट' के परिणामों के अनुसार।
कोई योगदान योजना नहीं है या वे प्रदाताओं की संहिता में "संरक्षित" हैं।
परस्पर विरोधी प्रस्ताव एक साथ सक्रिय होते हैं।
कोई वेग/विरोधी धोखाधड़ी और WORM ऑडिट नहीं है।
'बोनस। 'इवेंट्स को आउटबॉक्स/सीडीसी को दरकिनार करते हुए पोस्ट किया जाता है।
प्रोमो मेट्रिक्स लेजर/बीआई (कोई आरओआई शोकेस) तक नहीं जोड़ ते हैं।

15) नीचे की रेखा

विश्वसनीय बैकेंड प्रोमो अनुबंध और अपरिवर्तनीय हैं, न कि "संतुलन जोड़ें। "यह पैसे से नियमों को अलग करता है, वास्तविक परिणामों के अनुसार प्रगति पर विचार करता है, निष्क्रियता और अवलोकन की गारंटी देता है, दुरुपयोग से बचाता है और अनुपालन सुनिश्चित कर इस तरह के कोर के साथ, विपणन जल्दी से चलता है, खिलाड़ी ईमानदार परिस्थितियों को देखता है, और वित्त और नियामकों को प्रत्येक प्रस्ताव की लागत और प्रभाव की सटीक तस्