Töleg ulgamlarynyň integrasiýasy nähili işleýär

Tölegler onlaýn kazino "aorta". Töleg üpjün edijileri (PSP) bilen integrasiýanyň usulyna ilkinji goýuma öwrülmegi, yzyna almagyň tizligi, çarjbekleriň paýy, sapport ýükleri we hatda düzgünleşdirijiniň abraýy baglydyr. Aşakda - amaly kartoçka: haýsy komponentler gerek, haýyşyň akymy, goragy nirede goýmaly we näme sanamaly.

1) Töleg konturynyň arhitekturasy

Esasy bloklar:

Kassa (Checkout UI): usulyny/walýutasyny/mukdaryny, 3DS/SCA, statuslaryny, ýalňyşlyklaryny saýlamak.
Töleg şlýuzy (Gateway): PSP-e düzgünlere laýyklykda ugrukdyrmak (ýurt, walýuta, töwekgelçilik, baha).
Gapjyk (PAM/Wallet): balans hasaby, RG çäkleri, 'debit/credit' amallary.
Antifrod/AML: ygtyýarnamadan öň we soň amallaryň skoring.
Webhook (Callbacks): soňky statuslary tassyklaýar.
Billing/Jübü (Reconciliation): PSP-de we gapjykda puluň gündelik gabat gelmegi.
Bellikleri saklamak: "çig" PAN-syz, PSP tokenizasiýasy arkaly kartlar/gapjyklar.

Birnäçe PSP ugrukdyrmak:

Ýurtlar/banklar/walýutalar/çäkler boýunça düzgünler, A/B-liniýalar, pese gaçanda awtomatiki feýlower.

2) "goýumyň" we "çykaryşyň" akymlary (shemalary)

Depozit (kart/gapjyk/banking):

1. 'POST/payments/init' → niýeti döretmek (amount, currency, method).

2. Redirekt/SDK → 3DS/SCA/biometrika.

3. PSP deslapky statusyny (authorized/pending/failed) yzyna gaýtarýar.

4. Webhook PSP → final status (captured/failed).

5. Final boýunça 'wallet/credit' + RG/taryhyň çäklerini ýazmak.

Netije:

1. 'POST/payouts/init' → Wakjeri/çäkleri/töwekgelçiligi barlamak.

2. PSP-de töleg başlamak (iň gowusy - goýumdaky ýaly ugur).

3. Webhook PSP → success/failed.

4. Success-de 'wallet/debit', şowsuzlygyň sebäpleriniň sanawy, oýunçynyň habarnamasy.

3) Puluň idempotentligi we baglanyşygy

Her jaň 'Idempotency-Key' we özboluşly 'txn _ id' -dir.

Depozitler/netijeler balansy diňe bir gezek - jemleýji webhook boýunça üýtgedýär.

Soragyň islendik gaýtalanmagy şol bir 'txn _ id' we statusyny gaýtaryp berýär.

Oýunlar bilen bilelikde: 'round _ id' 'debit _ txn _ id '/' credit _ txn _ id'.

4) Howpsuzlyk we gabat gelmek

TLS 1. 2+/1. 3, HSTS; webhooks HMAC goly we anti-replay ('timestamp', nonce).

PSP kartlarynyň tokenizasiýasy; PCI DSS scope-reduksiýa (hosted fields/pages).

SCA/3DS2-by-Bank üçin PSD2/Open Banking.

GDPR: PII-iň minimallaşdyrylmagy, retensiýa, DSR prosesleri; Profillere giriş sanawy.

mTLS/IP allow-list PSP bilen baglanyşyk üçin töleg konturyny bölmek.

5) Antifrod we AML (tölegden öň we soň)

Pre-auth düzgünleri: geo/ASN, enjam, velocity, özüni alyp baryş, "pass-through".

ML-skoring/graf: umumy kartlar/gapjyklar/enjamlar, gaýtalanýan chargeback.

Post-auth gözegçilik: ýatyryşlar, yzyna gaýtaryşlar, çalt netije.

AML ssenarileri: bosagalar, gurluşlar, üýtgeşik ugurlar, STR/SAR hasabatlary.

Step-up KYC: çykarmazdan ozal ortaça/ýokary töwekgelçilikde.

6) Webhuklar: ygtybarly eltip bermek

HMAC goly, 'timestamp' -ni barlamak we 'event _ id' -ni köpeltmek.

PSP tarapyndaky retralar - idempotent.

Eltip bermek ýazgylary (success/fail), dead-letter queue we el bilen "replay".

Webhook, eger mukdar/kesgitleýjiler gabat gelmese, balansyny üýtgetmeýär.

7) Ýalňyşlyklar we wagtlar: jogaplaryň dizaýny

Kodlar: '402' (payment required), '409' (idempotent konflikti), '422' (tassyklama), '429' (rate-limit), '5xx' (waka).

Hatalaryň bedenleri: 'error', 'message', 'trace _ id', 'details {...}' - sapport we alertlere kömek edýär.

