ecoPayz: cüzdan və hesablar

1) Kontekst və yerləşdirmə

ecoPayz (Payz kimi dəyişdirilib) - rəqəmsal xidmətlərə və iGaming-ə (icazə verilən yurisdiksiyalarda) yönəlmiş multivalyuta balansları (bundan sonra «cüzdan/hesablar») olan elektron cüzdan. İstifadəçi pulu cüzdanında saxlayır, P2P edir, alıcılara ödəyir, balansı müxtəlif üsullarla doldurur və banka/karta/yerli kanallara çıxarır (giriş ölkədən/KUS-dan asılıdır).

Niyə merchant faydalıdır

Yuxarıdakı dönüşüm hədəf seqmentlərdə Hosted/App2App-UX və tanınma sayəsində.
Aşağı frod (SCA, device binding, risk-skor).
Çevik iqtisadiyyat (tez-tez CNP kartlarından aşağıda), cüzdanda sürətli partial refunds.

2) Məhsullar və rollar

Cüzdan/hesablar: istifadəçinin multivalyuta balansları (top-up/axın/çıxarış).
Kartlar (kart sxemlərinin relslərində virtual/plastik) - bütün ölkələrdə mövcud deyil.
Vauçer mənbələri (ecoVoucher və tərəfdaşlar vasitəsilə analoqlar) - icazə verilən yerlərdə.
PSP/ekvayer: merchant onbording, tarifləri/MDR, Hosted/Widget/API, hesablamalar və hesabatlar.
Cüzdan sxemi/emitenti: AUP, KYC/AML, limitlər, antifrod, cüzdan kitabı.

3) Kanallar və istifadəçi ssenariləri

3. 1 Pay-in (alıcıya ödəniş)

Hosted/Redirect (tövsiyə olunur): ecoPayz/Payz → giriş/SCA → təsdiq → status geri.
App2App/Deeplink: Mobil faylda cüzdan tətbiqi açılır, sonra kassaya qaytarılır.
Embedded/Widget: provayderin təhlükəsizlik tələblərinə uyğun olaraq.

3. 2 cüzdana Top-up (istifadəçi tərəfindən)

Kartlar (3DS2), A2A/Open Banking/lokal köçürmələr, eCash/vauçerlər, P2P. Mənbələrin dəsti ölkə və KYC səviyyəsindən asılıdır.

3. 3 Payouts/Withdraw

Istifadəçilərin cüzdanlarına alış-veriş ödənişləri; bundan sonra - istifadəçi tərəfindən bank/kart/lokal metodlara (ölkə üzrə əlçatanlıq/KOS) çıxarılması.

3. 4 P2P / Request-to-Pay

Pul kisələri arasında köçürmələr və ödəniş sorğuları (harada dəstəklənir).

3. 5 Cüzdan kartı

Virtual/plastik kart (əgər varsa): cüzdan balansından çıxarılma; online - SCA/3DS, POS - PIN/NFC.

4) Statuslar və hesablamalar

Tipik statuslar: 'created → pending → success | failed | canceled | expired' (+ lazım olduqda 'authorized → captured').
Settlement: PSP/provayder reyestrləri üzrə ödənişlər adətən T + 1/T + 2 (qul. günlər).
Məntiqlə, onlayn uğur və faktiki krediti bölüşün.

5) Limitlər, KYC və risk siyasəti

Limitlər per-txn/24h/7d/monthly; yeni alıcılar/alıcılar və nəticələr üçün ayrı-ayrı eşiklər.
KYC səviyyələri (əsas/genişləndirilmiş/VIP): üst-up/axın/çıxış və dəstəklənən metodların dəsti.
Velocity/cihaz/geo-qaydalar, sanksiyalar və yaş məhdudiyyətləri (xüsusilə iGaming üçün).
Limitlər/qaydalar isti yeniləmə imkanı ilə konfiqurasiyalarda saxlanılır.

6) Qaytarmalar, mübahisələr, son

Refund - ayrıca kredit əməliyyatı (full/partial) geri cüzdan/mənbə.
Chargeback: klassik kart çarjbeklərinin sırf «cüzdan» silinməsi üçün ümumiyyətlə yoxdur; əgər faktiki rels - kart (cüzdan daxilində COF/kart), emitentdə kart prosedurları mümkündür.
ODR prosedurlarını planlaşdırın və tam rəqəmsal xidmət qeydlərini saxlayın.

7) İqtisadiyyat və komissiyalar

Merchant üçün MDR adətən CNP kartlarından aşağıdır, lakin geo/dövriyyədən/kateqoriyadan asılıdır.
Əlavə xərclər: Hosted/SDK, dəstək 'pending/expired', ODR/disputs, recon, mümkün ehtiyatlar/risk hold.
Qiyməti idarə edin: A2A-top-up və multivalyutanı (daha az FX) stimullaşdırın, VIP-də abseyl istifadə edin.

8) UX təcrübələri

