GH GambleHub

Платформы оркестрации платежей

1) Что такое POP и зачем она нужна в iGaming

Payment Orchestration Platform — прослойка между вашим продуктом и множеством PSP/эквайреров/локальных методов/кошельков/банков. Она:
  • Увеличивает AR и снижает DR за счет умного роутинга/каскадов (BIN/GEO/метод/цена/здоровье).
  • Снижает стоимость (IC++/markup/fixed/FX-slippage) через smart-routing и A/B выбора провайдеров.
  • Повышает устойчивость: failover, circuit-breaker, health-пробы, деградация до безопасных режимов.
  • Ускоряет go-to-market: единый API/SDK, каталог адаптеров, управление политиками без релизов.
  • Обеспечивает соответствие: KYC/AML/санкции, геоблоки, same-method, MoR/субмерчанты.
  • Упрощает отчетность: нормализация статусов, файлы сеттлмента, витрины ND/GGR/NGR/fees/налоги.

2) Build vs Buy: как выбирать

Buy (внешний POP): быстрее старт, готовые адаптеры/дашборды/SLA; минусы — маржа провайдера, ограниченная глубина кастомизации, vendor lock-in.
Build (in-house): полный контроль над правилами/данными/ценой; минусы — CAPEX/компетенции/SOC2-процессы.
Гибрид: критичные рынки/методы — in-house, «длинный хвост» — через внешний POP.

Критерии: покрытие GEO/методов, latency, прозрачность цен, доступ к raw-данным и webhooks, поддержка network tokens/3DS2, payout-оркестрация, sandbox, версия API, SLA/пенальти.

3) Целевая архитектура POP (слои)

1. API-Gateway & Auth — rate-limit, OAuth/JWT, mTLS, schema-validation, idempotency-keys.
2. Rules-Engine — декларативные политики (GEO/BIN/метод/сумма/риск/цена/SLA/санкции).
3. Router/Cascader — выбор `(PSP, MID, require_3DS, retry_window, max_attempts)`; sticky BIN/GEO.
4. Provider Adapters — унифицированный интерфейс (authorize/capture/refund/void/payout/tokenize).
5. 3DS & Risk Orchestration — TRA/whitelisting, challenge/funnel, делегированная аутентика.
6. Reconciliation — импорт файлов сеттлмента, мэппинг кодов, разнесение fees/reserve.
7. Payout Orchestration — выбор коридора, same-method/return-to-source, cut-off/T+N, проверки.
8. Treasury/FX — мультивалютные книги, EOD-reval, realized/unrealized FX, прогноз ликвидности.
9. Data Platform — шина событий (Kafka/PubSub), outbox, DWH/лаги, витрины ND/GGR/NGR/fees/tax.
10. Observability — логи/метрики/трейсы, SLO/SLI, алерты, playbooks инцидентов.
11. Admin/UI — управление правилами, AB-тестами, коридорами выплат, лимитами, ключами.

4) Роутинг и правила: входные сигналы

Карта: BIN/IIN, brand, debit/credit, commercial/premium, issuer country.
Гео/комплаенс: IP/GPS/SIM/KYC country, санк-листы, лицензии, class рынка (A–D).
Транзакция: сумма/валюта/канал, velocity, риск-скор фрода, статус 3DS.
Поставщики: AR/DR, soft-decline %, 3DS pass, latency/ошибки, SLA health.
Стоимость: IC++/markup/fixed, FX-quality, reserve%, funding T+N.
Ограничения: лимиты PSP, maintenance, инциденты, локальные запреты.

Скоринговая функция (пример):
  • `Score = 0.45AR_live − 0.25Cost_bps + 0.15SLA_health + 0.10FX_quality + 0.05Reserve_score`

Политика ретраев: только soft-decline; idempotency-key общий на весь каскад; бюджет 15–30 сек.

5) 3DS и liability shift

Стратегии: frictionless→challenge эскалация, принудительный 3DS на риск-GEO/BIN, delegated auth.
Храните результат (liability_shift=true/false), ACS/DS-коды для диспутов.
A/B 3DS-политик: баланс AR vs liability.

6) Токенизация

Network tokens (Visa/MC/DC): стабильность AR, меньше lifecycle-ошибок.
Vault tokens: единый сейф → мульти-PSP; маппинг PSP-специфичных токенов.
Ротация PAN/expiry, обновления COF/COFT, card-on-file индикаторы, DS-регистрация.

7) Reconciliation и стоимость

Нормализация статусов (authorize/capture/refund/chargeback/representment).
Импорт settlement files: разложение Interchange/Scheme/Markup/Fixed/FX/Reserve.
Расчет effective take-rate и FX slippage по PSP/методу/MID/GEO.
Variance-отчеты: `Tx → File → Funding` (дельта > порога → тикет).