Graceful retry (eksponensial backoff), UI-de anyk maslahatlar.

8) Birnäçe PSP üçin marşrut we feýlower

Hil düzgünleri: p95 ygtyýarnamalar, konwersiýa, 3DS-feýlleriň paýy, bahasy.

Smart-router: metrikler ýaramazlaşanda - traffigi alternatiwa geçirmek.

Sticky-sessiýa/banka 3DS durnuklylygy üçin.

Pese gaçmak meýilnamasy: çalt (P2P/Pay-by-Bank) goýup, "agyr" usullary öçürmek, netijeleriň nobaty.

9) Bukja we maliýe (Reconciliation)

PSP-ni her gün düşürmek we gapjyk bilen awtoswerka: pullaryň, komissiýalaryň, yzyna gaýtarmalaryň gabat gelmegi.

Gabat gelmezlik → derňew üçin ýagdaýlar.

Çargeback/refund/fees boýunça aýry-aýry hasabatlar, usullar boýunça hakyky marjany hasaplamak.

10) Üns bermeli metrikler

Goýumyň usul/bank/ýurt/gurnama boýunça konwersiýasy.

Goýumyň/yzyna almagyň wagty (p50/p95).

3DS feýlleriniň paýy, ýatyrylmagy, yzyna gaýtarylmagy, chargeback rate.

El rebu we TTV KYC paýy.

Uptime PSP we marşrutlar boýunça öz error-rate.

Cost per success we ROI usullary boýunça.

11) Iň pes API mysaly (gysgaça)

Depozit niýetini döretmek

`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"}
}

Jogap

json
{"payment_id":"pay_123","status":"pending","redirect_url":"https://psp. example/3ds/…"}

Status 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"
}

Hasaba almak (platformanyň içinde)

`POST /v1/wallet/credit`

json
{"payment_id":"pay_123","txn_id":"txn_555","amount":"50. 00","idempotency_key":"b6a1-…"}

12) Kassanyň elýeterliligi we UX

Iň az ädim: auto-detect countries/valyutalar, usullaryň saklanylan bellikleri.

Lokal usullar: bank düwmeleri, e-wallets, Apple/Google Pay.

Aç-açanlyk: netije komissiýasy/ETA, amalyň ýagdaýy, düşnükli ýalňyşlyklar.

Elýeterlilik: uly elementler, kontrast, ekran readerleri, köp dillilik.

13) DR/BCP we amallaryň howpsuzlygy

Töleg magazinesurnallarynyň köpelmegi, şifrlemek bilen bellikler, çärýekleýin DR-maşklar.

RPO/RTO resminamalaşdyryldy, PSP şowsuzlygy ýüze çykan halatynda "yza süýşürilen" tölegler.

WAF/bot-menejment kassada, ýöne baş direktorlar/SDK PSP üçin kadadan çykmalar.

14) Ýygy-ýygydan ýalňyşlyklar

Balans webhook → dubly/rassinhron gutarýança üýtgeýär.

Ýok 'Idempotency-Key' → ulgam şowsuzlygynda gaýtalamak ikinji amaly döredýär.

Webhook → Status çalyşma goluny gowşak barlamak.

PSP → "sessiz gapma-garşylyklar".

Bir PSP "hemme zada" → durgunlyk we degradasiýa wagtynda öwrülişik ýitgileri.

3DS/salgy meýdanlaryny "görmek üçin" tassyklamak → çarjbekleriň ösüşi.

15) Giriş barlagy (saklaň)

Multi-PSP marşrutizatory, hil düzgünleri, feýlower
Her gatlakda idempotency ('txn _ id', 'Idempotency-Key')
Webhooks: HMAC, anti-replay, eltiş ýazgylary, de-duplikasiýa
Tokenization/hosted fields, PCI DSS skope-reduksiýa
3DS2/SCA, PSD2/Open Banking
Tölegden öň we soň antifrod/AML, step-up KYC
PSP hasabatlaryny awtomatiki barlamak, gapma-garşylyklary seljermek
Gözegçilik etmek: p95 depozit/yzyna almak, 3DS fil-rate, uptime PSP
DR-meýilnama, gijikdirilen tölegler, magazinesurnallaryň yzlary
UX kassalary: ýerli usullar, aç-açan ETA/komissiýalar, elýeterlilik

Gowy töleg integrasiýasy "SDK-ny birikdirmek" däl-de, durnukly kontury gurmakdyr: multi-PSP marşrutlaşdyrma, berk idempotentlik, webhooks, anti-frod/AML, awtoulag swerki we gözegçilik. Şeýle ystyk öwrülişigi ýokarlandyrýar, netijäni çaltlaşdyrýar, çarjbekleriň töwekgelçiligini peseldýär we platformany oýunçylar, hyzmatdaşlar we düzgünleşdirijiler üçin öňünden aýdyp boljak edýär.