Onlayn kazino platforması vasitəsilə ödəniş sistemlərinin qoşulması

Giriş

Ödəniş sistemlərinin inteqrasiyası istənilən onlayn kazino platformasının kritik hissəsidir. Oyunçuların inamı, qanunvericiliyə uyğunluğu və operatorun maliyyə sabitliyi əmanətlərin düzgün işləməsindən və vəsaitlərin çıxarılmasından asılıdır. Aşağıda ödəniş şlyuzlarının, aqreqatorların və elektron pul kisələri xidmətlərinin bağlanması və istismarının bütün əsas aspektləri göstərilmişdir.

1. Ödəniş provayderlərinin növlərinə baxış

1. Bank şlüzləri (Acquirers): ISO 8583 və ya REST API vasitəsilə Visa/Mastercard ekvayrinqinə birbaşa qoşulma.
2. Aqreqatorlar (PSP): bir çox ödəniş metodlarına (kartlar, e-wallet, mobil ödənişlər) bir API interfeysi.
3. Kriptovalyuta şlyuzları: BTC, ETH və stablokoinlərin qəbulu və konvertasiyası, WebSocket və REST vasitəsilə inteqrasiya.
4. SMS/USSD ödənişləri və mobil ticarət operatorları: SMPP protokolundan və ya API operatorundan istifadə.

2. Provayder seçimi meyarları

Yurisdiksiya və lisenziyalaşdırma: hədəf ölkələrdə hemblinq əməliyyatları üçün icazənin olması.
Komissiya modeli: sabit tariflər, əməliyyatın faizi, aylıq ödənişlər.
Etibarlılıq və SLA: uptime ≥ 99,9%, avtorizasiyanın maksimum gecikməsi ≤ 2 s.
Dəstəklənən metodlar: kartlar, yerli üsullar, e-wallet, P2P ödənişləri.
Analitik və hesabat vasitələri: chargeback, ROI, RFM-analizi üzrə hazır hesabatlar.

3. İnteqrasiyanın memarlıq sxemi

```mermaid
flowchart LR

Client [Oyunçu (brauzer/mobil proqram)] -->	Depozit sorğusu	Frontend
Frontend -->	POST /api/payments/init	Backend
Backend -->	REST API	PaymentGateway [Ödəniş qapısı/PSP]
PaymentGateway -->	Redirect / 3DS	Client
PaymentGateway -->	Webhook / Callback	Backend
Backend -->	Əməliyyat qeydləri	TransactionService [(Əməliyyat DB)]
TransactionService -->	Təsdiq	Frontend
TransactionService -->	Hesabatlar	BISystem
```

4. İnteqrasiya mərhələləri

1. Hazırlıq və koordinasiya

Provayderlə müqavilənin bağlanması və test və prodakşn-mühasibat məlumatlarının alınması (API-açarlar, sertifikatlar).
API spesifikasiyasının öyrənilməsi: ödənişin başlanması, statusun yoxlanılması, ləğv edilməsi, geri qaytarılması üçün son nöqtələr.

2. Test mühitinin konfiqurasiyası

Platformanın konfiqurasiya fayllarında Sandbox modunun konfiqurasiyası.
Test kartlarının, e-wallet hesablarının yaradılması və uğurlu/uğursuz əməliyyatların simulyasiyalarının aparılması.

3. API çağırışlarının həyata keçirilməsi və yoxlanılması

Ödənişin başlanğıcı: POST '/payments/init 'parametrləri ilə' {amount, currency, customerId, returnUrl} '.
Oyunçunun yönləndirilməsi: provayder səhifəsinə keçid (3-D Secure, mobil proqram).
Culback qəbuledici: vebhook status bildirişlərini ('approved', 'declined', 'pending') emal etmək üçün end-point '/payments/callback '.

4. Ssenarilərin sınaqdan keçirilməsi

Uğurlu ödəniş, imtina, istifadəçi ləğv, chargeback, geri qaytarma.
Atipik hallar üçün testlər: timeout, səhv məlumatlar, təkrarlanan kolbeklər (idempotency).

5. Əməliyyat axınının təsviri

1. Oyunçu «Depozit» basın → Frontend məbləği və xüsusi identifikator toplayır.
2. Backend 'initiated' və unikal 'paymentId' statuslu ödəniş yazısını yaradır.
3. Backend təkrar hücumlardan qorunmaq üçün HMAC imzası və nonce daxil olmaqla sorğunu provayderə göndərir.
4. Oyunçu autentifikasiyadan keçir (3DS, SMS), provayder ödənişi təsdiqləyir və ya rədd edir.
5. Provayder son statuslu webhook göndərir '/payments/callback '.
6. Backend əməliyyat vəziyyətini DB-də yeniləyir ('approved', 'declined', 'refunded') və oyunçunun balansını düzəldir.
7. Frontend WebSocket və ya periodik polling vasitəsilə yeniləmə alır və nəticəni göstərir.

6. Təhlükəsizliyin təmin edilməsi

TLS 1. 3 bütün mübadilələrdə; sertifikatlar zəncirinin yoxlanılması.
HMAC-imza sorğular və provayder tərəfində onları yoxlamaq.
Nonce və zaman nişanı (timestamp) replay hücumların qarşısını almaq üçün.
Əməliyyatları təkrarlamadan sorğuların təhlükəsiz təkrar göndərilməsi üçün Idempotency-açarları.

7. Tənzimləmə tələblərinə uyğunluq

KYC/AML prosedurları: ilk çıxarılmadan əvvəl oyunçu şəxsiyyət yoxlamasından keçməlidir; API vasitəsilə ID provayderləri ilə inteqrasiya.
PSD2 və Strong Customer Authentication (SCA): AB-yə kart ödənişləri üçün iki faktorlu autentifikasiya tələb olunur.
Chargeback Management: Provayderlərin API metodları və hüquqi dəstək vasitəsilə avtomatik əks mühakimə sistemi.

8. Monitorinq və hesabat

Metrika (Prometheus/Grafana):

'initiated' → 'approved' əməliyyatlarının sayı;
p95-latency şlüzə API sorğuları;
səhv tezliyi 4xx/5xx.

Logi (ELK-yığın):

ətraflı izləmə sorğu/cavab, webhook payload;
anomaliyaların aşkarlanması (təkrar declined, şübhəli IP trafiki).
BI-hesabatlar: GGR gündəlik ixracı, geri qaytarmalar, chargeback ratio, ARPU.

9. Arızaların emalı və arıza müqaviməti

10. Yoxlama və rekonsilasiya

11. Yeni ödəniş metodlarının dəstəklənməsi

Nəticə