Გადახდების ავტომატიზაცია და ლიმიტების კონტროლი

სტატიის სრული ტექსტი

💡 18+. საინჟინრო და გამოყენებითი მასალა პლატფორმებისა და iGaming ოპერატორებისთვის. არა თამაშის მოწოდება. „გადასახადების“ მიხედვით, ჩვენ გვესმის მოთამაშეთა ფულადი სახსრები ყველა არხზე: ბარათები/ბანკები/საფულეები/კრიპტო.

1) რატომ უნდა მოხდეს გადახდების ავტომატიზაცია

სიჩქარე და პროგნოზირება: მოთამაშეები ელოდება სწრაფ და გამჭვირვალე ქეშაუტებს.

რისკი და შესაბამისობა: RG/AML/სანქციები, velocity და ბრენდის/მოთამაშის/არხის ლიმიტები.

მასშტაბი: მწვერვალები ტურნირებისა და „ცხელი“ მაუწყებლების შემდეგ - ათობით ათასი განაცხადი.

ღირებულება: კომისიების და სახაზინო ნაშთების ოპტიმიზაცია PSP/ანგარიშებზე/ქსელებში.

მთავარი მიზანი არის ერთჯერადი, დამოწმებული და კონტროლირებადი გადახდა ნებისმიერი წარუმატებლობის შემთხვევაში.

2) payout ბირთვის როლური მოდელი

Payout Orchestrator - სტატუსის მანქანა და საგნები: იღებს განაცხადებს, ამოწმებს ლიმიტებსა და წესებს, ამოწმებს, ახერხებს, აფიქსირებს შედეგს.

Risk & Compliance - RG/AML/KYT, სკრინინგი, „ოთხი თვალი“.

Treasury - რეზერვები არხებით, ნარჩენების მართვა, ჰეჯირება.

Wallet/Ledger არის ბალანსის ჭეშმარიტების წყარო; დებიუტი/ანაზღაურება მხოლოდ მის მეშვეობით.

PSP/Bank/Castodi/Crypto პროცესორი საბოლოო შემსრულებელია.

3) საცნობარო flow გადახდა (სახელმწიფო მანქანა)

1. Request - განაცხადი წინა/CRM/API- სგან.

2. Precheck - RG/AML: თვითნებობა/ზარალის/დროის ლიმიტები, SLC ფურცლები/RER, KYT (კრიპტო/საფულეებისთვის), KYC სტატუსი.

3. limits - velocity და limites შემოწმება: per player/brand/region/method (ყოველდღიური/ყოველკვირეული/თვე).

4. deduct - idempotent 'wallet. debit` (или `hold`→`commit`) с `X-Idempotency-Key`.

5. არხის/მერჩანტის/ქსელის არჩევანი (წესები + ღირებულება + კონვერტაცია + წვდომა).

6. Subit - გაგზავნა PSP/bank/castody (mTLS + ხელმოწერები).

7. await _ stettlement - დადასტურების მოლოდინი ('stettled '/' failed') ვებჰუკის ან პულის შემოწმების საშუალებით.

8. Notify - მოვლენები ავტობუსში/BI, მოთამაშე - სტატუსი/ETA.

9. Reconcile - PSP/Bank/Bank- ის/Ledger- ის ანგარიშების შერწყმა.

10. კომპენსაცია „failed“ - დაბრუნება Ledger- ში (immpotent), არხის ხელახალი არჩევა, ესკალაცია.

ინვარიანტები:

ბალანსი იცვლება მხოლოდ ლედგერის მეშვეობით.
„დაკარგული/დუბლირებული გადასახადები“ = 0 - უზრუნველყოფილია იდემპოტენტურობით და ბაბუით.
ყველა გადასვლა - ატომური და ტრეკები ('trace _ id', 'payout _ id').

4) Limity and velocity: როგორ განვიხილოთ სწორად

4. 1 ლიმიტის ტიპები

მარეგულირებელი/RG: დღის/ყოველკვირეული დასკვნების ლიმიტები, თვითკმაყოფილება, გაცივება.

Frode/velocity: გარიგების თანხა/რაოდენობა, განაცხადების სიხშირე, დეტალების შეცვლა, მოწყობილობები/ASN/გეო.

სალარო: არხის/მერჩანტის/ანგარიშების/ქსელების ლიმიტები, ხაზინის ნაშთები.

ოპერაციული: „ხელის ხვრელის“ და „ოთხი თვალის“ ბარიერები (VIP/დიდი თანხები).

4. 2 საცავი და განხორციელება

განაწილებული მრიცხველები (Redis + TTL + Lua/atomic) 1h/24h/7d ფანჯრებზე.

პროგნოზები OLAP- ში მოწინავე წესებისთვის (მოცურების ფანჯრები, ნიმუშები).

მრიცხველების idempotence: ზრდა მხოლოდ „წყალქვეშა“ განაცხადში გადასვლისას.

