Төлөм системаларынын интеграциясы кандай иштейт

Төлөмдөр - бул "аорта" онлайн казино. Төлөм провайдерлери (PSP) менен интеграциянын түзүлүшү биринчи депозитке конверсияга, чыгарып кетүү ылдамдыгына, чаржбектердин үлүшүнө, саппорттун жүктөмүнө жана ал тургай жөнгө салуучу органдын аброюна жараша болот. Төмөндө - практикалык карта: кандай компоненттер керек, суроо-талап кандай агат, коргоону кайда коюу жана эмнени саноо керек.

1) Төлөм контурунун архитектурасы

Негизги блоктору:

Касса (Checkout UI): ыкманы/валютаны/сумманы, 3DS/SCA, статустарды, каталарды тандоо.
Төлөм шлюзу (Gateway): эрежелер боюнча PSPге багыттоо (өлкө, валюта, тобокелдик, нарк).
Капчык (PAM/Wallet): балансты эсепке алуу, RG лимиттери, 'debit/credit' бүтүмдөрү.
Antifrod/AML: уруксат алдында жана кийин эсептөө иш.
Webhook (Callbacks): акыркы статусун тастыктайт.
Billing/Twill (Reconciliation): PSP жана капчыктагы акча күнүмдүк дал келет.
Токендерди сактоо: PSP токенизациялоо аркылуу карталар/капчыктар, "чийки" PAN жок.

бир нече PSP багыттоо:

Өлкөлөр/банктар/валюталар/лимиттер боюнча эрежелер, A/B-линиялары, деградация учурунда автоматтык фейловер.

2) "Депозит" жана "чыгаруу" агымдары (схемалар)

Депозит (карта/капчык/банкинг):

1. 'POST/payments/init' → ниетин түзүү (amount, currency, method).

2. Redirect/SDK → 3DS/SCA/биометрия.

3. PSP алдын ала статусун кайтарып берет (authorized/pending/failed).

4. Webhook PSP → акыркы абалы (captured/failed).

5. Финал боюнча 'wallet/credit' + RG/тарых лимиттерин жазуу.

Жыйынтык:

1. 'POST/payouts/init' → вейджерди/лимиттерди/тобокелдикти текшерүү.

2. PSP (идеалдуу - депозиттик эле каттам) боюнча төлөм демилгелөө.

3. Webhook PSP → success/failed.

4. 'wallet/debit' success учурда, баш тартуу себептеринин журналы, оюнчу билдирүү.

3) Демпотенттик жана акча байланыштуулугу

Ар бир чакыруу менен 'Idempotency-Key' жана уникалдуу 'txn _ id'.

Депозиттер/корутундулар балансты бир гана жолу өзгөртөт - акыркы webhook боюнча.

Суроо-талаптын ар кандай кайталанышы ошол эле 'txn _ id' жана статусун кайтарып берет.

Оюндар менен бирге: 'round _ id' 'debit _ txn _ id '/' credit _ txn _ id'.

4) Коопсуздук жана комплаенс

TLS 1. 2+/1. 3, HSTS; webhooks HMAC кол тамгасы жана anti-replay ('timestamp', nonce).

PSP карта Tokenization; PCI DSS scope-кыскартуу (hosted fields/pages).

SCA/3DS2-by-Bank үчүн PSD2/Open Banking.

GDPR: PII минималдаштыруу, Retence, DSR-процесстер; профилдерге кирүү журналы.

mTLS/IP allow-list PSP менен байланыштар үчүн, төлөм контурунун сегрегациясы.

5) Антифрод жана AML (төлөөгө чейин жана андан кийин)

Pre-auth эрежелери: GEO/ASN, түзмөк, velocity, жүрүм-турум, "pass-through".

ML-эсеби/тилкеси: жалпы карталар/капчыктар/түзмөктөр, кайталап chargeback.

Post-auth мониторинг: жокко чыгаруу, кайтаруу, тез чыгаруу.

AML сценарийлери: босоголор, структуралоо, адаттан тыш каттамдар, STR/SAR отчеттору.

Step-up KYC: чыгаруу алдында орточо/жогорку тобокелдик менен.

6) Webhuke: ишенимдүү жеткирүү

HMAC кол, 'timestamp' текшерүү жана 'event _ id' боюнча дедупликация.

PSP тарапта Retray - idempotent.

жеткирүү Логи (success/fail), dead-letter queue жана кол менен "replay".

Webhook суммасы/идентификаторлору дал келбесе, балансты өзгөртпөйт.

7) Каталар жана таймауттар: жооптордун дизайны

Коддору: '402' (payment required), '409' (демпотенттик чыр-чатак), '422' (валидация), '429' (rate-limit), '5xx' (окуя).

