GH GambleHub

Multibanco Portekiz: Kuponlar ve refs

1) Multibanco bağlamı ve konumlandırma

Multibanco (MB), ATM'leri, çevrimiçi bankacılığı ve yerel ödeme hizmetlerini birleştiren SIBS tarafından işletilen Portekiz'in ulusal ödeme altyapısıdır. E-ticaret/hesaplar için en kullanışlı iki araç vardır:
  • MB Referansları (Pagamento de Serviços/Compras): ATM veya homebanking faturaların ödenmesi için form Entidade + Referência + Valor ödeme detayları.
  • ATM'de MB Kupon/MB Nakit: "Kupon" senaryosu - alıcı kodu/talimatı alır ve ATM'de veya İnternet bankasında ödeme yapar; Satıcı, PSP'den çevrimiçi bir onay ve ardından bir banka kredisi alır.

Özellikler: Çok düşük dolandırıcılık, banka havalesi gibi kesinlik (geri ödeme yok), ATM/homebanking yoluyla ödeme yapmak için kullanılan kullanıcılar için kolaylık.

2) Şartların ve ayrıntıların biçimi

Entidade (Varlık/Hizmet kodu) - SIBS sistemindeki alıcı kodu (genellikle 5 basamaklı).
Referência (Referans) - fatura/siparişin 9 haneli benzersiz tanımlayıcısı.
Valor (Tutar) - ödenecek tutar (sabit) veya "açık" (PSP/satıcıda yapılandırılmışsa).

💡 Uygulama: E-ticaret için sabit bir Valor ve son kullanma tarihi kullanın - bu mutabakatı basitleştirir ve hataları azaltır.

3) Katılımcılar

SIBS/Multibanco (şema/anahtar) - MB ödemelerinin yönlendirilmesi ve temizlenmesi.
Ödeme bankası - ATM/homebanking sağlar, limitleri uygular/dolandırıcılığı önler.
PSP/Acquirer - API/panel üzerinden Referanslar/kuponlar yayınlar, webhook gönderir ve kaydeder, hesaplamalar yapar.
Satıcı - bir hesap oluşturur (Varlık/Referans/Tutar), statüler/krediler alır, getiri sağlar.

4) Akışlar ve kanallar

4. 1 MB Referanslar (ATM/homebanking yoluyla faturalar)

1. Merchant/PSP, Entidade + Referência + Valor + Expiry'yi oluşturur ve bunları kasada gösterir (ve/veya e-posta/SMS ile gönderir).
2. Müşteri ATM'de veya İnternet bankasında ödeme yapar - işlemi onaylar.
3. PSP, çevrimiçi durumu (ücretli/bekleyen/süresi dolmuş vb.) satıcıya ve daha sonra fin kayıtlarındaki hareketi (yerleşim) iletir.

Seçenekler:
  • Sipariş başına Dinamik Referans (önerilir).
  • Statik Referans (bağışlar/cüzdanlar için) - daha sık karmaşık uzlaşmaya yol açar, dikkatli kullanın.

4. 2 MB Kupon (ATM'de nakit/ödeme kodu)

Satıcı, PSP aracılığıyla bir "yarı kupon "/ödeme kodu (esasen kısa ömürlü bir Referans) oluşturur.
Müşteri ATM'ye veya homebanking'e gider ve kodla ödeme yapar - PSP çevrimiçi başarıyı bildirir.
Genellikle yüksek riskli/nakit senaryolarda ve kartsız müşteriler için kullanılır.

4. 3 MB fatura için MB WAY ile ödeme

Bazı PSP'lerde akış mevcuttur: istemci, MB WAY (cüzdan) aracılığıyla deşarj edilen MB-Reference için ödeme yapar. Bu, onaylamayı hızlandırır ve mobil cihazdaki dönüşümü artırır.

5) Durumlar ve hesaplamalar

Çevrimiçi durumlar (PSP isim bakımından farklılık gösterebilir):
  • 'yaratılmış' - 'beklemede' - 'ödenmiş'/' süresi dolmuş'/' iptal edilmiş'/' başarısız'.

Ödeme: Banka kredisi T + 0/T + 1 (banka pencerelerine/PSP'ye bağlıdır). Muhasebede anında çevrimiçi onay olsa bile, günlük kayıtlara güvenin.

Kısmi ödemelere varsayılan olarak izin verilmez (sabit Valor için). "Açık miktar" kısmi izin verir, ancak bu uzlaşmayı zorlaştırır - yalnızca bilinçli olarak dahil edin.

6) Limitler ve risk politikası

