Төлөм провайдерлери менен SLA

TL; DR

Күчтүү SLA = бизнес таасири менен байланышкан өлчөнгөн KPI (AR, TtW, TtR, latency, webhook SLA, settlement timeliness), плюс процессуалдык милдеттенмелер (эскалация, RFO/RCA, өзгөрүүлөр) жана каржылык стимул (service credits). Өзүбүздүн көрсөткүчтөрүбүз жана провайдердин маалыматтарыбыз менен мониторинг жүргүзүп, күнүмдүк циклде текшерип, фейловердин даяр плейбуктарын кармап турабыз.

1) Терминдер жана иш чөйрөсү

SLA (Service Level Agreement) - сервистин сапаты боюнча келишимдик милдеттенмелер.
SLO (Service Level Objective) - конкреттүү максаттуу көрсөткүчтөр (саат/күн/ай).
PSP/Acquirer/APM/Bank/RTP - провайдердин түрлөрү; SLA рельстери боюнча айырмаланышы мүмкүн.
Ыкмалары/иш-аракеттери: 'deposit/auth/capture', 'refund', 'payout/withdrawal', 'webhooks', 'settlement'.

SLA көлөмү: API/панель, төлөмдөрдү кайра иштетүү, нотификация, отчеттуулук/реестрлер, колдоо, өзгөрүүлөр (өзгөрүү башкаруу), коопсуздук жана комплаенс.

2) SLA метр сөздүгү

2. 1 Жеткиликтүүлүк жана аткаруу

API Uptime% (мүнөттүк/беш мүнөттүк грануляция)

Auth/Capture Latency p95/p99 (сек)

Webhook Delivery p95 (сек) и Success % (≥99. 9%)

Settlement Timeliness: жарыяланган T + N кошулган батч үлүшү (≥ 99%)

2. 2 Конверсия жана сапат

Approval Rate (AR) сегменттери боюнча: 'country × BIN × method × device' (башкача айтканда, "референттик коридор" катары)

Soft Decline Recovery Support (Retrains, багыттоо колдоо)

Refund Success % и TtR p95

Payout Success % и TtW p95

Duplicate/Idempotency Incidents = 0

2. 3 Маалыматтардын жана отчеттуулуктун ишенимдүүлүгү

Report Delivery SLA: реестры `transactions/settlements/fees` до `HH:MM UTC` (≥99. 5%)

Schema Туруктуулук/өзгөрүү Notice: ≥ 30 күндүн ичинде билдирүү

Webhooks vs Reports Consistency: айырмачылыктар ≤ 0. 05%

2. 4 Окуялар жана колдоо

MTTA/MTTR (жооп/калыбына келтирүү үчүн убакыт) артыкчылыктуу деңгээл

RFO/RCA (Reason For Outage/Root Cause Analysis) ≤ 5 жумушчу күн

Planned Maintenance Notice ≥ 7 күн (критикалык - ≥ 14)

3) Сунушталган максаттуу баалуулуктар (көрсөтмөлөр)

(Ыкма/базар үчүн ылайыкташтырылган; карта/instant/APM айырмаланат.)

Uptime API (айлык): ≥ 99. 95% (критикалык контур)

Latency p95: Auth ≤ 1. 0 s, Capture ≤ 1. 5 s, Webhooks ≤ 3 s

AR Corridor (шилтемелер): Сиздин матрицада/BIN боюнча медиадан төмөн эмес - 2-3 p.p. (эсептөө ыкмасын бекитүү)

Refund TtR p95: карталар ≤ T + 1 б.д., instant rails ≤ 60 s

Payout TtW p95 (instant): ≤ 120 s; (T + 1) - жарыяланган күнү 100%

Settlement Timeliness: ≥ 99% көрсөтүлгөн T + N

Report Delivery: ≥ 99. 5% макулдашылган убакытка чейин

4) өлчөө жана далилдөө базасы

Сатуучу тарап (сиз): телеметрия API (app-level timers), Логин 'request _ id', Webhook Логи, ички иш-чаралар 'auth/capture/refund/payout', жеке Uptime/Latency dashboard.
Провайдер тарап: статус-бет, инциденттер боюнча техникалык эсептер, SLA отчеттору, AR/latency боюнча жүктөр, settlement-statement.
Салыштыруу: PSP отчеттор менен окуяларды күн сайын reconcile (кара "Салыштыруу"...), AR/latency статистикалык көзөмөл (коридорлор).
Бирдиктүү убакыт зонасы: UTC, ntp синхрондоштуруу.

