Bancontact Belgiýa: kartlar we A2A

1) Ekosistem: Bancontact we Payconiq

Bancontact - güýçli kart komponenti (debet kartlary, köplenç Maestro/Debit Mastercard bilen co-badge) we e-commerce/POS/NFC goldawy bilen Belgiýanyň milli nagt däl töleg shemasy.
Payconiq by Bancontact - onlaýn we awtonom görnüşde giňden ulanylýan A2A/ykjam tölegler gatlagy ("telefona" QR/App2App/P2P).

• Iki sany rels: kartoçka (card rails) we bank A2A (Payconiq).
• Kassadaky ýeke-täk marka: Bancontact/Payconiq nyşany ulanyja tanalýar we öwrenişýär.
• SCA/PSD2: bankda/programmada tassyklama, pes frod.
• Onlaýn tassyklamalar we çalt hasaplaşyklar (aşakda serediň).

2) Rollar we gatnaşyjylar

Bancontact/Payconiq shemasy: düzgünler, sertifikatlaşdyrmak, marşrut.
Issuer (töleýjiniň banky): kartyň we/ýa-da Payconyk hasabynyň emitenti, çäklendirmeler we antifrod.
Acquirer/PSP: söwdany birikdirýär (kart/A2A), API/SDK, hasabatlary we hasaplamalary berýär.
Merçant: tölegi başlaýar, statuslary/yzyna gaýtarmalary gaýtadan işleýär, deňeşdirme geçirýär.

3) Kanallar we flow

3. 1 Bancontact kartoçkasy (POS/e-commerce/NFC)

POS/NFC: terminal boýunça nusgawy debet tölegi; emitentiň sazlamalaryna görä awtonom/onlaýn ygtyýarnama.
E-commerce (CNP): PSP hosted-sahypa/widget, SCA tassyklamasy (3DS-meňzeş flow).
Co-badge: Halkara programmasy (Maestro/Debit MC) bar bolsa, terminal/PSP ugry saýlaýar.

3. 2 Payconiq (A2A: QR/App2App/Link)

QR per-order: söwda dinamiki QR döredýär (jemi + orderId); ulanyjy Payconiq/bank programmasy bilen skanerleýär → tassyklaýar → satyjy onlaýn status alýar.
App2App/Deeplink: söwda web/programmasyndan töleg geçirilende derrew bank programmasy açylýar.
Pay-by-Link: email/SMS/messengerdäki invoýs/baglanyşyk.
P2P "telefona": aragatnaşyk belgisi boýunça ulanyjylaryň arasynda geçirimler.

3. 3 Awtonom ssenariler

Statiki QR (merçantlar üçin seýrek) - el bilen jemlenen, donatlar/mikro tölegler üçin amatly.
SoftPOS: smartfonlarda/Payconiq kartlaryny kabul etmek (bu ýerde goldanýar).

4) Banklaryň çäkleri we özüni alyp barşy

• Per-transaction/per-day/week kartoçka üçin we Payconiq üçin aýratyn.
• Täze alyjy/täze satyjy - peseldilen çäkler/çydamlylyk.
• Kanal/velocity-düzgünleri: ykjam vs web, geo/enjam, amallaryň ýygylygy.
• P2P/QR/NFC aýratyn mikrolimitleri bolup biler.

5) Statuslar we hasaplaşyklar

Kartlar (Bancontact card)

Onlaýn ýagdaýy: 'authorized/approved', 'declined', 'referred', 'timeout'.
Settlement: adatça T + 1/T + 2 bank güni ekwaýer arkaly; düzedişler/reversallar bolup biler.
Çargeback: kartoçka düzgünleri boýunça elýeterlidir (möhletler/kodlar, subutnamalar).

Payconiq (A2A)

Onlaýn ýagdaýy: 'success', 'pending', 'failed', 'canceled', 'expired'.
Settlement: çalt bank karzy (köplenç T + 0/T + 1, banka/PSP bagly).
Çargeback ýok: yzyna gaýtarmak - söwdanyň töleýjä täze karz amalydyr (partial refunds goldanýar).

6) Nyrhlar we ykdysadyýet

Kartiki rels: MDR-iň ekwaýýer üçin fix/göterimi + PSP-den 3DS/SCA-çykdajylary.
Payconiq (A2A): adatça MDR kartlaryndan pes; QR/widget/hasabat üçin ýygymlar bolup biler.
Goldawyň bahasyny/ODR, 'pending/expired' we recon bilen işlemek.

7) Yzyna gaýtarmalar we jedeller

Kart: kart düzgünleri boýunça chargeback-proseduralary; proof-of-delivery/hyzmatlary, SCA magazinesurnallaryny saklaň.
A2A: çarjbek ýok, aýratyn amal hökmünde refund (full/partial) ediň; möhletler T + 0/T + 1/T + 2 banka baglylykda.

8) Howpsuzlyk we gabat gelmek

PSD2/SCA/goşundyda; device binding we emitentiň antifrody.
PII-minimallaşdyrmak, web-huklary şifrlemek, HMAC/nonce, replay goragy, audit magazineurnaly.
GDPR: saklamak aç-açanlygy we talap boýunça maglumatlary aýyrmak (DSAR).