8) Payout-оркестрация и трежери

Коридоры: выбор провайдера по GEO/валюте/банку, return-rate/ETA/SLA.
Политики: same-method/return-to-source, SoF/KYC уровни, отложенные выплаты (T+N+K).
FX: выбор валюты источника, EOD-reval остатков, realized FX при funding/payout.
Резервы: rolling/reserve-ledger и календарь релизов.

9) Безопасность и комплаенс

SANCTIONS/PEP/AML: централизованный скрининг, kill-switch по GEO/контрагентам.
PCI DSS: mTLS, сегментация PAN-scope, запрещенный логинг чувствительных полей, P2PE/SDK.
GDPR/Privacy: DPA, роли Controller/Processor, DSR/DSAR, сроки хранения.
Регуляторика iGaming: геоблоки, лицензии, RG/self-exclusion, отчетные форматы регуляторов.

10) Наблюдаемость, SLO и инциденты

SLI/SLO: AR, 3DS pass, p95 latency, error-rate, funding T+N hit-rate, payout ETA.
Алерты: routing degradation, soft-decline surge, 3DS anomaly, take-rate spike, health down.
Playbooks: failover PSP/ACS, reroute GEO/BIN, отключение проблемного правила, деградация до «только белых методов».
Пост-инциденты: RCA, изменение весов/порогов, тесты-регрессии.

11) Data & BI слой

Event-driven: outbox → Kafka/PubSub → consumers (router, 3DS, antifraud, DWH).
Exactly-once (практически): outbox-паттерн, идемпотентные consumers, дедупликация по ключам.
Витрины: `transactions_flat`, `provider_fees`, `fx_settlement`, `ggr_rollup`, `vat_ledger`, `payout_corridors`, `reserve_ledger`.
AB-тесты: bandits/splits, guardrails (min-AR, max-take-rate).

12) Референс-модель данных (упрощенно)

sql
-- Providers/MID/ref methods. providers(provider PK, pricing_model, fx_policy, reserve_pct, meta)
ref. mids(mid PK, provider FK, country, method, descriptor, enabled, meta)

-- Profiles/routing rules ref. routing_profiles(profile_id PK, name, version, enabled, meta)
ref. routing_rules(
rule_id PK, profile_id FK, iso2, bin_from, bin_to, method,
provider, mid, require_3ds, priority, retry_soft JSONB,
max_attempts, ttl_seconds, enabled, meta)

-- Online provider metrics (sliding window)
live. provider_stats_15m(
provider, method, iso2, bin6, approvals, declines, soft_declines,
three_ds_pass, avg_latency_ms, updated_at)

-- Transactions/attempts with payments idempotency. auth_attempts(
attempt_id PK, idempotency_key, step, provider, mid, require_3ds,
status, decline_code, amount_minor, currency, bin, iso2,
started_at, finished_at, meta)

-- Settlement/fees/reserve finance. settlement_fees(
batch_id, provider, mid, period_start_at, period_end_at, currency,
interchange_amt, scheme_amt, markup_amt, auth_amt, refund_amt,
cb_amt, gateway_amt, fx_spread_amt, reserve_delta, total_fees)

treasury. reserve_ledger(
id PK, provider, mid, hold_date, release_due_date,
hold_amount, released_amount, cb_consumed, fines_consumed, status, meta)

-- Payout corridors. corridors(
corridor_id PK, from_iso2, to_iso2, method, provider,
success_rate_7d, return_rate_7d, avg_eta_hours, status, updated_at)

13) Примеры правил и запросов

13.1. Псевдо-DSL правила роутинга

yaml rule: "cards_eu_low_risk_v2"
when:
iso2 in [DE, NL, AT, FI] AND method == "CARD"
AND bin. issuer_country == iso2 score:
AR_live: 0. 45
Cost_bps: -0. 25
SLA_health: 0. 15
FX_quality: 0. 10
Reserve_score: 0. 05 routes:
- psp: "Acq_A" mid: "A_DE_01" require_3ds: false max_attempts: 1
- psp: "Acq_B" mid: "B_EU_02" require_3ds: true max_attempts: 1 retry_on_soft: [TIMEOUT, ISSUER_UNAVAILABLE, SOFT_DECLINE]
budget_ms: 20000

13.2. Онлайн-рейтинг провайдеров

sql
SELECT provider, method, iso2,
SUM(approvals) appr, SUM(declines) decl,
ROUND(100. 0 SUM(approvals) / NULLIF(SUM(approvals+declines),0),2) AS ar_pct,
ROUND(100. 0 SUM(soft_declines) / NULLIF(SUM(declines),0),2) AS soft_share_pct
FROM live. provider_stats_15m
WHERE updated_at > now() - INTERVAL '20 minutes'
GROUP BY 1,2,3
ORDER BY ar_pct DESC, soft_share_pct DESC;

