Multibanco Portugaliya: vaucherlar va reflar

1) Multibanco konteksti va joylashuvi

• MB References (Pagamento de Servichos/Compras): ATM yoki homebankingda invoyslarni to’lash uchun Entidade + Referência + Valor turining to’lov rekvizitlari.
• MB Voucher/MB Cash at ATM: «vaucher» stsenariysi - xaridor kod/yo’riqnoma oladi va ATMda yoki internet-bankda to’laydi; sotuvchi PSPdan onlayn tasdiqnoma va keyingi bank kreditini oladi.

O’ziga xos xususiyatlari: juda past frod, bank o’tkazmasi kabi yakuniy (charjback yo’q), ATM/homebanking orqali to’lashga odatlangan foydalanuvchilar uchun qulaylik.

2) Rekvizitlarning atamalari va formati

Entidade (Entity/Service code) - SIBS tizimidagi oluvchining kodi (odatda 5 raqam).
Referência (Reference) - hisob/buyurtmaning 9 raqamli noyob identifikatori.
Valor (Amount) - to’lanadigan summa (qat’iy belgilangan) yoki «ochiq» (agar PSP/merchantda shunday sozlangan bo’lsa).

3) Ishtirokchilar

SIBS/Multibanco (sxema/svitch) - MB to’lovlarini yo’naltirish va kliring.
To’lovchining banki - ATM/homebanking taqdim etadi, limitlarni/antifrodni qo’llaydi.
PSP/Acquirer - References/vaucherlarni API/panel orqali beradi, webhooks va reyestrlarni yuboradi, hisob-kitoblarni amalga oshiradi.
Merchant - hisobni yaratadi (Entity/Reference/Amount), maqom/hisoblarni oladi, qaytarishlarni amalga oshiradi.

4) Oqimlar va kanallar

4. 1 MB References (ATM/homebanking orqali invoyslar)

1. Merchant/PSP Entidade + Referência + Valor + Expiry yaratadi va ularni chekautda koʻrsatadi (va/yoki email/SMS orqali yuboradi).
2. Mijoz ATMda yoki o’zining internet-bankida to’laydi → operatsiyani tasdiqlaydi.
3. PSP onlayn-maqom (paid/pending/expired va h.k.) va so’ngra - fin-reyestrlardagi harakatni (settlement) sotuvchiga beradi.

• Dinamik Reference per-order (tavsiya etilgan).
• Statik Reference (donorlar/hamyonlar uchun) - ko’pincha murakkab taqqoslashga olib keladi, ehtiyotkorlik bilan foydalaning.

4. 2 MB Voucher (cash at ATM / pay-code)

Sotuvchi PSP orqali «kvazi-vaucher »/to’lov kodini (aslida - qisqa yashaydigan Reference) ishlab chiqaradi.
Mijoz ATM yoki homebankingga boradi va to’lovni → PSP kodi bo’yicha amalga oshiradi.
Ko’pincha high-risk/naqd pul stsenariylarida va kartasiz mijozlar uchun ishlatiladi.

4. 3 MB-invoys uchun MB WAY orqali to’lov

Ba’zi PSPlarda flou mavjud: mijoz MB-Reference to’lovini MB WAY (hamyon) orqali to’laydi. Bu tasdiqlashni tezlashtiradi va mobildagi konversiyani oshiradi.

5) Maqomlar va hisob-kitoblar

• `created` → `pending` → `paid` / `expired` / `canceled` / `failed`.

Settlement: bank krediti T + 0/T + 1 (bank oynalariga/PSPga bog’liq). Hatto buxgalteriyada bir zumda onlayn tasdiqlansa ham, kundalik registrlarga tayaning.

Qisman toʻlovlar: andoza (belgilangan Valor uchun). «Ochiq summa» qisman ruxsat beradi, lekin bu solishtirishni murakkablashtiradi - faqat ongli ravishda kiriting.

6) Limitlar va tavakkalchilik siyosati

• Per-transaction / per-day/24h; baʼzan weekly/monthly.
• Yangi oluvchilar/sotuvchilar uchun qattiqroq chegaralar.
• Kanal farqlari: ATM vs homebanking; ba’zi banklarda turli oynalar/ostonalar mavjud.
• Velocity/devays/geo-signallar bank/PSP tomonida.

7) Iqtisodiyot va komissiyalar

Qabul qilish narxi odatdagi MDR kartasidan past; shartlar - PSPda.
invoys-tarqatish, qayta ishlash’expired/pending’, sapport va recon xarajatlarini hisobga oling.

8) Qaytarishlar va munozaralar

Chargeback (xaritalarda boʻlgani kabi) mavjud emas.
Qaytarish yangi kredit operatsiyasi sifatida (odatda SEPA Credit Transfer) mijozning IBAN yoki MB WAY hamyoni orqali (agar shunday kelishilgan bo’lsa) amalga oshiriladi.
Bek-ofisda partial refundsni qoʻllab-quvvatlang; ’refund original reference’ bogʻlamini saqlang.

9) Xavfsizlik va muvofiqlik

To’lovni tasdiqlash to’lovchining bankida (ATM/online-banking) amalga oshiriladi → past frod.
GDPR/PII minimallashtirish: faqat kerakli atributlarni (Entity/Ref/Amount, mijoz niqoblari) saqlang.
Veb-xuklar - HMAC/nonce, replay himoyasi, hodisa dedupi, audit jurnali.
Banco de Portugal talablari va SIBS/PSP shartnomaviy shartlarini hisobga oling.