9) UX-patternler

Smart-routing: pes komissiýa üçin Payconiq (A2A) hödürläň; fallback - kartoçka.
Mobile-first: ykjam traffikde - App2App; iş stolunda - QR/redirect.
Çekler: jemi, senesi/wagty, 'transactionId', kanal (Card/Payconiq), UTR/maslahat, sapport aragatnaşyklary.
Idempotentlik: 'orderId' + açar, wagt geçirilende howpsuz gaýtalanmalar.
Recovery: 'pending/expired' - usulyň alternatiwasy.

10) Merçantyň integrasiýasy

Wariantlar

1. PSP-den hosted/Embedded (kart + Payconiq): çalt başlamak, taýýar widjetler, statuslar we ýalňyşlyklar.
2. Server-to-Server + Redirect/App2App/QR: UX-a doly gözegçilik etmek, kanalyň öz saýlamagy, dinamiki QR per-order.
3. Pay-by-Link/Invoice: email/SMS/messenger hasaby (esasanam B2B/hyzmatlar üçin).
4. POS/SoftPOS: bölek satuwda kartlary/NFC we Payconiq-QR kabul etmek.

• API: `createPayment`, `refund`, `webhook`, `queryStatus`, `reconcile`.
• Webhooks (HMAC, retrai, dedup), idempotentlik tablisasy.
• Recon: daily auto-recon + döwürleýin full-recon; UTR/maliýe-maslahatlaryny saklamak.
• Dashbordlar SLA: kanallar boýunça öwrülişik, 'pending → success/expired', settlemente çenli gizlinlik.

11) Rekurrent we mandatlar

Kart: ilkinji töleg + MIT-de SCA bilen nusgawy tokenli debet (network tokens/COF).
A2A: e-mandate/SEPA DD/açyk banking mandatlary arkaly: ilkinji töleg → indiki hasapdan çykarmak üçin mandat (limit/ýygylyk/habarnamalar).

12) Ýokary töwekgelçilikli dikuçarlar (iGaming-i goşmak bilen)

Belgiýada berk düzgünleşdirmek: kanallaryň we çäkleriň elýeterliligi PSP/Bank we ýerli hukuklara baglydyr.
Azaldylan çäklere garaşyň, giňeldilen KUS/gözegçilik, mümkin bolan hold's.
Alternatiw relsleri (kartoçka, SEPA, beýleki ERBET) we töwekgelçilikli profil boýunça marşrutlary meýilleşdiriň.

13) "Bancontact/Payconiq Gateway" arhitekturasy

Kassa we arka ofis üçin API gatlak (REST/GraphQL).
Wakalaryň nobatlary: status-wakalar → billing/CRM/analitika.
Gizlinlik: gizlinlik üçin vault, IP-allowlist PSP, berk tassyklama redirect-URI, anti-replay.
Ygtybarlylygy: eksponensial retralar, durnuksyz statuslar üçin DLQ, idempotentlik.
Maglumatlar: banklaryň/çäkleriň/ýalňyşlyk kodlarynyň kataloglary; ODR žurnaly we mandat kartasy.

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

1. PSP + Payconiq kartyny saýlaň; nyrhlary/SLA ylalaşyň.
2. "createPayment" -i "mobile/offline" üçin App2App/QR kanal saýlap alyň.
3. Webhooks, wagtlar, gaýtalanmalar we idempotentlik birikdiriň.
4. recon (daily + full), UTR/maliýe salgylanmalaryny saklamak.
5. Partial/full refunds, sapportda ODR amallaryny goldaň.
6. Smart-routing (A2A ileri tutulýan, kart - fallback), öwrülişik/gizlinlik aladalaryny açyň.
7. Banklary/ykjam platformalary/POS-lary e2e synaglary bilen ýapyň.

Ugrukdyryjy kartoçka

Kartyň ýagdaýy: 'authorized/approved', 'declined', 'timeout'.
Статусы A2A: `success`, `pending`, `failed`, `canceled`, `expired`.
Settlement: kart T + 1/T + 2, A2A köplenç T + 0/T + 1.
Çäkleri: per-txn/day/week; täze alyjylar üçin - pes çäkler.
Jogap: e-mandate/SEPA DD arkaly kart (COF/MIT) ýa-da A2A.

Gysgaça maglumat

Kassanyň hereketlendirijisini iki relsde gurýarys: arzan bahaly Payconiq-A2A we ähliumumy fallback hökmünde Bancontact kartasy.
Iş logikasynda onlaýn tassyklamany we settlementi paýlaşýarys, partial refunds we anyk ODR-i goşýarys.
Pul mukdaryny düzetmeýäris: banklar/kanallar boýunça çäklendirmeleri we yzygiderli täzelenmegi goldaýarys.
Mobaýl üçin - App2App/QR, bölek satuw üçin - NFC + dinamiki QR, abuna ýazylmak üçin - ilkinji töleg → mandat.