13.3. Стоимость по провайдерам (all-in take-rate)

sql
SELECT provider,
SUM(total_fees) / NULLIF(SUM(t. amount_reporting),0) 100 AS take_rate_pct
FROM finance. settlement_fees f
JOIN dw. transactions_flat t ON t. provider=f. provider
WHERE f. period_start_at>=:from AND f. period_end_at<:to
GROUP BY 1
ORDER BY take_rate_pct;

13.4. Эффект каскада (step-conversion)

sql
WITH s AS (
SELECT idempotency_key, MAX(step) steps, BOOL_OR(status='APPROVED') approved
FROM payments. auth_attempts
WHERE started_at BETWEEN:from AND:to
GROUP BY 1
)
SELECT steps, COUNT() orders,
100. 0 SUM(approved::int) / NULLIF(COUNT(),0) AS conv_pct
FROM s GROUP BY 1 ORDER BY 1;

14) KPI и дашборды

AR/DR по PSP/MID/GEO/BIN/методу (15/60-мин окна + DTD).
Step-conversion (1-я/2-я/3-я ветка).
Take-Rate % и FX-slippage по провайдеру/методу.
3DS pass-rate и liability shift.
Health/SLA: latency, timeouts, error-rate, инциденты.
Reserve & Funding: reserve% и T+N hit-rate.
Payout Corridors Health: success/returns/ETA.
Policy Coverage: доля событий с актуальной версией профиля.

15) Алерты и пороги

Routing Degradation: падение AR > Y bps за 10–30 мин.
Soft-Decline Surge: доля soft-decline растет → включить доп. ветку/step-up 3DS.
3DS Anomaly: падение pass-rate > X% у BIN/эмитента/PSP.
Take-Rate Spike: рост all-in стоимости > порога.
Health Down: SLA breach (latency/error) — авто-failover.
Policy Drift: попытки без idempotency_key/без профиля — P1.
Settlement Delay: нарушение T+N или missed reserve-release.

16) Best practices (коротко)

1. Идемпотентность и ретраи только по soft-decline, общий ключ на каскад.
2. Живая телеметрия AR/3DS/latency/health и авто-failover.
3. Ценовая функция маршрута (AR vs Cost vs SLA vs FX) + sticky BIN/GEO.
4. Network tokens + единый vault; COF/COFT корректно проставлять.
5. Cut-off-aware: не плодить partial-capture под конец дня.
6. Reconciliation: собственный расчет fees/FX, variance-отчеты.
7. Payout-оркестрация с same-method и контролем коридоров.
8. Версионирование правил и A/B-тесты с guardrails.
9. Разделение слоев: router ≠ antifraud ≠ policy engine; общие справочники.
10. Док-трассировка санкций/лицензий/политик, kill-switch по GEO.

17) Чек-лист внедрения

  • Выбор модели (build/buy/hybrid), карта GEO/методов/PSP/MID.
  • Схема API, идемпотентность, outbox, event-шина, DWH.
  • Rules-engine + UI: профили, веса, soft-codes, 3DS-политики.
  • Адаптеры: normalize API/коды, sandbox тест-наборы.
  • Телеметрия/алерты/SLO, health-фид провайдеров.
  • Reconciliation: import файлов, разнос fees/резерва/FX.
  • Payout-оркестрация: коридоры, same-method, SoF/KYC.
  • Безопасность: PCI/GDPR/санкции, секреты/ротация, доступы.
  • Документация и playbooks инцидентов; регрессионные тесты.

Резюме

POP — это не просто «прокси до PSP», а центральная операционная шина платежей: умный роутинг и каскады, 3DS/риск-оркестрация, reconciliation и payouts, трежери/FX, наблюдаемость и комплаенс. Построив платформу с идемпотентностью, живой телеметрией, прозрачной стоимостью и правилами, вы поднимаете AR, снижаете all-in take-rate, защищаете P&L от сбоев и ускоряете выход на новые рынки без переписывания продукта.

Contact

Свяжитесь с нами

Обращайтесь по любым вопросам или за поддержкой.Мы всегда готовы помочь!

Telegram
@Gamble_GC
Начать интеграцию

Email — обязателен. Telegram или WhatsApp — по желанию.

Ваше имя необязательно
Email необязательно
Тема необязательно
Сообщение необязательно
Telegram необязательно
@
Если укажете Telegram — мы ответим и там, в дополнение к Email.
WhatsApp необязательно
Формат: +код страны и номер (например, +380XXXXXXXXX).

Нажимая кнопку, вы соглашаетесь на обработку данных.