5) Каржылык стимулдар жана кредиттер

• Uptime/Latency/Webhook → белгиленген% fee кредиттер деградация.
• Settlement → кредитти кечиктирилген суммадан/комиссиядан% менен кечиктирүү.
• Өнөкөт R-коридор бузуулар → роутинг/комиссия/биргелешкен план кайра карап чыгуу.
• Cap/Collar: кредиттердин жогорку чеги/ай, өзгөчөлүктөр (форс-мажор, жөнгө салуучу аракеттер).
• Non-performance Exit: катары менен N бузуулар менен токтотуу укугу.

6) окуя жана эскалация жараяны

P0-P3 класстары (P0 - толук жеткиликсиздик/массалык мүчүлүштүктөр).
MTTA/MTTR максаттары: мисалы, P0 MTTA ≤ 15 мин, MTTR ≤ 2 саат.
Каналдар: нөөмөт чат/телефон, тикет-система, статус-бет.
Алдын алуу планы менен RCA (≤ 5 р.д.): техникалык, процесстик, багыттоо чаралары.
Саппорт үчүн байланыш: оюнчулар үчүн билдирүүлөрдүн шаблондору (кечигүү/альтернатива).

7) Өзгөрүүлөрдү башкаруу (Change Management)

Notice ≥ 30 күн: API/реестр схемасы, 3DS параметрлери, каттамдар, settlement-календары, комиссиялык моделдер.
Sandbox биргелешкен тесттер + пилоттук 5-10% жол.
Rollback планы жана "feature-flag" сиздин тарапта.

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

транзит/тынчтык, күбөлүк (PCI DSS/SOC), алсыздык жана аларды жоюу мөөнөтү.
Санкция/AML-скрининг, PEP, SoF/SoW - провайдер колдогон функциялар жана алардын SLA.
Data Processing Addendum (DPA), retention и DSAR.
Breach Notification: ≤ 24 саат коопсуздук окуя.

9) Мониторинг жана дашборддор

1. Uptime/Latency (p50/p95/p99) ыкмалары жана аймактары боюнча.

2. Webhook SLA: жеткирүү убактысы, ийгиликтүү үлүшү, drebezg/дубликат.

3. AR/Soft Declines бөлүгүндө 'BIN × country × provider'.

4. Refund/Payout Health: Success %, TtR/TtW p95.

5. Settlement Timeliness жана Aging жок батч.

6. Incident Panel: MTTA/MTTR, ачык RCA, кредит-мемо.

10) SLA аналитика үчүн маалыматтар модели (минималдуу)

ts_utc, provider, method_code, action(auth/capture/refund/payout/webhook/settlement),
latency_ms, status, is_success,
bin, country, device_os,
webhook_delivery_sec, webhook_retry_count,
settlement_date, settlement_status,
incident_id, severity, mtta_sec, mttr_sec

11) SQL тилкелери (мисал)

11. 1 Uptime/Latency

sql
SELECT
DATE_TRUNC('hour', ts_utc) AS h,
provider, method_code, action,
COUNT() FILTER (WHERE is_success)=1. 0 / COUNT() AS success_rate,
PERCENTILE_CONT(0. 95) WITHIN GROUP (ORDER BY latency_ms) AS p95_ms
FROM sla_events
WHERE action IN ('auth','capture')
GROUP BY 1,2,3,4;

11. 2 Webhook SLA

sql
SELECT
DATE_TRUNC('hour', ts_utc) h, provider,
PERCENTILE_CONT(0. 95) WITHIN GROUP (ORDER BY webhook_delivery_sec) AS wb_p95,
AVG(CASE WHEN webhook_retry_count=0 THEN 1 ELSE 0 END) AS wb_success
FROM sla_events
WHERE action='webhook'
GROUP BY 1,2;

11. 3 Settlement Timeliness

sql
SELECT settlement_date, provider,
AVG(CASE WHEN settlement_status='ON_TIME' THEN 1 ELSE 0 END) AS on_time_share
FROM sla_events
WHERE action='settlement'
GROUP BY 1,2;

12) SLA пункт үлгүсү (үлгү)

