Kriptovalyutalar
Torrent Gear
Ödəniş sistemlərinin inteqrasiyası necə işləyir
Ödənişlər onlayn kazinonun «aortasıdır». Ödəniş provayderləri (PSP) ilə inteqrasiyanın necə qurulduğundan ilk depozitə çevrilmə, geri çəkilmə sürəti, çarcbeklərin payı, sapport yükü və hətta tənzimləyicinin nüfuzu asılıdır. Aşağıda - praktik xəritə: hansı komponentlərə ehtiyac var, sorğu necə axır, harada müdafiə qoymaq və nə saymaq lazımdır.
1) Ödəmə konturunun arxitekturası
Əsas bloklar:- Kassa (Checkout UI): metod/valyuta/məbləğ seçimi, 3DS/SCA, statuslar, səhvlər.
- Ödəniş şlüzü (Gateway): qaydalara uyğun olaraq PSP-yə marşrut (ölkə, valyuta, risk, dəyər).
- Cüzdan (PAM/Wallet): balans uçotu, RG limitləri, 'debit/credit' əməliyyatları.
- Antifrod/AML: avtorizasiyadan əvvəl və sonra skoring əməliyyatı.
- Webhucks (Callbacks): son statusları təsdiqləyir.
- Billing/Twill (Reconciliation): PSP və cüzdandakı pulların gündəlik uyğunluğu.
- Tokenlərin saxlanması: «xam» PAN olmadan PSP tokenizasiyası vasitəsilə kartlar/cüzdanlar.
- Ölkələr/banklar/valyutalar/limitlər qaydaları, A/B xətləri, deqradasiya zamanı avtomatik faylover.
2) «depozit» və «çıxış» axınları (sxemlər)
Depozit (kart/cüzdan/bankçılıq):1. 'POST/payments/init' → niyyət yaratmaq (amount, currency, method).
2. Redirect/SDK → 3DS/SCA/biometrik.
3. PSP ilkin statusu qaytarır (authorized/pending/failed).
4. Webhook PSP → son status (captured/failed).
5. Final üzrə 'wallet/credit' + RG/tarix limitlərinin yazılması.
Nəticə:1. 'POST/payouts/init' → Veycer/limit/risk yoxlaması.
2. PSP-də payout təşəbbüsü (ideal olaraq - depozit ilə eyni marşrut).
3. Webhook PSP → success/failed.
4. Success zamanı 'wallet/debit', uğursuzluq səbəbləri jurnalı, oyunçu bildirişi.
3) İdempotentlik və pul bağlılığı
Hər çağırış 'Idempotency-Key' və unikal 'txn _ id' ilə.
Depozitlər/nəticələr yalnız bir dəfə balansı dəyişir - son webhook.
Sorğunun hər hansı bir təkrarı eyni 'txn _ id' və statusu qaytarır.
Oyunlarla birlikdə: 'round _ id' 'debit _ txn _ id '/' credit _ txn _ id'.
4) Təhlükəsizlik və uyğunluq
TLS 1. 2+/1. 3, HSTS; HMAC imzası və anti-replay ('timestamp', nonce) ilə webhooks.
PSP-də kartların tokenizasiyası; PCI DSS scope azaldılması (hosted fields/pages).
Kart SCA/3DS2, Pay-by-Bank üçün PSD2/Open Banking.
GDPR: PII minimuma endirilməsi, retensiya, DSR prosesləri; profil giriş jurnalı.
mTLS/IP allow-list PSP bağlantıları üçün, ödəmə dövrəsinin bölünməsi.
5) Antifrod və AML (ödənişdən əvvəl və sonra)
Pre-auth qaydaları: geo/ASN, cihaz, velocity, davranış, «pass-through».
ML-skor/qraf: ümumi kartlar/cüzdan/cihazlar, təkrar chargeback.
Post-auth monitorinq: ləğv, geri qaytarılması, sürətli çıxış.
AML ssenariləri: astanalar, structuring, qeyri-adi marşrutlar, STR/SAR hesabatları.
Step-up KYC: çıxarılmadan əvvəl orta/yüksək risk ilə.
6) Vebhuki: etibarlı çatdırılma
HMAC imzası, 'timestamp' yoxlaması və 'event _ id' deduplikasiyası.
PSP tərəfindəki retrajlar idempotentdir.
Çatdırılma qeydləri (success/fail), dead-letter queue və əl «replay».
Webhook məbləğ/identifikatorları üst-üstə düşmürsə, balansı dəyişmir.
7) Səhvlər və vaxtlar: cavab dizaynı
Kodlar: '402' (payment required), '409' (idempotent münaqişəsi), '422' (validasiya), '429' (rate-limit), '5xx' (insident).
Xəta cisimləri: 'error', 'message', 'trace _ id', 'details {...}' - sapport və alertlərə kömək edir.
Graceful retry müştəridə (eksponensial backoff), UI-də aydın ipuçları.
8) Routing və bir neçə PSP faylover
Keyfiyyət qaydaları: p95 avtorizasiyalar, dönüşüm, 3DS faylların payı, dəyəri.
Smart router: metrik pisləşdikdə - trafikin alternativə keçirilməsi.
Sticky-seans marşrutu/3DS sabitlik üçün bank.
Deqradasiya planı: sürətli (P2P/Pay-by-Bank) buraxaraq «ağır» metodları söndürmək, nəticə növbəsi.
9) Yığma və maliyyə (Reconciliation)
Gündəlik PSP boşaltma və cüzdan ilə avtosverk: məbləğlərin, komissiyaların, geri qaytarmaların üst-üstə düşməsi.
Uyğunsuzluqlar → istintaq halları.
chargeback/refund/fees üzrə ayrı-ayrı hesabatlar, metodlara görə həqiqi marjanın hesablanması.
10) Fokusda saxlanılması lazım olan metriklər
Əmanətin metod/bank/ölkə/cihaz üzrə konvertasiyası.
Depozit/çıxarış vaxtı (p50/p95).
3DS faylları, ləğv, geri qaytarmalar, chargeback rate.
Əl revyu və TTV KYC payı.
Uptime PSP və marşrutlar üzrə öz error-rate.
Cost per success və ROI metodları ilə.
11) Minimum API nümunəsi (qısaca)
Depozit niyyəti yarat- `POST /v1/payments/init`
json
{
"amount":"50. 00", "currency":"EUR", "method":"card", "return_url":"https://app. example. com/checkout/return", "idempotency_key":"b6a1-…", "meta":{"country":"FI","device":"ios"}
}Cavab
json
{"payment_id":"pay_123","status":"pending","redirect_url":"https://psp. example/3ds/…"}- `POST /v1/payments/webhook` + `X-Signature: sha256=…`
json
{
"event_id":"evt_789", "payment_id":"pay_123", "status":"captured", "amount":"50. 00", "currency":"EUR", "timestamp":"2025-10-17T09:41:00Z"
}- `POST /v1/wallet/credit`
json
{"payment_id":"pay_123","txn_id":"txn_555","amount":"50. 00","idempotency_key":"b6a1-…"}12) Mövcud və UX kassa
Minimum addımlar: auto-detect ölkə/valyuta, saxlanan token metodları.
Lokal üsullar: bank düymələri, e-wallets, Apple/Google Pay.
Şəffaflıq: komissiya/ETA çıxış, əməliyyat statusu, başa düşülən səhvlər.
Əlçatanlıq: böyük elementlər, kontrast, screen readers, çoxdilli.
13) DR/BCP və əməliyyat təhlükəsizliyi
Ödəniş jurnallarının replikasiyası, şifrələnmiş arxalar, rüblük DR təlimləri.
RPO/RTO sənədləşdirilmiş, PSP uğursuz olduqda «təxirə salınmış» ödənişlər.
WAF/bot-menecment kassada, lakin redaktorlar üçün istisnalar/SDK PSP.
14) Tez-tez səhvlər
Balans webhook → dubly/rassinxron finalına qədər dəyişir.
No 'Idempotency-Key' → şəbəkə uğursuzluqları zamanı ikinci əməliyyat yaradır.
Zəif imza yoxlama webhook → status dəyişikliyi.
PSP → «səssiz uyğunsuzluqlar» ilə avtosverkin yoxdur.
Bir PSP «hər şey üçün» → deqradasiya zamanı fasilələr və dönüşüm itkiləri.
3DS/ünvan sahələrinin «göstər» üçün təsdiqlənməsi → Çarjbeklərin böyüməsi.
15) Giriş yoxlama siyahısı (saxla)
- Multi-PSP router, keyfiyyət qaydaları, faylover
- Hər təbəqədə idempotency ('txn _ id', 'Idempotency-Key')
- Webhooks: HMAC, anti-replay, çatdırılma qeydləri, deduplication
- Tokenization/hosted fields, PCI DSS scope azaldılması
- 3DS2/SCA, PSD2/Open Banking harada mövcuddur
- Antifrod/AML əvvəl və sonra ödəniş, step-up KYC
- PSP hesabatlarının avtomatik yoxlanması, uyğunsuzluqların təhlili
- Müşahidə: p95 depozit/çıxış, 3DS fail-rate, uptime PSP
- DR planı, gecikmiş ödənişlər, arxa jurnallar
- UX kassaları: yerli üsullar, şəffaf ETA/komissiyalar, mövcudluq
Yaxşı ödəniş inteqrasiyası «SDK-nı bağlamaq» deyil, sabit konturlar qurmaqdır: multi-PSP marşrutlaşdırma, ciddi idempotentlik, imzalanmış webhooks, antifrod/AML, avtosalon və müşahidə. Belə bir yığın dönüşü artırır, nəticəni sürətləndirir, çarjbeklərin risklərini azaldır və platformanı oyunçular, tərəfdaşlar və tənzimləyicilər üçün proqnozlaşdırıla bilən edir.