Интегратсия бо дарвозаҳои пардохт: ҷараён, бозгашт, оштӣ

Мақолаи пурра

💡 18+. Маводи техникӣ барои платформаҳои IGaming, операторҳо ва провайдерҳои пардохт. На даъват ба бозӣ.

1) Нақши оркестри пардохтӣ дар IGaming

Кассаи амонатӣ "артерия" -и платформа мебошад: амонатҳоро қабул мекунад, пули нақдро оғоз мекунад, баргардонидан/баргардонидани барқро коркард мекунад ва ҳамёнро ҳамоҳанг мекунад (Ledger). Хатогӣ ё таъхир дар ин ҷо зуд ба хатари молиявӣ ва мутобиқат табдил меёбад. Вазифаи меъморӣ дар сурати нокомӣ ҷараёни пули нақд зуд ва собит дуруст аст.

2) Ҷараёни асосӣ бо PSP (харитаи давлатӣ)

2. 1 Амонат (корти статусӣ)

1. create_intent (INITIATED) → Дар паҳлӯи платформа нияти пардохт эҷод кунед.

2. иҷозат диҳед (AUTORIZED) → дар PSP нигоҳ доред (ихтиёрӣ - якбора забт кардан).

3. 3-DS/AVS/KYC қалмоқҳо → санҷишҳои иловагии хавф/танзим.

4. гирифтан (CAPTRED) → дебетӣ; кредити ҳамён.

5. ноком/ба охир нарасидааст/бекор карда шудааст → ҷуброн ва бастани ният.

2. 2 Пули нақд (бозхонд)

дархост → тасдиқи RG/AML/limitetы → payout_initiated → payout_settled/failed.

Тасдиқи чаҳор чашм барои VIP/миқдори калон, маҳдудияти суръат ва қоидаҳои гео-қоидаҳо.

2. 3 беэътибор/баргардонидан

беэътибор: барои забт кардан бекор кунед (нигоҳ медорад).

баргардонидан: қисман/бозгашти пурра пас аз забт.

Барои схемаҳои кортӣ - ҳолати ҷудогонаи "пешниҳодшуда/коркардшуда".

Инвариант: Ҳақиқати тавозуни плеер ҳамён аст. Тарҳҳои PSP тавозунро мустақиман тағир намедиҳанд; танҳо тавассути 'фармони ҳамён. қарз/дебет 'бо idempotency.

3) Idempotence, калидҳо ва ақибнишинӣ

Ҳар як амалиёти навиштан 'X-Idempotency-Key' and 'X-Trace-Id' -ро иҷро мекунад.

Таркиби калидҳо ба параметрҳои тиҷорат вобаста аст (масалан, 'ният _ id + маблағ + асъор').

Такрор кардан бо ҳамон калид → ҳамон натиҷа (200 бо бадани кӯҳна).

Бозгашт бо ақибнишинии экспоненсиалӣ + ҷиттер, 'вақт/мӯҳлати ниҳоӣ'.

4) 3-DS, AVS, суръат, антифрауд

3-DS 2 бошад. x: беҳтараш мушкилот-ҷараён бо изи ангуштони дастгоҳ; Log ECI/CAVV/DST bans ‌ ID.

AVS/CVV: Рамзҳои тасдиқкуниро ба қоидаҳои телеметрия ва масир дохил кунед.

Суръат: маҳдудиятҳо аз рӯи миқдор/миқдор/кортҳо/ASN/дастгоҳҳо (1h/24h/7d).

Нуктаҳои рафторӣ: номувофиқатии минтақаи гео/вақт, бисёр кортҳо/пасандозҳои кам, пули нақд.

5) Масир ва каскадҳои PSP

Қоидаҳо: диапазонҳои гео, БИН, намуди корт, арзиш, табдили, меъёри хатар.

Каскад: PSP1 → PSP2 дар бораи нокомӣ, бе гум кардани сабад (аломати idempotent).

Гурӯҳи A/B/мусаллаҳ: оптимизатсияи табдили ва арзиши.

Fail-open/пӯшида: Барои хатогиҳои шубҳанок, бо нобаёнӣ истифода баред (масалан, тавассути савдогари дигар такрор кунед), аммо на барои гирифтани дубора.

6) Шартномаҳои API (порчаҳои истинод)

6. 1 Ташкили нияти амонат


POST/v1/кассир/ният
Сарлавҳаҳо: X-Idempotency-Key, X-Trace-Id
{
"player_id":"p_123," "маблағ ": {"маблағ": 50. 00, "асъор":" EUR"}, "усул ":" корт", "метамаълумот ": {"brand _ id":" A"," минтақа":" EU"}
}
→ 201 {"intent_id":"pi_001,""status":"INITIATED"}

6. 2 Авторизатсия/забт кардан


