GH GambleHub

Multibanco Portugalia: Vouchers and refers

1) Kontekst multibanco i pozycjonowanie

Multibanco (MB) jest krajową infrastrukturą płatniczą Portugalii obsługiwaną przez SIBS, łączącą bankomaty, bankowość internetową i lokalne usługi płatnicze. Istnieją dwa najbardziej przydatne narzędzia do handlu elektronicznego/kont:
  • Referencje MB (Pagamento de Serviços/Compras): szczegóły płatności formularza Entidade + Referência + Valor za zapłatę faktur w bankomacie lub homebanking.
  • MB Voucher/MB Cash w bankomacie: scenariusz „voucher” - kupujący otrzymuje kod/instrukcję i płaci w bankomacie lub w banku internetowym; handlowiec otrzymuje potwierdzenie online od dostawcy usług płatniczych oraz kolejny kredyt bankowy.

Funkcje: bardzo niskie oszustwa, finalność jak przelew bankowy (bez obciążenia zwrotnego), wygoda dla użytkowników, którzy są przyzwyczajeni do płacenia za pośrednictwem bankomatu/banku domowego.

2) Warunki i format szczegółów

Entidade (Kod podmiotu/usługi) - kod odbiorcy w systemie SIBS (zwykle 5 cyfr).
Referência (Reference) - 9-cyfrowy niepowtarzalny identyfikator faktury/zamówienia.
Valor (Kwota) - kwota płatna (stała) lub „otwarta” (jeśli tak skonfigurowana w PSP/handlowcu).

💡 Praktyka: w handlu elektronicznym należy użyć stałej wartości i wygaśnięcia - to upraszcza pojednanie i zmniejsza błędy.

3) Uczestnicy

SIBS/Multibanco (program/przełącznik) - routing i rozliczanie płatności MB.
Bank płatnik - zapewnia ATM/homebanking, stosuje limity/przeciwdziałanie oszustwom.
PSP/Acquirer - wydania Referencje/kupony za pośrednictwem API/panelu, wysyła haki i rejestry, prowadzi obliczenia.
Handlowiec - generuje konto (jednostka/referencja/kwota), otrzymuje statusy/kredyty, zwraca.

4) Przepływy i kanały

4. 1 MB Referencje (faktury za pośrednictwem ATM/homebanking)

1. Handlowiec/PSP tworzy program Entidade + Referência + Valor + Expiry i pokazuje je na realizacji transakcji (i/lub wysyła je pocztą e-mail/SMS).
2. Klient płaci w bankomacie lub w swoim banku internetowym → potwierdza transakcję.
3. PSP przekazuje status online (płatny/oczekujący/wygasły itp.) handlowcowi, a następnie ruch w rejestrach płetw (rozliczenie).

Opcje:
  • Dynamiczne odniesienie na zamówienie (zalecane).
  • Odniesienie statyczne (dla darowizn/portfeli) - częściej prowadzi do złożonego pojednania, ostrożnie używać.

4. 2 MB Voucher (gotówka w bankomacie/kod płatny)

Handlowiec generuje „quasi-voucher „/kod płatności (zasadniczo krótkotrwałe odniesienie) za pośrednictwem PSP.
Klient idzie do bankomatu lub homebanking i płaci kodem → PSP raporty online sukces.
Często stosowany w scenariuszach wysokiego ryzyka/gotówki i dla klientów bez kart.

4. 3 Płatność za pośrednictwem MB WAY za fakturę MB

W niektórych PSP dostępny jest przepływ: klient płaci za rozładowany MB-Reference przez MB WAY (portfel). Przyspiesza to potwierdzenie i zwiększa konwersję na telefonie komórkowym.

5) Statusy i obliczenia

Statusy online (PSP może różnić się nazwą):
  • „zakreślony” → „oczekujący” → „płatny ”/„ wygasł ”/„ odwołany ”/„ nieudany”.

Rozrachunek: kredyt bankowy T + 0/T + 1 (zależy od okien bankowych/PSP). Nawet z natychmiastowym potwierdzeniem online w księgowości, polegać na dziennych rejestrów.