Tek bir "devre" tavanı yoktur - ödeme yapan bankanın ve PSP'nin ayarları geçerlidir:
  • İşlem başına/gün başına/24 saat; Bazen haftalık/aylık.
  • Yeni alıcılar/satıcılar için daha sıkı eşikler.
  • Kanal farklılıkları: ATM vs homebanking; Bazı bankaların farklı pencereleri/eşikleri vardır.
  • Banka/PSP tarafında hız/cihaz/coğrafi sinyaller.
💡 Uygulama: Miktarları sabit kodlamayın. Limit dizinini banka/kanal ile girin, güncelleyin ve kullanıcı arayüzünde reddetmenin açık nedenini gösterin ("banka/kanal limiti").

7) Ekonomi ve komisyonlar

Alım maliyeti tipik bir kart MDR'den daha düşüktür; Koşullar - PSP'nizde.
Fatura maliyetlerini, 'süresi dolmuş/beklemede' işleme, destek ve keşif işlemlerini göz önünde bulundurun.

8) İadeler ve anlaşmazlıklar

Ters ibraz (kartlarda olduğu gibi) eksik.
Geri ödeme, müşterinin IBAN'ında veya MB WAY cüzdanında (eğer kabul edilirse) yeni bir kredi işlemi (genellikle SEPA Kredi Transferi) olarak yapılır.
Arka ofiste kısmi geri ödemeleri destekleyin; 'refund↔original reference' paketini saklayın.

9) Güvenlik ve uyumluluk

Ödeme onayı, ödeme yapan kişinin bankasında (ATM/çevrimiçi bankacılık) gerçekleşir - düşük dolandırıcılık.
GDPR/PII minimizasyonu: Yalnızca gerekli nitelikleri saklayın (Varlık/Ref/Tutar, müşteri maskeleri).
Web kancaları - HMAC/nonce, yeniden oynatma koruması, olay tekilleştirme, denetim günlüğü.
Banco de Portugal gerekliliklerini ve SIBS/PSP sözleşme şartlarını göz önünde bulundurun.

10) Uzlaşma ve raporlama (keşif)

Her ödeme için kayıt:
  • 'Entity' (Entidade), 'reference' (9 basamaklı), 'amount' (valor), 'orderId', 'status', 'paidAt', 'channel' (ATM/homebanking/MB WAY), 'pspTxnId', kayıtlardan banka referansı/UTR.
  • Günlük: PSP/SIBS kayıtları tarafından otomatik keşif (krediler/iadeler/düzeltmeler) + periyodik tam keşif.
  • Senkronizasyon dışı için uyarılar: "Çevrimiçi başarı var, kayıtta giriş yok",'bir Ref'in çift ödemesi "," yanlış miktar ".

11) UX desenleri (kullanıcıya ne gösterileceği)

Büyük marjlar: Entidade/Referência/Valor + son tarih (son kullanma tarihi) ve zamanlayıcı.
Her alan için kopyalama düğmeleri; QR, kodlanmış bir dizi ayrıntıyla (PSP'niz destekliyorsa).
Talimatlar "ATM/online bankacılıkta 3-4 adımda nasıl ödeme yapılır".
Sipariş durumu Bekleyen Ödeme ve Arka Plan Güncellemesi. 'Expired'ile - tek bir tıklamayla'yeni bir referans oluştur ".
Onaydan sonra: 'entity', 'reference', 'paid' At ',' UTR've destek kişileri ile kontrol edin.

12) Tüccar entegrasyonu

Seçenekler

1. PSP'de Barındırılan/Gömülü - hızlı başlangıç, otomatik Referanslar, web kitapları ve yüklemeler.
2. Sunucudan Sunucuya - kendi check-out/faturalar, sipariş başına dinamik referanslar, özel son kullanma tarihi.
3. Pay-by-Link - e-posta/SMS/anlık mesajlaşma ile ayrıntıları ile bir bağlantı gönderme.

