Multibanco پرتغال: کوپن و refs

1) زمینه و موقعیت چندگانه

• مراجع MB (Pagamento د Serviços/Compras): جزئیات پرداخت از فرم Entidade + Referência + ارزش برای پرداخت فاکتورها در دستگاه خودپرداز و یا homebanking.
• MB کوپن/MB نقدی در دستگاه خودپرداز: «کوپن» سناریو - خریدار کد/آموزش دریافت می کند و می پردازد در دستگاه خودپرداز و یا در بانک اینترنت; بازرگان یک تأیید آنلاین از PSP و یک اعتبار بانکی بعدی دریافت می کند.

ویژگی ها: تقلب بسیار کم، نهایی مانند انتقال بانکی (بدون بازپرداخت)، راحتی برای کاربرانی که از طریق ATM/homebanking پرداخت می کنند.

2) شرایط و فرمت جزئیات

Entidade (Entity/Service code) - کد گیرنده در سیستم SIBS (معمولا 5 رقمی).
Referência (مرجع) - شناسه منحصر به فرد 9 رقمی فاکتور/سفارش.
ارزش (مقدار) - مقدار قابل پرداخت (ثابت) و یا «باز» (اگر چنین پیکربندی در PSP/تاجر).

تمرین: برای تجارت الکترونیک، از یک Valor ثابت و انقضا استفاده کنید - این ساده سازی آشتی و کاهش اشتباهات است.

3) شرکت کنندگان

SIBS/Multibanco (طرح/سوئیچ) - مسیریابی و پاکسازی پرداخت MB.
بانک پرداخت کننده - ATM/homebanking را فراهم می کند، محدودیت ها/ضد تقلب را اعمال می کند.
PSP/Acquirer - منابع/کوپن ها را از طریق API/پانل صادر می کند، وب سایت ها را ثبت می کند، محاسبات را انجام می دهد.
بازرگان - یک حساب کاربری ایجاد می کند (نهاد/مرجع/مقدار)، وضعیت/اعتبار دریافت می کند، بازده می دهد.

4) جریان ها و کانال ها

4. 1 MB مراجع (فاکتورها از طریق دستگاه خودپرداز/homebanking)

1. Merchant/PSP Entidade + Referência + Valor + Expiry را ایجاد می کند و آنها را در پرداخت نشان می دهد (و/یا آنها را از طریق ایمیل/SMS ارسال می کند).
2. مشتری در دستگاه خودپرداز یا در بانک اینترنتی خود پرداخت می کند، معامله را تأیید می کند.
3. PSP انتقال وضعیت آنلاین (پرداخت/در انتظار/منقضی شده، و غیره) به تاجر و سپس حرکت در ثبت فین (حل و فصل).

• مرجع پویا در هر سفارش (توصیه می شود).
• مرجع استاتیک (برای کمک های مالی/کیف پول) - اغلب منجر به آشتی پیچیده می شود، با دقت استفاده کنید.

4. 2 MB کوپن (پول نقد در دستگاه خودپرداز/پرداخت کد)

تاجر تولید «شبه کوپن «/کد پرداخت (در اصل یک مرجع کوتاه مدت) از طریق PSP.
مشتری می رود به دستگاه های خودپرداز و یا homebanking و می پردازد توسط کد → PSP گزارش موفقیت آنلاین.
اغلب در سناریوهای پر خطر/نقدی و برای مشتریان بدون کارت استفاده می شود.

4. 3 پرداخت از طریق MB WAY برای فاکتور MB

در برخی از PSP ها، جریان در دسترس است: مشتری برای MB-Reference تخلیه شده از طریق MB WAY (کیف پول) پرداخت می کند. این سرعت تایید را افزایش می دهد و تبدیل را در تلفن همراه افزایش می دهد.

5) وضعیت و محاسبات

• «created» → «در انتظار» → «پرداخت شده »/« منقضی شده »/« لغو شده »/« شکست خورده».