POST/ v1/cashier/intents/pi_001/authorize
→ 200 {"статус ": "АВТОРИЗАТСИЯ ", "psp _ ref ":" psp _ aa1"," eci":" 05"," cavv":...""}

POST/ v1/cashier/intents/pi_001/capture
→ 200 {"статус ": "CAPTORED ", "capture _ id":" cap _ 001"}

6. 3 беэътибор/баргардонидан


POST/ v1/cashier/captures/cap_001/refunds
{"refund_id":"rf_001," "маблағ ": {"маблағ": 10. 00, "асъор":" EUR"}}
§ 202 {"статус ": "REPUND _ DOMPITED"}

6. 4 Платформаи PSP Webhooks → (аз ҷониби HMAC/EDDSA имзо шудааст)


POST/webhooks/psp
Имзои X: sha256 =...
{
"ҳодиса ":" пардохт. гирифташуда, "" psp_ref":"psp_aa1, "" intent_id":"pi_001, "" миқдор ": {" minor _ vits ": 5000," асъор ":" EUR "}," occurred_at":"2025-10-23T12:05:01Z, "" "idempotency_key":"cap_001"
}

Қабулкунанда бояд: имзо/timestamp/nonce, deduplicate 'event _ id' -ро санҷед, бо 'intent _ id' мувофиқат кунед.

7) Ҳамоҳангсозӣ бо ҳамён (Китобча)

Пас аз гирифтан: ҳамёни фармон. қарз '(бемаънӣ) → тавозуни бозингар.

Баргардонидан: 'ҳамён. дебет '(ё' ҳамён. hold_release' барои беэътибор).

Cashout: 'ҳамён. дебет '→' пардохт 'v PSP; пас аз webhook 'payout _ soled' - пӯшидани саҷда.

"Амонат" -и Saga: 'иҷозат додан → гирифтан → қарз' бо ҷуброни нокомӣ.

Сагаи "баргардонидан/пардохт": 'дархост → пешниҳодшуда → ҳалшуда/ноком' бо redo ва deduplication.

8) Мусолиҳа - дили назорати пул

8. 1 Мусолиҳаи ҳаррӯза

Ҳисоботи ҳисоббаробаркунии PSP-ро гиред (аз рӯи савдогар/сана/асъор).

Харита ба қайди платформа: 'ният/гирифтан/баргардонидан/пардохт' ↔ 'вурудоти ҳамён'.

Гурӯҳбандӣ:

match: ok, timing: delay mázh гузориш медиҳад, missing_psp: дар платформа аст, дар PSP нест, missing_platform: дар PSP аст, дар платформа нест, amount_mismatch: номувофиқатӣ байни миқдор/асъор/пардохт.
Қоидаҳои худкори вақт, чиптаҳо/афзоиш барои номувофиқатӣ.

8. 2 Раванди техникӣ

Гузоришҳо аз ҷониби SFTP/API аз рӯи ҷадвал гирифта мешаванд (бозгашт + назорати якпорчагӣ).

Азназаргузаронӣ → нормализатсия → харитасозии детерминистӣ ('psp _ ref', 'intent _ id', 'capture _ id').

Мусолиҳа дар OLAP (Click

Намоишҳои BI: табдили, сабабҳои нокомӣ, арзиши канал, вақти пӯшида.

8. 3 Огоҳӣ

'% номувофиқатӣ'> X саҳ. P., 'missing _ platform' хӯша, 'миқдори _ номувофиқ' афзоиш, 'амонат _ муваффақият' фарқияти канал/гео, пиршавии амалиётҳои барҷаста> N рӯз.

9) Пардохт/баҳс

Давраи зиндагӣ: огоҳинома → далел → намояндагӣ → арбитраж.

Бастаҳои далелҳоро нигоҳ доред (KYC, IP/ASN, дастгоҳ, натиҷаҳои 3-DS, гузоришҳои истифода).

Робитаи наздик бо хавф/қаллобӣ: манъи корт/дастгоҳ/ASN дар сатҳи масир.

KPI: меъёри бурд, хароҷот барои хидмат, вақти пӯшида.

10) Телеметрия ва SLO

p95 ваколатнома: ≤ 3 с, п99: ≤ 6-8 с (вобаста ба 3-DS/бонкҳо).

Меъёри муваффақияти пасандозҳо аз ҷониби geo/PSP: ҳадаф ≥ 85% (дастури воқеӣ).

Қафои оштӣ: ҳисобот ≤ T + 1 рӯз баста шуд; пиршавӣ беэътибор

Гардиши баргардонидан: ≤ T + 1 барои фиристодан, ≤ T + 5 барои бақайдгирӣ (тибқи схема).

Нишондиҳандаҳо: меъёри хатогӣ аз рӯи рамзҳо, нокомӣ аз ҷониби 3-DS/AVS, матритсаи таназзул (бонк/код), арзиши як муваффақият, webhook-lag, тӯфонҳои такрорӣ.

