Neosurf: nagt talonlar

1) Neosurf näme we haçan saýlamaly

Neosurf - öňünden tölenen talon töleg usuly: ulanyjy fýuzeri oflayn hyzmatdaşlardan (kiosklar, supermarketler, ýangyç guýulýan stansiýalar) nagt/kartoçka satyn alýar ýa-da myNeosurf balansyny doldurýar, soň bolsa talonyň PIN koduny girizip ýa-da gapjyga girip onlaýn töleýär. Serişdeler derrew hasapdan çykarylýar, kartalardaky ýaly çarjbek töwekgelçiligi ýok; yzyna gaýtarmalar üpjün edijiniň/PSP düzgünlerine laýyklykda aýry-aýry karz amallary hökmünde resmileşdirilýär.

Gowy işleýän ýeri

Pes çekli sanly harytlar, oýunlar, abuna ýazylmalar.
Pes penetrasiýa kartlary bolan tomaşaçylar/nagt pullara bolan ynam.
Vauçerleri satmagyň ösen bölek satuw ulgamy bolan bazarlar.

2) Ekosistema we rollar

Üpjün ediji/shema: talonlary çykarmak, KYC/KYB düzgünleri, antifrod, myNeosurf gapjygy.
Bölek satuw ulgamy: talonlary satmak/gapjyklary doldurmak, PIN bilen çek bermek.
PSP/ekwaýer: söwdany birikdirmek, hosted-kassa/SDK/API, statuslar, hasabatlar we hasaplamalar.
Merçant: tölegi başlaýar, statuslary we yzyna gaýtarmalary gaýtadan işleýär, deňeşdirme geçirýär.
Töleýji: PIN girizýär ýa-da myNeosurf-a girýär we hasapdan çykarylandygyny tassyklaýar.

3) Önümler we ssenariýalar

Neosurf Voucher (PIN): bir ýa-da birnäçe talon bilen tölemek; bölekleýin hasapdan çykarmak we vauçerleriň utgaşmasy (çäkleriň çäginde) goldanylýar.
myNeosurf (gapjyk): balansdan töleg; gaýtadan satyn almak we yzyna gaýtarmak üçin amatly.
Invois/Rau-by-Link: PSP-den PIN girişi/hosted sahypasyndaky gapjyga girişi bolan töleg baglanyşygy.

4) Töleg akymlary

4. 1 Hosted/Redirect (maslahat berilýär)

1. Çek → Neosurf saýla.
2. PSP/üpjün edijiniň hosted sahypasyna redaksiýa → PIN giriň ýa-da myNeosurf giriň → tassyklama.
3. 'status' (success/failed/canceled/pending) we 'paymentId' bilen söwda nokadyna gaýdyp gelmek.
4. Jemleýji karz gündelik reýestrlerde (settlement) görkezilýär.

4. 2 Embedded/Widget

Kassada gurlan PIN/myNeosurf widget. UI/howpsuzlygy we üpjün edijiniň syýasatyny berjaý etmegi talap edýär.

4. 3 Server-to-Server

Söwdanyň esasy tarapy tölegi amala aşyrýar we statusy soraýar; PIN elmydama duýgur maglumatlary saklamazlyk üçin üpjün edijiniň/widgetiň tarapynda girizilýär.

5) Çäkler, KYC we özüni alyp barşy

• Per-transaction, gündelik/hepdelik çäkler.
• Bir tölegli talonlaryň sanyna çäklendirme.
• Geo-çäklendirmeler (talonyň çykarylan ýurdy vs söwdanyň/gapjygyň ýurdy).
• Täze söwdagärler/kategoriýalar üçin - pes çäkler, step-up barlaglar.

6) Statuslar, hasaplaşyklar we yzyna gaýtarmalar

Onlaýn ýagdaýlary: 'success', 'pending', 'failed', 'canceled', 'expired'.
Settlement: PSP/üpjün edijiniň hasabatlary boýunça karz (adatça T + 1/T + 2 iş güni, şertnama boýunça).
Çargeback ýok.
Refunds: aýratyn karz amallary (myNeosurf-da ýa-da ylalaşylan kanal boýunça); partial refunds goldanýar.
Bölekleýin hasapdan çykarmak: galyndy PIN/gapjykda galýar (sazlamaga/sebite baglydyr).

7) Ykdysadyýet we nyrhlar

Nyrhlar, adatça, CNP-kart MDR-den pes, geo/göwrümi/kategoriýasy (oýunlar, sanly hyzmatlar we ş.m.) boýunça üýtgeýär.
Goşmaça çykdajylar: hosted/SDK, sapport we ODR, gaýtadan işlemek 'pending/expired', recon.

8) Kassanyň UX-patternleri

Talony nireden satyn almaly: kartoçka/satuw nokatlaryny gözlemek täze gelenleriň öwrülişigini ýokarlandyrýar.
PIN kombinasiýasy: birnäçe talon goşmak + galyndy görkezmek üçin amatly UI.
Aç-açan ýalňyşlyklar: "nädogry/eýýäm ulanylan PIN", "çäk geçdi", "sebit goldanylmaýar".
Kwitansiýa: jemi, wagt, 'paymentId', usul (PIN/myNeosurf); yzyna gaýtarmak üçin - 'refundId'.
Lokalizasiýa: müşderiniň pul/dil/ýurteksleri.

9) Komplayens we howpsuzlyk