text
1. Availability
- Monthly API Uptime ≥ 99. 95% (5-min granularity).
- Exclusions: Planned Maintenance (≤ 2h/month, 00:00–06:00 UTC, 7d notice).

2. Performance
- Auth p95 latency ≤ 1. 0 s; Capture p95 ≤ 1. 5 s.
- Webhook delivery p95 ≤ 3 s, success ≥ 99. 9%, no duplicates.

3. Financial Operations
- Settlement T+N on-time ≥ 99%; reports delivered by 07:00 UTC D+1 (≥ 99. 5%).

4. Incident Management
- P0: MTTA ≤ 15 min, MTTR ≤ 2 h; P1: 30 min / 4 h.
- RCA within 5 business days with preventive actions.

5. Data & Changes
- 30-day advance notice for API/report schema changes.
- Backward compatibility window ≥ 60 days.

6. Remedies
- Service credits per breach (tiered), cap 25% monthly fees.
- Termination right upon 3 consecutive P0 breaches.

13) Feylover Playbook

Auth/Latency деградациясы

Иш-аракеттер: башка PSP боюнча Smart-Routing киргизүү, аялуу BIN боюнча 3DS-challenge көбөйтүү, арткы менен soft-decline retry.

Webhook кечигүү/кайталоо

Иш-аракеттер: поллингге өтүү, иштеп чыгуучуларда демпотенттикти күйгүзүү, авто-рефандаларды убактылуу тоңдуруу.

Settlement кармалган

Иш-аракеттер: казыналык StressRes тартуу, убактылуу тез төлөмдөрдүн лимиттерин азайтуу, PSP эскалация, кредит-мемо.

payouts көйгөйлөр

Иш-аракеттер: резервдик рельске өтүү (SEPA/RTP/башка PSP), жогорку тобокелдик үчүн 'payout-lock', VIP артыкчылыктуу.

14) Провайдерлерди башкаруу жана QBR

QBR (quarterly business review): AR/Latency/Webhook/Settlement/KPI кредиттер, жакшыртуу планы, жол картасы fich.
Benchmarking: SLO, окуялар, наркы (наркы/GGR), отчеттуулуктун сапаты боюнча берүүчүлөрдүн салыштырма таблицасы.
Scorecard: SLA ар бир бөлүмү үчүн 0-5.

15) SLA киргизүү чек тизмеси

• Метриктер, формулалар жана сегментация аныкталган (UTC, p95/p99, эсептөө базасы).
• Орнотулган чогултуу/dashboard жана PSP отчеттор менен күнүмдүк текшерүү.
• Жазылган MTTA/MTTR, эскалация, байланыш 24/7, статус-бет.
• кызмат credits жана өнөкөт бузулуулар менен токтотуу укугу бекитилген.
• Change-notice ≥ 30 күн, sandbox тесттер жана rollback планы.
• Коопсуздук/комплаенс: PCI/SOC, breach ≤ 24h, DPA/retention.
• Feylover Playbook жана маршруттук оркестр менен бириктирүү.
• QBR/scorecard, AR-коридорлорду үзгүлтүксүз калибрлөө.

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

Бүдөмүк аныктамалар ("ийгилик" деп эсептелинет) → талаш-тартыштар жана "кагаз" SLA.
Алардын өлчөгүчтөрүнүн жоктугу → провайдердин отчетторуна көз карандылык.
Эч кандай каржылык стимул → SLA иштебейт.
антифрод эффектиси менен AR аралаштыруу → эсептөө базасына кирген нерсени чечүү.
Ignor settlement-календары жана Таймзон → тигүү жана накталай ажырым.

Резюме

Жумушчу SLA - бул жалпы сөз айкаштарынын жыйындысы эмес, цифралар жана процесстер менен тигилген контракт: сиздин телеметрияңыз менен тастыкталган жеткиликтүүлүк/ылдамдык/конверсия/корутундулар/отчеттор боюнча так SLO, мыйзам бузуулар үчүн кредит-мемо жана фейловердин даяр плейбуктары менен. Мындай SLA күтүүлөрдү теңдейт, жооп убактысын кыскартат жана түздөн-түз акча табуу максаттарын колдойт: AR жогору, TtW/TtR төмөн, кассалык кечигүүлөр сейрек кездешет жана инциденттер башкарылат.