11) Бехатарӣ ва риояи

MTLS ба PSP + OAuth2/request калидҳои имзоҳо/шаҳодатномаҳо барои як бренд/минтақа.

PCI DSS: токенизатсияи PAN, ҳеҷ гоҳ CVV, сегментатсияи минтақаро нигоҳ надоред.

Аудити WORM: амалиёти крит (баргардонидани дастӣ/беэътибор, тағир додани тоҷир).

RG/AML: пойҳо пеш аз гирифтан/пардохт; sanklists/POP; Ҳисоботи SAR/STR.

Истиқоматгоҳи PII: гузоришҳо/гузоришҳо дар минтақа; RLS/ниқоб дар BI.

12) Мушоҳида ва сабти ном

Гузоришҳои сохторӣ (JSON) бо 'trace _ id', 'psp _ ref', 'intent _ id/capture _ id/refund _ id', рамзҳо ва давомнокӣ.

Кушодани Telemetry дар HTTP/GRPC/DB/навбатҳо; 100% интихоб барои хатогиҳо/аномалияҳои пулӣ.

Панелҳои NOC: табдили канал, p95, нокомии код, webhook-lag, DLQ.

13) Амалҳои бесарусомонӣ ва DR

Суқути PSP: автокаскада/" таваққуфи навро таваққуф кунед"

Webhooks таъхир: deadup + recalibration тавассути pull-API.

Фармоишӣ: idempotency ва мошини вазъ дар платформа.

Қатъи минтақавӣ: масъулияти дороиҳо/дороиҳо, RPO ≤ 5 дақиқа, RTO ≤ 30 дақиқа.

14) Рӯйхати санҷишҳо

Платформа/Оператор

Ҳама роҳҳоро бо 'X-Idempotency-Key', 'X-Trace-Id' менависанд.
Масири PSP/каскадҳо бо телеметрия ва маҳдудиятҳо.
3-DS/AVS/velocity фаъол аст; қоидаҳои хавф ва мамнӯъ.
Webhooks имзо; бобои 'event _ id'; DLQ.
Пасандоз/баргардонидан/пардохт Sagas; ҷуброн бидуни "таҳрири дастӣ".
Оштии ҳаррӯзаи T + 1, ҳолатҳои номувофиқ, огоҳиҳо.
Минтақаи PCI, токенизатсияи PAN; Аудити WORM амалиёти крит.
Пойҳои RG/AML барои гирифтан/пардохт.

Интегратсияи PSP/пушти мизи нақд

Шартномаҳои хатогӣ муқаррар карда мешаванд; харитасозии рамзҳои таназзул.
Такрори бехатар аст; калидҳои idempotency ҳуҷҷатгузорӣ карда мешаванд.
Вақти истироҳат/ақибнишинӣ/ҷиттер, сими барқ, маҳдудиятҳои нархҳо.
Ҳисоботҳо тавассути API/SFTP дастрасанд, беайбӣ кафолат дода мешавад.

15) Анти-намунаҳо (парчамҳои сурх)

Тавозун аз ҷониби webhook PSP бидуни фармони возеҳ ба ҳамён тағир меёбад.

Не idempotency → аз ҳисоб/қарзҳои дукарата.

Кассаи дарунсохт дар дохили IFrame провайдери бозӣ (аз даст додани назорати RG/AML/telemetry).

Калидҳои савдогарони маъмул барои якчанд брендҳо/минтақаҳо.

Созиш нест T + 1, харитасозии дастӣ Excel.

Ҳисоботи BI/танзимкунанда мустақиман аз кассаи OLTP.

3-DS/AVS хатогиҳо ба қайд гирифта нашудаанд/таҳлил карда намешаванд.

Веб-дастгоҳҳои имзонашуда/тасдиқи тиреза → дубора.

Таҳрири дастии ҳолати пардохт/тавозун дар пойгоҳи додаҳо.

16) Сатри поён

Интегратсияи боэътимод бо дарвозаҳои пардохт оркестр аст, на "интиқоли API. "Муваффақият таъмин карда мешавад:

1. Фармонҳои пулии Idempotent ва sagas (иҷозат/гирифтан/баргардонидан/пардохт).

2. Масири PSP ва каскадҳо бо телеметрияи 3-DS/AVS/velocity ва воқеӣ.

3. Мусолиҳаи ҳаррӯза ва баҳисобгирии қатъии ихтилофҳо.

4. Амният ва риояи он (mTLS, имзоҳо, PCI, RG/AML, WORM).

Бо бунёди ин таҳкурсӣ, платформа табдили амонатҳоро афзоиш медиҳад, хавфҳои пардохт ва пардохтро коҳиш медиҳад ва бо боварӣ аудитро мегузаронад - ҳатто дар авҷи трафик ва вақте ки провайдерҳои беруна ноком мешаванд.