Ката органдары: 'error', 'message', 'trace _ id', 'details {...}' - саппортторго жана алерттерге жардам берет.

Кардар боюнча Graceful retry (экспоненциалдык бэкофф), UIде так кеңештер.

8) бир нече PSP боюнча роутинг жана фейловер

Сапат эрежелери: p95 авторизациялар, конверсия, 3DS файлдарынын үлүшү, баасы.

Акылдуу роутер: метриктер начарлаганда - трафикти альтернативага өткөрүү.

3DS туруктуулук үчүн сессия/банк үчүн Sticky-маршрут.

Деградация планы: тез (P2P/Pay-by-Bank) калтырып, "оор" ыкмаларды өчүрүү, жыйынтык кезеги.

9) Бириктирүү жана каржы (Reconciliation)

Күн сайын PSPди жана капчык менен автосвертканы түшүрүү: суммалардын, комиссиялардын, кайтарымдардын дал келиши.

Келишпестиктер → тергөө иштери.

chargeback/refund/fees боюнча жеке отчеттор, ыкмалары боюнча чыныгы маржа эсептөө.

10) Фокуста сакталышы керек болгон метриктер

Депозитти ыкма/банк/өлкө/түзүлүш боюнча конвертациялоо.

Аманат/чегерүү убактысы (p50/p95).

3DS-файлдардын үлүшү, жокко чыгаруу, кайтаруу, chargeback rate.

Кол ревю жана TTV KYC үлүшү.

Uptime PSP жана маршруттар боюнча өз error-rate.

Cost per success жана ыкмалары боюнча ROI.

11) минималдуу API мисал (кыскартылган)

Депозиттик ниетти түзүү

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

Жооп

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

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

Кабыл алуу (платформа ичинде)

`POST /v1/wallet/credit`

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

12) Жеткиликтүүлүк жана UX касса

Минималдуу кадамдар: auto-detect өлкө/валюталар, сакталган ыкмалар.

Жергиликтүү ыкмалар: банк баскычтары, электрондук wallets, Apple/Google Pay.

Ачык-айкындуулук: комиссия/ETA корутундусу, операциянын статусу, түшүнүктүү каталар.

Жеткиликтүүлүк: чоң элементтер, контраст, screen readers, көп тилдүү.

13) DR/BCP жана коопсуздук иштери

Төлөм журналдарын репликациялоо, шифрлөө менен бекаптар, чейректик DR-машыгуулар.

RPO/RTO документтештирилген, PSP иштебей калган учурда "кийинкиге калтырылган" төлөмдөр.

WAF/бот-менеджмент кассада, бирок директорлор/SDK PSP үчүн өзгөчөлүктөр.

14) Көп каталар

Баланс акыркы webhook → double/рассинхрон чейин өзгөрөт.

Жок 'Idempotency-Key' → тармактык мүчүлүштүктөрдө кайталоо экинчи операцияны жаратат.

Алсыз текшерүү кол webhook → статус алмаштыруу.

PSP → "тынч айырмачылыктар" менен AutoScreen жок.

Бир PSP "бардыгы үчүн" → деградация учурунда токтоп калуу жана конверсия жоготуу.

3DS/дарек талааларын валидациялоо "көрүү үчүн" → чаржбектердин өсүшү.

15) киргизүү текшерүү тизмеси (сактоо)

Multi-PSP роутер, сапат эрежелери, Failover
Ар бир катмарда Idempotency ('txn _ id', 'Idempotency-Key')
Webhooks: HMAC, анти-replay, жеткирүү Логи, deduplication
Tokenization/hosted fields, PCI DSS scope-кыскартуу
3DS2/SCA, PSD2/Open Banking кайда жеткиликтүү
Антифрод/AML төлөөгө чейин жана кийин, step-up KYC
Auto PSP отчетторду текшерүү, айырмачылыктарды талдоо
Байкоо: p95 депозиттик/чыгаруу, 3DS fail-rate, uptime PSP
DR планы, кийинкиге калтырылган төлөмдөр, backaps журналдар
UX касса: жергиликтүү ыкмалары, ачык-айкын ETA/комиссия, жеткиликтүүлүгү

Жакшы төлөм интеграциясы - бул "SDK туташтыруу" эмес, туруктуу контурду куруу: көп PSP багыттоо, катуу демпотенттүүлүк, кол коюлган webhooks, антифрод/AML, автосверк жана байкоо. Мындай стек конверсияны жогорулатат, корутундуну тездетет, чаржбектердин тобокелдиктерин азайтат жана платформаны оюнчулар, өнөктөштөр жана жөнгө салуучулар үчүн алдын ала айтууга болот.