Nagt talonlar we bölek satuw torlary

1) Bu näme we haçan ulanylmaly

Nagt wançerler we eCash-torlar tölegi bank kartlarsyz we IBAN-syz kabul etmäge mümkinçilik berýär. Ulanyjy öňünden tölenen talony (PIN) satyn alýar ýa-da ştrih-kody/QR (pay-at-store) alýar we sargyt üçin hyzmatdaşyň oflayn nokadynda (kiosk, supermarket, ýangyç guýulýan stansiýa, poçta bölümi) ýa-da internet bankynda/ATM-de töleýär. Pul söwdagäre bank relsleri boýunça PSP/üpjün ediji arkaly gelýär; çarjbek ýok, frod töwekgelçiligi az.

• Sanly harytlar/oýunlar, mazmun, pes/orta çek bilen abuna ýazylmalar.
• Nagt paýy ýokary ýa-da kartyň penetrasiýasy pes bolan sebitler.
• Gizlinligi/öňünden tölemegi halaýan tomaşaçylar.

2) eCash gurallarynyň tipologiýasy

1. PIN-wokerler (öňünden tölenen kodlar):

Mysal üçin: Paysafecard, Neosurf, Flexepin.
UX: 16/10 belgili PIN-i hosted formasyna girizmek ýa-da gapjykdan tölemek (myPaysafe/myNeosurf).
Aýratynlyklary: bölekleýin hasapdan çykarmak, birnäçe PIN-leriň utgaşmasy, galyndy saklanýar.

2. Ştrih-kodlar/QR "Dükanda tölemek" (cash payment barcode):

Mysal üçin: paysafecash, lokal torlar (OXXO Pay - MX, RapiPago/PagoFácil - AR, Efecty/Baloto - CO, PayPoint/Payzone - UK, ePay/Paylink - EU we ş.m.).
UX: satyjy barcode/QR öndürýär → müşderi nagt töleýär → üpjün ediji tassyknama iberýär.
Aýratynlyklary: çek çäkli wagt bilen hereket edýär (expiry), mukdary kesgitlenýär.

3. Reference/Slip for ATM/online-banking (invoys-rekwizitleri):

Mysal üçin: Multibanco References - PT, Konbini - JP.
UX: Kod/referens + pul mukdary, ATM/internet-bankda/hyzmatdaş dükanda töleg çykarylýar.
Aýratynlyklary: iň az girdeji, salgylanma boýunça berk deňeşdirme.

3) Ekosistemanyň gatnaşyjylary

Üpjün ediji/shema (eCash/talonlar): PIN/barkodlary çykarýar, bölek satuw kataloglaryny, KYC/AML, antifrod, API/widjetleri berýär.
PSP/ekwaýer: söwda, hosted-kassa/SDK, statuslar, web-haklar, sanawlar we hasaplamalar birikdirýär.
Bölek satuw/kassa: nagt kabul etmek/barkody okamak, üpjün ediji bilen sinhronlamak.
Bank/kliring: hasaplaşyklar we serişdeleri söwdagäre geçirmek.
Merçant: töleg/invoýs işine başlaýar, statuslary, yzyna gaýtarmalary we reconlary gaýtadan işleýär.

4) Töleg akymlary

4. 1 PIN talon (Hosted/Redirect)

1. Çek → eCash saýlamak (mysal üçin, Paysafecard/Neosurf).
2. Redirect/Hosted üpjün ediji görnüşi → PIN girişi/gapjyga girişi → tassyklama (SCA/özüni alyp barşy).
3. Satyja gaýdyp gelmek: 'success/pending/failed/canceled/expired'.
4. Hakyky karz - gündelik sanawlar boýunça (T + 1/T + 2).

4. 2 Ştrih-kod/QR "dükanda tölemek"

1. Satyjy invoýs döredýär: jemi + barcode/QR + expiry.
2. Müşderi bölek satuw nokadyna gidýär we nagt töleýär → kassa üpjün edijä geleşigi tassyklaýar.
3. Üpjün ediji söwdagäre onlaýn-üstünlik, soňra - sanawlarda karz iberýär (T + 0/T + 1).

4. 3 Reference/Slip (ATM/online-banking/conbiny)

1. Maslahat döretmek (entity/reference/amount) + hereket ediş möhleti.
2. ATM-de/internet-bankda/hyzmatdaş dükanda töleg.
3. Reýestrlerde 'paid' we ondan soňky settlement.

5) Statuslar we hasaplaşyklar

Onlaýn ýagdaýlary: 'created '/' pending '/' success' paid '/' failed '/' canceled '/' expired '.
Settlement: adatça T + 0/T + 2 bank güni (şertnama/kanal boýunça).
Işewürlik logikasynda onlaýn tassyklamany we hakyky karzy bölüň.

6) Çäklendirmeler, KYC we töwekgelçilik

• Per-transaction, 24h/7d, töleg/gün üçin PIN sanyna çäk.
• Täze alyjylar/satyjylar üçin - peseldilen çäkler/çydamlylyk.
• Geo-düzgünler (talonyň ýurdy vs müşderiniň/söwdanyň ýerleşýän ýeri), velocity, devais-signallar.
• Çarjbek ýok; jedeller - üpjün edijiniň/PSP-iň ODR-i boýunça.
• Maslahat: Ýurtlar/torlar/KUS boýunça çäkleri saklaň we summalary hardcoding etmäň.

7) Yzyna gaýtarmak we bölekleýin hasapdan çykarmak