حل و فصل: اعتبار بانکی T + 0/T + 1 (بستگی به پنجره بانک/PSP). حتی با تأیید آنلاین فوری در حسابداری، به ثبت روزانه اعتماد کنید.

پرداخت های جزئی به طور پیش فرض مجاز نیست (برای Valor ثابت). «مقدار باز» اجازه می دهد تا جزئی، اما این پیچیده آشتی - شامل تنها آگاهانه.

6) محدودیت ها و سیاست ریسک

• در هر معامله/در روز/24 ساعت ؛ گاهی اوقات هفتگی/ماهانه.
• آستانه تنگ تر برای گیرندگان/بازرگانان جدید.
• تفاوت های کانال: ATM در مقابل homebanking ؛ برخی از بانک ها دارای پنجره ها/آستانه های مختلف هستند.
• سرعت/دستگاه/سیگنال های جغرافیایی در سمت بانک/PSP.

7) اقتصاد و کمیسیون

هزینه پذیرش کمتر از MDR کارت معمولی است ؛ شرایط - در PSP شما.
هزینه های فاکتور، پردازش، پشتیبانی و بازپرداخت «منقضی شده/در انتظار» را در نظر بگیرید.

8) بازگشت و اختلافات

Chargeback (همانطور که در کارت ها) گم شده است.
بازپرداخت به عنوان یک معامله اعتباری جدید (معمولا انتقال اعتبار SEPA) در IBAN مشتری یا از طریق کیف پول MB WAY (در صورت موافقت) انجام می شود.
پشتیبانی از بازپرداخت جزئی در دفتر پشتی ؛ بسته نرم افزاری «مرجع refund↔original» را ذخیره کنید.

9) ایمنی و انطباق

تأیید پرداخت در بانک پرداخت کننده (ATM/بانکداری آنلاین) انجام می شود.
به حداقل رساندن GDPR/PII: فقط ویژگی های لازم را ذخیره کنید (Entity/Ref/Amount، ماسک مشتری).
قلاب وب - HMAC/nonce، حفاظت از پخش، رویداد dedup، ورود به سیستم حسابرسی.
الزامات Banco de Portugal و شرایط قراردادی SIBS/PSP را در نظر بگیرید.

10) آشتی و گزارش (recon)

• 'entity' (Entidade)، 'مرجع' (9 رقمی)، 'مقدار' (ارزش)، 'سفارش'، 'وضعیت'، 'پرداخت'، 'کانال' (ATM/homebanking/MB WAY)، 'pspTxnId'، مرجع بانکی/UTR از ثبت نام.
• روزانه: خودکار recon توسط ثبات PSP/SIBS (اعتبار/بازده/اصلاحات) + دوره ای کامل recon.
• هشدارها برای خارج از همگام سازی: «موفقیت آنلاین وجود دارد، هیچ ورودی در ثبت نام وجود دارد»، «پرداخت دو برابر یک Ref»، «مقدار نادرست».

11) الگوهای UX (چه چیزی برای نشان دادن به کاربر)

حاشیه های بزرگ: Entidade/Referência/Valor + مهلت (انقضای) و تایمر.
دکمه های کپی برای هر فیلد ؛ QR با مجموعه ای از جزئیات کد شده (اگر PSP شما پشتیبانی می کند).
دستورالعمل «نحوه پرداخت در ATM/بانکداری آنلاین» با 3-4 مرحله.
وضعیت سفارش در انتظار پرداخت و به روز رسانی پس زمینه. With «expired» - «ایجاد یک مرجع جدید» در یک کلیک.
پس از تایید: با «نهاد»، «مرجع»، «پرداخت شده»، «UTR» و مخاطبین پشتیبانی کنید.

12) ادغام بازرگان

گزینه ها

1. میزبانی/جاسازی شده در PSP - شروع سریع، تولید خودکار منابع، webhooks و آپلود.
2. سرور به سرور - خود چک کردن/فاکتورها، منابع پویا در هر سفارش، تاریخ انقضا سفارشی.
3. پرداخت توسط لینک - ارسال یک لینک با جزئیات از طریق ایمیل/SMS/پیام های فوری.