Częściowe płatności nie są domyślnie dozwolone (dla stacjonarnego Valora). „Otwarta kwota” pozwala na częściowe, ale to komplikuje pojednanie - obejmują tylko świadomie.

6) Limity i polityka ryzyka

Nie ma jednego pułapu „obwodu” - mają zastosowanie ustawienia banku płatnika i PSP:
  • Per-transaction/per-day/24h; czasami co tydzień/miesiąc.
  • Zaostrzenie progów dla nowych odbiorców/handlowców.
  • Różnice kanału: ATM vs homebanking; niektóre banki mają różne okna/progi.
  • Prędkość/urządzenie/sygnały geo po stronie banku/PSP.
💡 Praktyka: Nie hardcode kwoty. Wprowadź katalog limitów przez bank/kanał, zaktualizuj go, a w interfejsie użytkownika pokaż wyraźny powód odmowy („limit bankowy/kanał”).

7) Ekonomia i prowizje

Koszt odbioru jest niższy niż typowy MDR karty; warunki - w PSP.
Należy rozważyć koszty faktury, „wygasły/oczekujący” przetwarzanie, wsparcie i zwrot.

8) Zwroty i spory

Brak obciążenia zwrotnego (jak w kartach).
Zwrot pieniędzy odbywa się jako nowa transakcja kredytowa (zazwyczaj SEPA Credit Transfer) na IBAN klienta lub poprzez portfel MB WAY (jeśli tak uzgodniono).
wsparcie częściowych refundacji na zapleczu; przechowywać pakiet „zwrot” oryginalny numer referencyjny.

9) Bezpieczeństwo i zgodność

Potwierdzenie płatności odbywa się w banku płatnika (bankomat/bankowość internetowa) → niskie oszustwa.
Minimalizacja RODO/PII: przechowywać tylko niezbędne atrybuty (Entity/Ref/Amount, maski klienta).
Haki internetowe - HMAC/nonce, ochrona przed powtórzeniem, dedup zdarzeń, dziennik audytu.
Rozważmy wymogi Banco de Portugal i warunki umowne SIBS/PSP.

10) Pojednanie i sprawozdawczość (zwiad)

Dziennik dla każdej płatności:
  • „wartość” (Entidade), „odniesienie” (9-cyfrowe), „kwota” (valor), „ Id',” status „,” At „,” kanał „(ATM/homebanking/MB WAY),” pspTxnId', odniesienie bankowe/UTR z rejestrów.
  • Codziennie: auto-recon przez rejestry PSP/SIBS (kredyty/zwroty/korekty) + okresowy pełny zwiad.
  • Alerty do synchronizacji: „nie ma sukcesu online, nie ma wpisu do rejestru”, „podwójna płatność jednego Ref”, „nieprawidłowa kwota”.

11) Wzory UX (co pokazać użytkownikowi)

Duże marginesy: Entidade/Referência/Valor + termin (wygaśnięcie) i timer.
Kopiowanie przycisków dla każdego pola; QR z hardcoded zestaw szczegółów (jeśli PSP obsługuje).
Instrukcje „Jak płacić w bankomacie/bankowości internetowej” z 3-4 krokami.
Status zamówienia Oczekująca płatność i aktualizacja tła. Za pomocą 'expired' - 'create a new reference' w jednym kliknięciu.
Po potwierdzeniu: sprawdź za pomocą 'podmiotu', 'referencji', ' At', 'UTR' i obsługi kontaktów.

12) Integracja handlowców

Opcje

1. Hosted/Embedded w PSP - szybki start, automatyczna generacja referencji, haków internetowych i przesyłek.
2. Serwer-serwer - własna realizacja transakcji/faktury, dynamiczne referencje na zamówienie, niestandardowa data wygaśnięcia.
3. Pay-by-Link - wysyłanie linku ze szczegółami przez e-mail/SMS/komunikatory błyskawiczne.

Minimum obowiązkowe oparcia:
  • API: „Z” (podmiot/ref/kwota/wygaśnięcie), „anulować odniesienie”, „zwrot”, „hak internetowy”, „pogodzić”.
  • Idempotencja (przez ' Id'), przekładnie wykładnicze statusów, dedupe przychodzących haków internetowych.
  • Katalogi: banki/limity, kody błędów, mierniki SLA (ATM vs homebanking), karta wygaśnięcia.