Arka uç zorunlu minimum:
  • API: 'create' reference '(entity/ref/amount/expiry),' cancel 'reference', 'refund', 'webhook', 'reconcille'.
  • Idempotence ('orderId'ile), durumlar için üstel retrays, gelen web kancalarının tekilleştirilmesi.
  • Kataloglar: bankalar/limitler, hata kodları, SLA metrikleri (ATM vs homebanking), son kullanma kartı.

13) MB WAY ve abonelikler

Temel MB Referansları/kuponları - bankadan onay ile bir defaya mahsus.
Yinelenen yazmalar için, bir paket kullanın: ilk ödeme - e-mandate/SEPA Direct Debit veya MB WAY biletleri (PSP'de varsa), sınırlamalar ve bildirimler.

14) Yüksek riskli dikeyler (iGaming dahil)

Multibanco sıklıkla uygulanır, ancak şartlar/limitler PSP/bankalara ve yerel yasalara bağlıdır.
Daha düşük eşikler, genişletilmiş KYC ve olası tutarlar bekleyin.
Plan alternatif raylar (haritalar, MB WAY, SEPA, diğer PIS) ve akıllı yönlendirme.

15) Multibanco Ağ Geçidi mimarisi

Nakit/fatura hizmeti için API katmanı (REST/GraphQL).
Etkinlik kuyrukları: durum etkinlikleri - faturalandırma/CRM/analiz.
Güvenlik: sırlar için kasa, IP-allowlist PSP, sıkı geri arama-URL doğrulama, anti-replay.
Gözlemlenebilirlik: dönüşüm 'yaratıldı - ödendi', paylaşım 'süresi doldu', ortalama ödeme süresi, ATM vs homebanking, web kancaları/kayıtları ile SLA.

16) Çıktı kontrol listesi

1. PSP'yi MB Referansları/Kuponu ile bağlayın; Anlaşmanın zamanlaması ve kayıtların formatı konusunda anlaştık.
2. 'CreateReference' (dinamik, son kullanma tarihi olan) ve talimat sayfalarını (ATM/homebanking) uygulayın.
3. Webhook'ları bağlayın, idempotency, retrai, deadup.
4. Günlük otomatik keşif + tam keşif, UTR depolama ve denetimi yapılandırın.
5. Kısmi/tam geri ödemeleri (SEPA/MB WAY), ODR düzenlemelerini etkinleştirin.
6. SLA panoları ve uyarıları 'yansıtılmış', senkronizasyon dışı, toplam hataları ile oluşturun.
7. En iyi bankalardan e2e ATM/homebanking testlerini, web kanca zamanlamalarını ve aşırı durumları (süresi dolmuş ref, çift ödeme) çalıştırın.

Landmark kartı

💡 Banka/PSP eşikleri ve son tarihler; Onları kodda sert bir şekilde düzeltmeyin.

Статусы: 'created/pending/paid/expired/cancelled/failed'.
Yerleşim: daha sık T + 0/T + 1.
Kısmi ödemeler: temerrüt yok (sabit bir miktar için).
İade: Yeni bir kredi işlemi olarak SEPA SCT/MB WAY cüzdanı.
Tekrarlama: e-mandate/SEPA DD (ilk ödeme> mandate) aracılığıyla.

Özet

Faturalar/ertelenmiş ödemeler için, dinamik ref ve vade sonu ile MB Referanslarını kullanın; Nakit/ATM kitlesi için - MB Kuponu.
Süreci webhooks + SIBS kayıtları, açık mutabakat ve yönetilen getiriler (SCT/MB WAY) etrafında oluşturun.
Limit yapılandırmalarını banka/kanal ile tutun, 'uzatılmış've onay zamanlamalarını izleyin.
Abonelikler için, şeffaf yönetim ve bildirimlere sahip ilk MB - bilet (SEPA/MB WAY).

Contact

Bizimle iletişime geçin

Her türlü soru veya destek için bize ulaşın.Size yardımcı olmaya her zaman hazırız!

Telegram
@Gamble_GC
Entegrasyona başla

Email — zorunlu. Telegram veya WhatsApp — isteğe bağlı.

Adınız zorunlu değil
Email zorunlu değil
Konu zorunlu değil
Mesaj zorunlu değil
Telegram zorunlu değil
@
Telegram belirtirseniz, Email’e ek olarak oradan da yanıt veririz.
WhatsApp zorunlu değil
Format: +ülke kodu ve numara (örneğin, +90XXXXXXXXX).

Butona tıklayarak veri işlemenize onay vermiş olursunuz.