Explainability: თითოეული წარუმატებლობისთვის - მიზეზის კოდი და „რა ზღვარი მუშაობდა“.

5) არხის ორკესტრი (PSP/ბანკები/კრიპტო)

5. 1 როუტინგი

წესები გეოს, ვალუტის, თანხის, სიჩქარის, ღირებულების, რისკის, ხელმისაწვდომობის, SLO ბანაკების შესახებ.

კასკადები: PSP1 და PSP2 უარის თქმის დროს; კრიპტო - ქსელი A - B.

A/B და bandit მიდგომა კონვერტაციისა და ფასების ოპტიმიზაციისთვის.

5. 2 არხის სპეციფიკური მახასიათებლები

ბარათები/ბანკები: სტატუსის აპარატები 'წყალგაუმტარი - კომპენსაცია - settled', გადახურვა/გამოტოვება სქემების მიხედვით (SEPA/SWIFT).

E-wallets: მყისიერი, მაგრამ მკაცრი ლიმიტები და სკრინინგი.

კრიპტო: საბოლოო დასკვნა (N დადასტურება), მისამართის KYT, Travel Rule VASP- ს შორის, მისამართების თეთრი სიები, MRS/მულტსიგი, გაზის მენეჯმენტი.

6) უსაფრთხოება და შესაბამისობა

mTLS + OAuth2/ხელმოწერები ყველა S2S- ზე, გასაღებები per brand/region, ნიშნები ხანმოკლე და მიბმული არხზე.

KUS/KUT/sank Skrining მდე „subit“; კრიპტოსთვის - მისამართის რისკი/tx.

RBAC/ABAC და „ოთხი თვალი“ ხელით მოქმედებებზე/ბარიერებზე.

WORM აუდიტი: უცვლელი ჟურნალები, რომლებიც შეცვლიან შეზღუდვებს/წესებს/რეიდებს და ხელის ჩარევას.

PII/რეზიდენტობა: მონაცემები და ლოგოები - რეგიონების მიხედვით, at-rest/in-transit დაშიფვრა, RLS.

7) იდემპოტენტობა და საგები (ფულადი გზები)

თითოეული ჩანაწერის ოპერაცია ახორციელებს 'X-Idempotency-Key'; განმეორება - იგივე შედეგი (200 ძველი სხეულით).

Сага `deduct→submit→settled`:

თუ 'summit' დაეცა, ანაზღაურება ('wallet. release/credit`).
თუ 'settled' არ მოვიდა - rettrai/prepress, 'payout _ id' დედაპლატი.
ნაშთების ხელახალი რედაქტირება მხოლოდ კომპენსაციის მოვლენებია.

8) API კონტრაქტები (საცნობარო ფრაგმენტები)

განაცხადის შექმნა


POST /v1/payouts
Headers: X-Idempotency-Key: po_001, X-Trace-Id: tr_a1b2
{
"player_id":"p_123",  "amount":{"amount":250. 00,"currency":"EUR"},  "method":"sepa",  "destination":{"iban":"DE89..."},  "metadata":{"brand_id":"A","region":"EU"}
}
→ 202 {"payout_id":"po_001","status":"REQUESTED","eta":"2025-10-23T18:00:00Z"}

ვებჰუკი PSP/bank- დან/კასტოდიდან


POST /webhooks/payouts
X-Signature: sha256=...
{
"event_id":"uuid",  "payout_id":"po_001",  "psp_ref":"psp_77",  "status":"SETTLED",  "occurred_at":"2025-10-23T16:21:05Z"
}

ოქროს ამოღება/ანაზღაურება


POST /v1/payouts/po_001/compensate
Headers: X-Idempotency-Key: po_001_comp
→ 200 {"status":"COMPENSATED"}

9) დაკვირვება და SLO

SLO (სახელმძღვანელო):