13) MB WAY i subskrypcje

Podstawowe referencje/kupony MB - jednorazowe z potwierdzeniem od banku.
W przypadku powtarzających się odpisów użyj pakietu: pierwsza płatność → e-mandat/polecenie zapłaty SEPA lub bilety MB WAY (jeśli są dostępne w PSP), z limitami i powiadomieniami.

14) Piony wysokiego ryzyka (w tym iGaming)

Multibanco jest często stosowane, ale terminy/limity zależą od PSP/banków i prawa lokalnego.
Spodziewaj się obniżonych progów, przedłużonego KYC i możliwych uchwytów.
Planowanie alternatywnych szyn (mapy, MB WAY, SEPA, inne PIS) i inteligentnych tras.

15) architektura Multibanco Gateway

Warstwa API (REST/GraphQL) do obsługi biurka/faktury.
Kolejki wydarzeń: zdarzenia stanu → rozliczenie/CRM/analityka.
Bezpieczeństwo: skarbiec dla tajemnic, IP-permlist PSP, ścisła walidacja URL-callback, anty-replay.
Obserwowalność: konwersja „created → paid”, udział „expired”, średni czas do płatności, ATM vs homebanking, SLA przez haki/rejestry internetowe.

16) Lista kontrolna wyjściowa

1. Podłącz PSP z referencjami MB/Voucher; uzgadnia termin rozliczenia i format rejestrów.
2. Wdrożyć strony instrukcji (dynamiczne, z wygaśnięciem) i instrukcji (ATM/homebanking).
3. Podłącz haki, idempotencję, retrai, deadup.
4. Konfiguracja codziennego auto-recon + full-recon, UTR storage, i audyt.
5. Włącz częściowe/pełne refundacje (SEPA/MB WAY), przepisy ODR.
6. Budować deski rozdzielcze SLA i wpisy przez 'expired', z synchronizacji, sumy błędów.
7. Uruchom testy ATM/homebanking e2e z najlepszych banków, terminów haków internetowych i skrajnych przypadków (wygasły ref, podwójna płatność).

Karta orientacyjna

💡 Progi i terminy banku/PSP; nie mocno naprawić ich w kodzie.

Статса: „created/pending/paid/expired/canceled/failed”.
Rozrachunek: częściej T + 0/T + 1.
Płatności częściowe: brak niewykonania zobowiązania (dla ustalonej kwoty).
Zwrot: portfel SEPA SCT/MB WAY jako nowa transakcja kredytowa.
Powtórzenie: poprzez e-mandat/SEPA DD (pierwsza płatność → mandat).

Podsumowanie

W przypadku faktur/odroczonej płatności należy użyć MB References z dynamicznym ref i wygaśnięciem; dla odbiorców gotówki/bankomatów - MB Voucher.
Zbuduj proces wokół rejestrów webhooks + SIBS, wyczyść uzgodnienia i zarządzane zwroty (SCT/MB WAY).
Zachowaj konfiguracje limitu przez bank/kanał, monitor 'expired' i czas potwierdzenia.
W przypadku subskrypcji, pierwszy MB → bilet (SEPA/MB WAY) z przejrzystym zarządzaniem i powiadomieniami.

Contact

Skontaktuj się z nami

Napisz do nas w każdej sprawie — pytania, wsparcie, konsultacje.Zawsze jesteśmy gotowi pomóc!

Telegram
@Gamble_GC
Rozpocznij integrację

Email jest wymagany. Telegram lub WhatsApp są opcjonalne.

Twoje imię opcjonalne
Email opcjonalne
Temat opcjonalne
Wiadomość opcjonalne
Telegram opcjonalne
@
Jeśli podasz Telegram — odpowiemy także tam, oprócz emaila.
WhatsApp opcjonalne
Format: kod kraju i numer (np. +48XXXXXXXXX).

Klikając przycisk, wyrażasz zgodę na przetwarzanie swoich danych.