10) Solishtirish va hisobot (recon)

• ’entity’ (Entidade),’reference’(9-digit),’amount’(valor),’orderId’,’status’,’paidAt’,’channel’(ATM/homebanking/MB WAY),’pspTxnID’, bank reyestrlardan referensiya/UTR.
• Har kuni: PSP/SIBS reyestrlari bo’yicha auto-recon (o’tkazish/qaytarish/tuzatish) + davriy full-recon.
• «Onlayn muvaffaqiyat bor, reyestrda yozuv yo’q», «bitta Ref uchun ikki baravar to’lov», «noto’g’ri summa» deb aytiladi.

11) UX-patternlar (foydalanuvchiga nimani ko’rsatish kerak)

Katta maydonlar: Entidade/Referência/Valor + muddat (expiry) va taymer.
Har bir maydon uchun nusxa olish tugmalari; Tafsilotlar toʻplami tikilgan QR (agar PSPni qoʻllab-quvvatlasa).
3-4 qadam bilan «Qanday qilib ATM/Internet-bankda to’lash kerak» yo’riqnomasi.
Buyurtmaning maqomi «To’lovni kutmoqda» va fon yangilanishi. ’expired’ - bir marta bosish orqali «yangi referans yaratish».
Tasdiqlangandan so’ng:’entity’,’reference’,’paidAt’,’UTR’va safport aloqalari bilan chek.

12) Merchant integratsiyasi

Variantlar

1. Hosted/Embedded PSP - tezkor boshlash, References avto-generatsiyasi, webhooks va tushirish.
2. Server-to-Server - o’zining chekaut/invoyslari, per-order dinamik referensiyalari, kastom amal qilish muddati.
3. Pay-by-Link - elektron pochta/SMS/messenjerlar orqali rekvizitlari bo’lgan havolalarni jo’natish.

• API: `createReference` (entity/ref/amount/expiry), `cancelReference`, `refund`, `webhook`, `reconcile`.
• Idempotentlik (’orderId’bo’yicha), statuslar uchun eksponensial retrajlar, kirish veb-xuklarining dedupe.
• Kataloglar: banklar/limitlar, xato kodlari, SLA-metrika (ATM vs homebanking), tugash kartasi.

13) MB WAY va obunalar

Bazaviy MB References/vaucherlar - bankda tasdiqlangan holda one-off.
Qayta hisobdan chiqarish uchun: birinchi to’lov → e-mandate/SEPA Direct Debit yoki MB WAY-mandatlar (agar PSPda mavjud bo’lsa), limitlar va bildirishnomalar bilan bog’lanishdan foydalaning.

14) High-risk vertikal (shu jumladan iGaming)

Multibanco tez-tez qo’llaniladi, lekin shartlar/limitlar PSP/banklar va mahalliy huquqqa bog’liq.
Past chegaralar, kengaytirilgan KYC va mumkin bo’lgan holdlarni kuting.
Muqobil relslarni (xaritalar, MB WAY, SEPA va boshqalar) va smart-routingni rejalashtiring.

15) «Multibanco Gateway» arxitekturasi

Kassa/invoys-servis uchun API-qatlam (REST/GraphQL).
Voqealar navbatlari: status-events → billing/CRM/analitika.
Security: sirlar uchun vault, IP-allowlist PSP, qattiq callback-URL validatsiyasi, anti-replay.
Observability: konversiya’created → paid’, ulush’expired’, to’lovga qadar o’rtacha vaqt, ATM vs homebanking, SLA veb-xuqlar/reyestrlar bo’yicha.

16) Ishlab chiqarishga olib chiqish chek-varaqasi

1. PSP’ni MB References/Voucher bilan ulash; settlement muddatlari va reyestrlar formatini kelishib oling.
2. ’createReference’ (dinamik, expiry) va koʻrsatma sahifalarini (ATM/homebanking) amalga oshiring.
3. Webhooks, idempotent, retray, dedup.
4. Daily auto-recon + full-recon, UTR va auditni saqlash.
5. Partial/full refunds (SEPA/MB WAY), ODR reglamentlarini kiriting.
6. SLA dashbordlarini va’expired’, rasinxron, summa xatolari bo’yicha alertlarni quring.
7. Top-banklardan ATM/homebanking e2e-testlarini, veb-xuk tayminglarini va haddan tashqari holatlarni (muddati o’tgan ref, ikki baravar to’lov) haydang.

Mo’ljallar kartochkasi

Статусы: `created/pending/paid/expired/canceled/failed`.
Settlement: koʻproq T + 0/T + 1.
Qisman toʻlovlar: andoza (belgilangan summa uchun).
Qaytarish: SEPA SCT/MB WAY hamyoni yangi kredit operatsiyasi sifatida.
Rekurrent: e-mandate/SEPA DD orqali (birinchi to’lov → mandat).

Xulosa

invoyslar/kechiktirilgan to’lovlar uchun MB References dan foydalaning dinamik ref va expiry; naqd pul/ATM auditoriyasi uchun - MB Voucher.
Jarayonni webhooks + SIBS reyestrlari, aniq solishtirish va boshqariladigan qaytarmalar (SCT/MB WAY) atrofida quring.
Banklar/kanallar bo’yicha limitlar konfiguratsiyasini saqlang,’expired’va tasdiqlash tayminglarini kuzating.
Obuna uchun - shaffof boshqaruv va bildirishnomalarga ega birinchi MB → mandat (SEPA/MB WAY).