PIN/gapjygy tassyklamak we barlamak - üpjün edijiniň tarapynda (SCA/özüni alyp baryş hasaby).
PII-minimalizasiýa: PIN-i öz öýüňizde işlemäň; hosted/widget ulanyň.
Webhooks: HMAC/nonce, replay goragy, wakalaryň atasy, audit.
KYC/AML/GDPR: öňünden tölenen serişdeler üçin ýaş we çäk talaplary; sanksiýa/geo-çäklendirmeler.

10) Deňeşdirme we hasabat (reconciliation)

Login: 'paymentId', 'orderId', usul (PIN/myNeosurf), walýuta, summa, status, timestamps, bank/maliýe salgylanma (UTR) PSP sanawlaryndan.
Her gün: fin-sanawlary bolan kassa hadysalarynyň auto-recon (hasaplamalar/yzyna gaýtarmalar/düzedişler).
Alertler: "reýestre ýazylmazdan üstünlik", "goşa ýazmak", "uzak wagtlap asylan pending".

11) Merçantyň integrasiýasy

Wariantlar

1. PSP-den hosted/Embedded - çalt başlamak we howpsuzlyk talaplaryna laýyk gelmek.
2. Server-to-Server + Hosted PIN - PIN-i gaýtadan işlemezden statuslara gözegçilik edýärsiňiz.
3. Töleg-by-Link/Invoice - gijikdirilen tölegler we sapport üçin.

• API: `createPayment`, `refund`, `queryStatus`, `webhook`, `reconcile`.
• Idempotentlik ('orderId' + açar), eksponensial retralar, DLQ.
• Kataloglar: ýurtlar/walýutalar, çäkler/KUS-derejeler, ýalňyşlyk kodlary, SLA-metrikler.

12) Abuna ýazylmalar we gaýta-gaýta ýazylmalar

• myNeosurf-y serişde çeşmesi hökmünde ulanmak (rugsat berilse),
• ýa-da shema ilkinji talon → mandat (SEPA/Open Banking) geljekki debetler üçin.
• Ulanyja mandaty dolandyrmagyň ekranyny görkeziň (çäk/ýygylyk/habarnamalar).

13) Antifrod we töwekgelçilik syýasaty

Signallar: geo laýyk gelmezlik (IP/vauçer/merchant), ýygy-ýygydan PIN ýalňyşlyklary, gaýtalanýan synanyşyklar, hasaplaryň şol bir PIN arkaly baglanyşygy.
Mitigisiýa: sessiýa/gije-gündiziň PIN sanyna çäk, cooling-off, kapça/step-up, düşündiriş bilen ýumşak şowsuzlyklar.

14) Ýokary töwekgelçilikli dik (iGaming-i goşmak bilen)

Elýeterliligi, çäkleri we hasabatlylygy üpjün edijiniň/PSP-niň ýurduna we syýasatyna baglydyr.
Azaldylan çäklere, amallara gözegçiligiň güýçlendirilmegine we barlamak talaplaryna garaşyň.
Alternatiw relsleri (beýleki talonlar, A2A, kartoçkalar) we smart-routing saklaň.

15) "Neosurf Gateway" arhitekturasy

API gatlak (REST/GraphQL) kassa/billing.
Wakalaryň nobatlary: statuslar → billing/CRM/analitika/sapport.
Security: vault secrets, IP-allowlist, berk tassyklama redirect-URI, anti-replay tokenleri.
Observability: öwrülişik (PIN vs myNeosurf), 'pending → success/expired', ortaça gizlinlik, bölekleýin/birleşdirilen hasapdan çykarmalaryň paýy, yzyna gaýtaryş metrikleri.

16) Önüme çykarmagyň çek-sanawy

1. PSP kanalyna birikdiriň we Hosted PIN/myNeosurf-i açyň.
2. 'createPayment' web-huk (HMAC), idempotentlik we gaýtalamalary amala aşyryň.
3. Partial yzyna gaýtarmalary, talonlary birleşdirýän ssenarileri we düşnükli ýalňyşlyklary goşuň.
4. Daily auto-recon + döwürleýin full-recon sazlaň; maliýe maslahatlaryny/UTR saklaň.
5. SLA dashbordlary we asylan 'pending', 'failed', geo boýunça anomaliýalara alertler.
6. E2E-synaglar ýurtlar/walýutalar boýunça: birnäçe PIN, bölekleýin yzyna gaýtarmak, möhleti geçen PIN/çäkler.

Ugrukdyryjy kartoçka

Statuslar: 'success/pending/failed/canceled/expired'.
Settlement: Adatça sanawlar boýunça T + 1/T + 2.
Chargeback: ýok; refund - aýratyn karz amaly (bölekleýin rugsat berilýär).
PIN kombinasiýasy: çäkleriň içinde rugsat berilýär.
Rekurrent: myNeosurf ýa-da alternatiw mandat arkaly (ilkinji tölegden soň).

Jemleme

Nagt diňleýjiler we mikro tölegler üçin Neosurf saýlaň: hosted PIN/myNeosurf → çalt we ygtybarly.
Webhooks + recon töweregindäki prosesi guruň, partial refunds we talon kombinasiýasyny saklaň.
Pullary "tikmäň": ýurtlar boýunça çäklendirmeler/KUS konfigidlerini geçiriň we yzygiderli täzeläň.
Abuna ýazylmak üçin - aç-açan dolandyrylýan we habarnamalary bolan ilkinji talon → mandat/myNeosurf.