To’lov tizimlarining integratsiyasi qanday
To’lovlar - bu onlayn kazino «aorta». To’lov provayderlari (PSP) bilan integratsiya birinchi depozitga konvertatsiya qilish, olib chiqish tezligi, charjbeklar ulushi, sapport yuklamasi va hatto regulyatorning obro’siga bog’liq. Quyida amaliy xarita: qanday komponentlar kerak, so’rov qanday oqadi, himoyani qayerga qo’yish va nima hisoblash kerak.
1) To’lov konturining arxitekturasi
Asosiy bloklar:- Kassa (Checkout UI): usulni/valyutani/summani tanlash, 3DS/SCA, maqomlar, xatolar.
- To’lov shlyuzi (Gateway): qoidalar bo’yicha PSPga yo’naltirish (mamlakat, valyuta, xavf, qiymat).
- Hamyon (PAM/Wallet): balans hisobi, RG limitlari,’debit/credit’tranzaksiyalari.
- Antifrod/AML: avtorizatsiyadan oldin va keyin skoring operatsiyalari.
- Vebxuklar (Callbacks): yakuniy maqomni tasdiqlaydi.
- Billing (Reconciliation): PSP va hamyondagi pullarning har kuni mos kelishi.
- Tokenlarni saqlash: «xom» PANsiz, PSP tokenlash orqali kartalar/hamyonlar.
- Mamlakatlar/banklar/valyutalar/limitlar bo’yicha qoidalar, A/B-liniyalar, degradatsiyada avtomatik faylover.
2) «depozit» va «chiqish» oqimlari (sxemalar)
Depozit (karta/hamyon/banking):1.’POST/payments/init’→ niyat yaratish (amount, currency, method).
2. Redirekt/SDK → 3DS/SCA/biometriya.
3. PSP dastlabki holatini qaytaradi (authorized/pending/failed).
4. Webhook PSP → yakuniy maqomi (captured/failed).
5. Final bo’yicha’wallet/credit’+ RG/tarix limitlari yozuvi.
Natija:1.’POST/payouts/init’→ veyjerni/limitlarni/tavakkalchilikni tekshirish.
2. PSPda payout tashabbusi (ideal holda - depozit bilan bir xil yo’nalish).
3. Webhook PSP → success/failed.
4.’wallet/debit’success’da, rad etilganda sabablar jurnali, o’yinchini xabardor qilish.
3) Pulning idempotentligi va bog’liqligi
Har bir chaqiruv’Idempotency-Key’va noyob’txn _ id’.
Depozitlar/xulosalar faqat bir marta - yakuniy webhook bo’yicha balansni o’zgartiradi.
Soʻrovning har qanday takrorlanishi bir xil’txn _ id’va holatni qaytaradi.
O’yinlar bilan birgalikda:’round _ id’, debit _ txn _ id ’/’ credit _ txn _ id’.
4) Xavfsizlik va komplayens
TLS 1. 2+/1. 3, HSTS; webhooks HMAC-imzosi va anti-replay (’timestamp’, nonce).
PSPda Tokenization kartalari; PCI DSS scope-reduksiya (hosted fields/pages).
Pay-by-Bank uchun SCA/3DS2 Banking kartalar uchun PSD2/Open.
GDPR: PIIni minimallashtirish, retensiya, DSR-jarayonlar; profillarga kirish jurnali.
mTLS/IP allow-list PSP ulanish uchun to’lov konturini ajratish.
5) Antifrod va AML (to’lovdan oldin va keyin)
Pre-auth qoidalari: geo/ASN, qurilma, velocity, xulq-atvor, «pass-through».
ML-skoring/grafa: umumiy kartalar/hamyonlar/qurilmalar, takroriy chargeback.
Post-auth monitoringi: bekor qilish, qaytarish, tezkor chiqish.
AML stsenariylari: ostonalar, structuring, g’ayrioddiy yo’nalishlar, STR/SAR hisobotlari.
Step-up KYC: chiqarishdan oldin o’rtacha/yuqori xavf.
6) Vebxuki: ishonchli yetkazib berish
HMAC imzosi,’timestamp’tekshiruvi va’event _ id’da’duplikatsiyasi.
PSP tomonidagi retralar idempotentdir.
Yetkazib berish daftarlari (success/fail), dead-letter queue va qo’lda «replay».
Agar summa/identifikatorlar mos kelmasa, Webhook balansni oʻzgartirmaydi.
7) Xatolar va taymautlar: javoblar dizayni
Kodlar:’402’(payment required),’409’(idempotent mojarosi),’422’(validatsiya),’429’(rate-limit),’5xx’(hodisa).
Xato jismlari:’error’,’message’,’trace _ id’,’details {...}’- sapport va alertlarga yordam beradi.
Graceful retry mijozda (eksponensial backoff), aniq maslahatlar UI.
8) Bir nechta PSP uchun routing va faylover
Sifat qoidalari: p95 avtorizatsiya, konvertatsiya, 3DS-fayllarning ulushi, qiymati.
Smart-router: metrika yomonlashganda - trafikni muqobilga o’tkazish.
3DS barqarorligi uchun sessiya/bank uchun Sticky-yo’nalish.
Tanazzul rejasi: «og’ir» usullarni o’chirish, tezkor (P2P/Pay-by-Bank), natijalar navbati.
9) Yig’ish va moliya (Reconciliation)
Har kuni PSPni tushirish va hamyon bilan avtosverka: summalar, komissiyalar, qaytarmalar mos keladi.
O’zaro kelishmovchiliklar → tergov uchun seyslar.
Chargeback/refund/fees bo’yicha alohida hisobotlar, usullar bo’yicha haqiqiy marjani hisoblash.
10) Diqqat markazida saqlanadigan metriklar
Depozitni metod/bank/mamlakat/qurilma bo’yicha konvertatsiya qilish.
Depozit/olib qo’yish vaqti (p50/p95).
3DS-fayllar, bekor qilish, qaytarish, chargeback rate ulushi.
Qo’lda ishlov berish va TTV KYC ulushi.
Uptime PSP va yo’nalishlar bo’yicha o’z error-rate.
Cost per success va ROI usullari bo’yicha.
11) Eng kam API misoli (qisqartirilgan)
Depozit niyatini yaratish- `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"}
}
Javob
json
{"payment_id":"pay_123","status":"pending","redirect_url":"https://psp. example/3ds/…"}
Maqom Webhook
- `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"
}
Qabul qilish (platforma ichida)
- `POST /v1/wallet/credit`
json
{"payment_id":"pay_123","txn_id":"txn_555","amount":"50. 00","idempotency_key":"b6a1-…"}
12) Kassaning mavjudligi va UX
Minimal qadamlar: auto-detect mamlakat/valyutalar, saqlangan usullar tokenlari.
Mahalliy usullar: bank tugmalari, e-wallets, Apple/Google Pay.
Shaffoflik: komissiya/ETA xulosasi, operatsiya maqomi, tushunarli xatolar.
Foydalanish imkoniyati: katta elementlar, kontrast, screen readers, koʻp tilli.
13) DR/BCP va operatsiya xavfsizligi
To’lov jurnallarini replikatsiya qilish, shifrlangan arxivlar, har chorakda DR-mashqlar.
RPO/RTO hujjatlashtirilgan, PSP muvaffaqiyatsiz tugaganida «kechiktirilgan» to’lovlar flousi.
WAF/bot-menejment kassada, lekin istisnolar/SDK PSP uchun.
14) Tez-tez xatolar
Balans webhook → dubli/rassinxron oxirigacha o’zgaradi.
’Idempotency-Key’ → tarmoq muvaffaqiyatsizliklarida takrorlash ikkinchi operatsiyani yaratadi.
Maqom almashtirilayotganda webhook imzosini tekshirib boʻlmadi.
PSP → «jim tafovutlar» bilan avtosverka mavjud emas.
Bitta PSP «hamma narsaga» → tanazzulga uchragan holatlar va konversiya yoʻqotishlari.
3DS/manzil maydonlarini tasdiqlash → charjbeklarning o’sishi.
15) Joriy etish cheki (saqlang)
- Multi-PSP router, sifat qoidalari, faylover
- Idempotency har bir qatlamda (’txn _ id’,’Idempotency-Key’)
- Webhooks: HMAC, anti-replay, yetkazib berish loglari, deduplikatsiya
- Tokenization/hosted fields, PCI DSS scope-reduksiya
- 3DS2/SCA, PSD2/Open Banking qaerda mavjud
- To’lovdan oldin va keyin antifrod/AML, step-up KYC
- PSP hisobotlarini avtomatik tekshirish, nomuvofiqliklarni tahlil qilish
- Kuzatish darajasi: p95 depozit/chiqish, 3DS fail-rate, uptime PSP
- DR-reja, kechiktirilgan to’lovlar, jurnallarning orqalari
- UX kassalari: lokal usullar, shaffof ETA/vositachilik haqi, foydalanish imkoniyati
Yaxshi to’lov integratsiyasi - bu «SDKni ulash» emas, balki barqaror kontur qurish: ko’p-PSP yo’nalishi, qat’iy idempotentlik, imzolangan webhooks, antifrod/AML, avtosvarka va kuzatish. Bunday stek konvertatsiyani oshiradi, hisobni tezlashtiradi, chorjbeklar xavfini kamaytiradi va platformani oʻyinchilar, sheriklar va regulyatorlar uchun oldindan aytib boʻladigan holga keltiradi.