`payout. request - subbit 'p95-120-300 ms (შიდა გზა),' subit 'settled' p95: ბარათები/ewallet - 5-30 წუთი, SEPA-T + 0/T + 1 ბანკები, კრიპტო 10 წუთი (ქსელში), „დაკარგული/დუბლირებული გადახდები“ = 0.

მეტრიკა:

latency p50/p95/p99 ეტაპზე, error-rate (ბიზნესი/4xx/5xx), retry storms, queue/DLQ lag, success-rate არხებით, cost per success, PSP/ბანკების კოდებზე უარის უარი AML/velocity).
ტრეისი: OpenTelemetry (edge - limits - wallet - router - PSP), 'trace _ id' ვებჰუკებში.
ალერტები: breach SLO, სიმაღლე 'IDEMPOTENCY _ MISMATCH', ნახტომი 'ყალბი _ პლატფორმა ", სპეციფიკური გეო/არხში დაშლა.

10) ხაზინა და ნაშთები

რეზერვები არხებით/მერჩანტებით/ქსელებით, ავტომატური რებალანსით.

ბარიერების პოლიტიკოსები: მინიმუმი და მაქსიმუმი ანგარიშებზე/საფულეებში, „ახალი გადახდების ნაშთები“ დაფინანსების გარეშე.

ვალუტის/კრიპტო ჰეჯირება, კომისიების აღრიცხვა და გაცვლითი კურსის განსხვავებები.

ფინანსური ფანჯრები: გეგმა-ფაქტი, არხის გაყვანის ღირებულება, „შეჩერებული“ გადახდების აგება.

11) ჩანართი (კრიკეტი)

PSP/ბანკების/კასტოდების/ჯაჭვების ყოველდღიური მოხსენებები არის ნორმალიზება და შედარება payouts რეესტრთან და Ledger- ის ჩანაწერებთან.

Категории: `match`, `timing`, `missing_psp`, `missing_platform`, `amount_mismatch`.

ავტო წესები 'timing' - ისთვის, ticets 'mismatch' - ზე, ალერტული.

კრიპტოსთვის - შედარება „txid/network/confirmations“.

12) ქაოსის პრაქტიკა და DR

PSP/ბანკის დაცემა: ალტერნატივის კასკადი, არხისთვის 'pause new payouts' რეჟიმი.

ვებჰუკების შეფერხება: პერიოდული pull სტატუსები, dedup 'event _ id'.

რეგიონალური გარედან: აქტივი/აქტივი აქტივი (RPO - 5 წთ, RTO - 30 წთ).

გაზის ხერხემლები/რეორგები (კრიპტო): დინამიური ფე, დამატებითი დადასტურება, გადავადებული დაბალი პრიორიტეტული გადახდები.

13) ჩეკის ფურცლები

პლატფორმა/ოპერატორი

Idempotention 'wallet. debit/credit/compensate`, `X-Idempotency-Key` везде.
Velocity/RG/AML/KYT/sank skrining მდე „subbit“.
Routing და არხების კასკადები, გასაღებები/სერთიფიკატები per brand/region.
WORM აუდიტი ლიმიტების/წესების/სახელმძღვანელო მოქმედებების შესახებ, „ოთხი თვალი“ ზღურბლზე.
SLO დაშბორდები და ალერტები, OpenTelemetry, DLQ ვებჰუკებისთვის.
T + 1- ის ყოველდღიური შეკრება, mismatch ფანჯრები, ესკალაცია.
სახაზინო ბარიერები და მანქანის რებალანსი; გაჩერებული მოდა ('no new payouts').
DR/xaoc სავარჯიშოები: PSP/Bank/ქსელის ვარდნა, ვებჰუკების შეფერხება/დუბლები.

პროვაიდერი/PSP/ბანკი/კასტოდი

ხელმოწერილი ვებჰუკები (HMAC/EdDSA) + timestamp/nonce, ხელახლა მიწოდების გარანტია 2xx- მდე.
უარის თქმის მიზეზების ნორმალიზებული კოდები, T + 1 ანგარიშები, ფაილების მთლიანობა (hash/PGP).
სტატუსის API- ები ხელმისაწვდომია pull შემოწმებისთვის.

14) ანტი-ნიმუშები (წითელი დროშები)

დებიუტი/ბალანსის სესხი ვებ ჰუკზე, ლედგერში აშკარა გუნდის გარეშე.

იდემპოტენტურობის არარსებობა - ორმაგი ჩამოწერა/ანაზღაურება.

ზოგადი გასაღებები/სერთიფიკატები რამდენიმე ბრენდისთვის/რეგიონისთვის.

Velocity-limites განიხილება „განაცხადით“ და არა დადასტურებული გაგზავნით.

მონაცემთა ბაზაში გადახდის/ბალანსის სტატუსის ხელით რედაქტირება.

არ არსებობს DLQ/ბაბუა ვებჰუკებისთვის - „ჩაძირული“ სტატუსები.

T + 1 შეკრების არარსებობა; სახელმძღვანელო Excel ნახევარ განაკვეთზე.

კრიპტო დასკვნები KUT/თეთრი სიების/მრავალ ფაქტორის მტკიცებულების გარეშე.

15) შედეგი

გადახდების ავტომატიზაცია არის ფულისა და რისკების ორკესტრი: მკაცრი ლიმიტები და ველური, immpotent ფულადი ბრძანებები, არხის გონივრული როუტინგი, ნაგულისხმევი შესაბამისობა, დაკვირვება და ყოველდღიური შერიგება. ასეთი ორმაგი კონვეიერი იხდის სწრაფად და ერთხელ, მდგრადია წარუმატებლობებისა და მწვერვალების მიმართ, გამჭვირვალეა მოთამაშისთვის, მარეგულირებლისა და ფინანსური ანგარიშგებისთვის - და ამავე დროს აკონტროლებს ხაზინის ღირებულებას და რისკებს.