Mobile-first: App2App prioritetdir; masaüstü - aydın Redirect.
Təsdiq gözləmə taymeri ('pending'), təhlükəsiz təkrar, alternativ təkliflər (kartlar/A2A).
Şəffaf səhvlər: cüzdan/metod limiti, SCA-nın uğursuzluğu, zaman aşımı.
Qəbz: məbləğ/valyuta, 'transactionId', kanal (App2App/Hosted), maliyyə referansı/reyestrdən UTR.

9) Merchant inteqrasiyası

Variantlar

1. Hosted/Redirect - sürətli başlanğıc, minimum PCI/PII izi.
2. Server-to-Server + App2App/Hosted - xüsusi UX və sıx status nəzarəti.
3. Pay-by-Link/Invoice - gecikmiş ödənişlər/kollektor üçün.

Backend minimumu

API: `createPayment`, `authorize/capture` (если требуется), `refund`, `queryStatus`, `webhook`, `reconcile`.
İdempotentlik ('orderId' + açar), eksponensial təkrarlamalar, daxil olan veb-hook dedupu.
Webhooks: imza/NMAS, vaxt möhürləri, replay qorunması.
Recon: daily auto-recon + full-recon, UTR/bank linklərinin saxlanması, rasinxronlara görə alertlər.
Observability: dönüşüm, 'pending → success/expired', settlement-lag, SCA/limit səhvləri.

10) Təhlükəsizlik və uyğunluq

SCA (cüzdan autentifikasiyası), device binding, davranış hesablaması.
PII Minimallaşdırma: həssas məlumatların daxil edilməsi üçün Hosted/Widget, secrets - vault, IP-allowlist webhook-end-points, ciddi redirect-URI.
KYC/AML/GDPR, yaş, sanksiyalar, geo-filtrlər, Responsible Gaming.

11) Ödənişlər və affiliatlar

Cüzdan ödənişləri tez-tez əlverişlidir (tez və ucuz), lakin risk/geo/CUS seqmentləri.
Alternativləri saxlayın: SEPA/RTP/Push-to-Card/mübahisəli bölgələr və ya böyük məbləğlər üçün yerli cüzdanlar.

12) iGaming üçün xüsusiyyətlər

Geo və lisenziyanın hüquqi uyğunluğunu yoxlayın; yaş nəzarəti və özünü istisna daxil edin.
Gözləyin: daha sərt limitlər, mümkün hold/ehtiyatlar, əməliyyatların və ödənişlərin genişləndirilmiş monitorinqi.
Risk/geo/oyunçu profili ilə ağıllı marşrutlaşdırma (cüzdan, A2A, kart çeki) planlaşdırın.

13) KPI və əməliyyat metrikası

Approval rate (App2App/Hosted üzrə ayrıca).
Pending dwell time и доля `pending→expired`.
Refund rate/ODR və orta vaxt həlli.
Settlement lag (uğur → reyestr → qəbul).
FX paylaşımı və orta FX marjası.
Dövriyyədə VIP/genişləndirilmiş KYC payı, Cost-to-serve (dəstək/mübahisələr).

14) Hasilat çek siyahısı

1. PSP/provayder ilə müqavilə: tariflər/MDR, FX qaydaları, veb-hook/reyestrlər üzrə SLA, icazə geo/şaquli.
2. İnteqrasiya: 'createPayment' + App2App/Hosted, səhv/limit/təkrarlama ekranları.
3. Təhlükəsizlik: imza/NMAS web hook, gizli vault, redirect-URI, IP-allowlist.
4. Recon: daily + full, UTR/maliyyə referanslarının saxlanması, rassinxronlara qarşı həyəcanlar.
5. Refunds/ODR: partial/full, sapport pleybukları, refund order.
6. Konfiqlər: limitlər/KUS/tariflər/geo - koddan kənar, versiya və sürətli yeniləmə ilə.
7. SLA daşbordları: konvertasiya, 'pending', settlement-lag, qaytarmalar; anomaliyada alertlər/geo.
8. E2E testləri: mobil App2App, desktop-redirect, vaxtlar/təkrarlamalar, qismən qaytarmalar, provayder deqradasiyası.

Göstəriş kartı

Statuslar: 'created/pending/success/failed/canceled/expired' (+ 'authorize/capture' harada tətbiq olunur).
Settlement: adətən PSP/provayder reyestrləri üzrə T + 1/T + 2.
Chargeback: təmiz «cüzdan» debet üçün yoxdur; kart relsi üçün mümkündür.
Limitlər/KOS: ölkə/səviyyədən asılıdır; konfiqada saxlanılır və müntəzəm olaraq yenilənir.
Recurrent: «ilk ödəniş → mandat» (SEPA/Open-Banking/cüzdan-mandat) - əgər ssenari bunu dəstəkləyirsə.

Xülasə

ecoPayz/Payz - multi-valyuta balans, güclü mobil UX və başa düşülən əməliyyat ilə yetkin cüzdan. Hosted/App2App vasitəsilə inteqrasiya edin, webhooks + idempotentlik + recon ətrafında qurun, limitləri/KUS/tarifləri/geo konfiqurasiyada saxlayın və iGaming üçün - hüquqi çərçivəyə riayət edin, riski bölün və oyunçu və yük profilinə uyğun olaraq smart-routing ilə alternativ relsləri (A2A/vauchers/kartlar) saxlayın.