Refund = täze karz amallary (eCash gapjygyna/bank geçirimi - üpjün edijiniň düzgünleri boýunça).
Partial refunds adatça goldanýar.
PIN talonlar üçin köplenç bölekleýin hasapdan çykarmak we PIN kombinasiýasy elýeterlidir; barcode-invoyslar üçin - mukdar kesgitlenildi.

8) Ykdysadyýet we nyrhlar

Söwda üçin komissiýa, adatça, CNP kartoçkasyndan pes, ýöne geo/göwrümi/kategoriýasy boýunça üýtgeýär.
Goşmaça çykdajylar: hosted/SDK, satuw nokatlarynyň mahabaty, sapport/ODR, gaýtadan işlemek 'expired/pending', recon.

9) UX-patternler

PIN-töleg: birnäçe PIN üçin düşnükli UI we galyndy görkezijisi; hatalar barada habarlar: "nädogry/ulanyldy", "çäk geçdi", "sebit goldanylmaýar".
Barcode/QR: uly kod + hereket ediş möhletiniň taýmeri, "çap etmek/messenger/email-a ibermek" düwmesi.
Awtonom töleg görkezmeleri: torlaryň logotipleri bilen 3-4 ädim; iň ýakyn nokatlar/iş wagty kartasy.
Sargytyň ýagdaýy: Awto täzelenme bilen "Tölege garaşýar"; 'expired' - "täze kod döretmek" düwmesi.
Kwitansiýa: jemi, wagt, 'paymentId', kanal (PIN/Barcode/Reference), UTR/ref. reýestrden, sapport aragatnaşyklary.
Lokalizasiýa: pul/dil/salgyt tekstleri, torlaryň ýerli markalary.

10) Howpsuzlyk we laýyklyk

PII-minimalizasiýa: PIN/gapjyk üpjün edijiniň tarapynda girizilýär (Hosted/Widget).
Web-huki: HMAC/nonce, replay goragy, wakalar, audit magazineurnaly.
KYC/AML/GDPR: öňünden tölenen serişdeler üçin ýaş/çäk düzgünleri, sanksiýa/geo-çäklendirmeler.
Antifrod: enjam/sessiýalar boýunça çäkler, cooling-off, step-up, gaýtalanýan PIN/barkodlara gözegçilik.

11) Integrasiýa we binagärlik

Baglanyşyk wariantlary

1. PSP/üpjün edijide hosted/Embedded - çalt başlamak, duýgur maglumatlar üçin iň az jogapkärçilik.
2. Server-to-Server + Hosted - status gözegçiligi bilen, PIN-i gaýtadan işlemezden öz hasabyňyz.
3. Pay-by-Link/Invoice - baglanyşyk tölegleri we sapport ýagdaýlary.

Arka minimum

API: `createPayment|createInvoice` (amount + expiry), `refund`, `queryStatus`, `webhook`, `reconcile`.
Idempotentlik ('orderId' + açar), eksponensial retralar, DLQ, web-huklaryň dedupy.
Kataloglar: ýurtlar/torlar/çäkler/KUS-derejeler, ýalňyşlyk kodlary, kanallar boýunça SLA-metrikler.
Observability: konwersiýa (PIN vs Barcode/Reference), pending → expired 'paýy ,/settlement, geo-anomaliýalara çenli ortaça wagt.

12) Geografiki bellikler (görkezmeler)

Европа: Paysafecard, paysafecash, Neosurf, PayPoint/Payzone (UK), ePay/Paylink (EU), Multibanco (PT).
ЛатАм: OXXO Pay (MX), RapiPago/PagoFácil (AR), Efecty/Baloto (CO).
Aziýa: Konbini (JP) we lokal torlar (FamilyMart/Lawson/7-Eleven).

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

1. Üpjün ediji/PSP we maksatly torlary (PIN/Barcode/Reference) saýlaň, nyrhlary/SLA/settlement bilen ylalaşyň.
2. 'createPayment' createInvoice '-ni expiry, görkezme sahypalary we fallback ssenarileri bilen durmuşa geçiriň.
3. Webhooks (HMAC), idempotentlik, retrailer we wakalar baby birikdiriň.
4. Gündelik awto-recon + full-recon guruň, UTR/maliýe maslahatlaryny saklaň.
5. Partial refunds, ODR-proseduralary we şowsuzlyklar/çäklendirmeler barada düşnükli habarlary goşuň.
6. SLA dashbordlaryny (öwrülişik, 'expired', töleg/settlement) we rasinhronlaryň aladalaryny açyň.
7. e2e-synaglary geçiriň: birnäçe PIN, möhleti geçen ştrih-kod, nädogry mukdar, goşa töleg, bölekleýin yzyna gaýtarmak.

Ugrukdyryjy kartoçka

Статусы: `created/pending/success|paid/failed/canceled/expired`.
Settlement: PSP/üpjün edijiniň sanawlary boýunça adatça T + 0-T + 2.
Çargeback: ýok; refund - aýratyn karz amaly.
Çäklendirmeler/KUS: müşderiniň ýurduna/toruna/kanalyna we profiline bagly.
Rekurrent: Indiki hasapdan çykarmak üçin ilkinji eCash → mandat (SEPA/Open-Banking/lokal).

Gysgaça maglumat

Strategiýa: Nagt diňleýjileri gurşap almak we MDR azaltmak üçin eCash-mix (PIN + barcode/QR + reference).
Webhooks + recon töweregindäki binagärlik, berk idempotentlik we düşnükli UX 'pending/expired'.
Çäkleriň we geo-düzgünleriň konfigurasy - koddan daşary, yzygiderli täzelenýän.
Abuna ýazylmak üçin - ilkinji eCash → mandat, aç-açan dolandyryş we ulanyjy üçin habarnamalar.