• API: 'createReference' (نهاد/ref/مقدار/انقضای), 'لغو مرجع', 'بازپرداخت', 'webhook', 'آشتی'.
• Idempotence (توسط 'orderId')، retrays نمایی برای statuses، dedupe از قلاب وب ورودی.
• کاتالوگ ها: بانک ها/محدودیت ها، کدهای خطا، معیارهای SLA (ATM در مقابل homebanking)، کارت انقضا.

13) مگابایت راه و اشتراک

عمومی MB منابع/کوپن - یک کردن با تایید از بانک.
برای نوشتن مجدد، از یک بسته نرم افزاری استفاده کنید: اولین پرداخت → e-mutation/SEPA Direct Debit یا MB WAY بلیط (در صورت موجود بودن در PSP)، با محدودیت ها و اطلاعیه ها.

14) عمودی با ریسک بالا (از جمله iGaming)

Multibanco اغلب اعمال می شود، اما شرایط/محدودیت ها به PSP/بانک ها و قوانین محلی بستگی دارد.
انتظار می رود آستانه های پایین، KYC گسترش یافته و ممکن است نگه داشته شود.
برنامه ریزی ریل های جایگزین (نقشه ها، MB WAY، SEPA، دیگر PIS) و مسیریابی هوشمند.

15) معماری دروازه چند بانکو

لایه API (REST/GraphQL) برای میز نقدی/سرویس فاکتور.
صف های رویداد: رویدادهای وضعیت → صورتحساب/CRM/تجزیه و تحلیل.
امنیت: طاق برای اسرار، PSP IP allowlist، اعتبار سنجی دقیق callback-URL، ضد پخش.
قابلیت مشاهده: تبدیل «ایجاد شده → پرداخت شده»، سهم «منقضی شده»، متوسط زمان پرداخت، ATM در مقابل homebanking، SLA توسط قلاب وب/ثبت.

16) چک لیست خروجی

1. اتصال PSP با منابع MB/کوپن; موافقت در زمان حل و فصل و فرمت ثبت.
2. پیاده سازی 'createReference' (پویا، با انقضای) و صفحات دستورالعمل (ATM/homebanking).
3. اتصال webhooks، idempotency، retrai، deadup.
4. پیکربندی روزانه خودکار recon + full-recon، ذخیره سازی UTR و حسابرسی.
5. بازپرداخت جزئی/کامل (SEPA/MB WAY)، مقررات ODR را فعال کنید.
6. ساخت داشبورد SLA و هشدار توسط 'expired'، از همگام سازی، خطاهای مجموع.
7. اجرای آزمون e2e ATM/homebanking از بانک های برتر، زمان بندی قلاب وب و موارد شدید (ref منقضی شده، پرداخت دو برابر).

کارت علامت گذاری

Статусы: 'created/pending/paid/expired/cancelled/failed'.
حل و فصل: اغلب T + 0/T + 1.
پرداخت جزئی: بدون پیش فرض (برای مبلغ ثابت).
بازگشت: SEPA SCT/MB WAY کیف پول به عنوان یک معامله اعتباری جدید.
عود: از طریق دستور الکترونیکی/SEPA DD (اولین پرداخت → دستور).

خلاصه

برای فاکتورها/پرداخت معوق، استفاده از منابع MB با ref پویا و انقضای ؛ برای مخاطبان نقدی/ATM - MB کوپن.
ساخت روند در اطراف webhooks + SIBS ثبت، آشتی روشن و بازده مدیریت (SCT/MB راه).
پیکربندی محدودیت را با بانک/کانال نگه دارید، نظارت بر 'زمان های مورد نیاز' و تایید.
برای اشتراک، اولین MB → بلیط (SEPA/MB WAY) با مدیریت شفاف و اطلاعیه ها.