بخش ایجنت ام سی پی به استور فرانت اضافه شداطلاعات بیشتر ←

راهنمای جامع راه‌اندازی درگاه پرداخت بلیک (BLIK) در وبیتو

۲۹ شهریور ۱۴۰۵


راهنمای جامع راه‌اندازی درگاه پرداخت بلیک (BLIK Payment Gateway) در فروشگاه‌های وبیتو

سیستم پرداخت بلیک (BLIK) بدون شک بزرگ‌ترین و محبوب‌ترین نوآوری پرداخت دیجیتال در کشور لهستان (Poland) است. بلیک که توسط شرکت «استاندارد پرداخت‌های لهستان» (PSP - Polski Standard Płatności) توسعه یافته است، بیش از ۷۰ درصد کل تراکنش‌های تجارت الکترونیک لهستان را به خود اختصاص داده است. در لهستان، خریداران ترجیح می‌دهند به جای وارد کردن شماره طولانی کارت‌های بانکی یا ریدایرکت شدن به درگاه‌های واسط، از کد پویای ۶ رقمی بلیک در اپلیکیشن بانکی خود استفاده کنند.

پلاگین رسمی BLIK Payments در پلتفرم فروشگاه‌ساز وبیتو، فرآیند اتصال به محبوب‌ترین درگاه‌های لهستانی (از جمله Przelewy24، Tpay و PayU) را به صورت کاملاً بومی و بدون ریدایرکت (Zero-Redirect Checkout) فراهم کرده است. خریدار مستقیماً در صفحه تسویه‌حساب وبیتو کد ۶ رقمی را وارد کرده و ظرف چند ثانیه روی تلفن همراه خود پوش‌نوتیفیکیشن تایید تراکنش را دریافت می‌کند.


۱. مزایای تجاری فعال‌سازی درگاه BLIK در لهستان

حذف بلیک از یک فروشگاه آنلاین فعال در بازار لهستان به منزله از دست دادن بیش از دو سوم مشتریان بالقوه است. جدول زیر برتری‌های کلیدی این روش پرداخت را نشان می‌دهد:

شاخص مقایسه‌ایپرداخت با کد ۶ رقمی BLIKکارت‌های اعتباری (Visa/Mastercard)انتقال بانکی مستقیم (Pay-By-Link)
سهم بازار در لهستان> ۷۰٪ کل تراکنش‌های آنلاینحدود ۱۵٪ تا ۱۸٪حدود ۸٪ تا ۱۰٪
تجربه کاربری (UX)بدون ریدایرکت در صفحه سایتنیازمند ورود ۱۶ رقم + CVV + 3DSریدایرکت کامل به سایت بانک
میانگین زمان پرداختکمتر از ۲۰ ثانیه۴۵ تا ۶۰ ثانیه۶۰ تا ۹۰ ثانیه
نرخ رهاسازی سبد خریدکمترین میزان (زیر ۱۲٪)بالا به دلیل خطای رمز دوممتوسط
پشتیبانی از One-Click (Alias)دارد (پرداخت با ۱ کلیک)نیازمند توکنایز کارتندارد
امنیت داده‌های مشتریبدون افشای اطلاعات بانکیریسک فیشینگ کارتامنیت مبتنی بر لاگین بانک

۲. سازوکار و توالی پردازش تراکنش BLIK در وبیتو

فرایند پرداخت بلیک یک الگوی غیرهمزمان (Asynchronous Challenge-Response) مبتنی بر پوش‌نوتیفیکیشن موبایل است:

mermaid
sequenceDiagram
    autonumber
    actor Shopper as خریدار لهستانی
    participant Storefront as فروشگاه وبیتو (Checkout)
    participant Plugin as پلاگین BLIK وبیتو
    participant Gateway as اپراتور درگاه (P24 / Tpay)
    participant PSP as هسته مرکزی بلیک (PSP)
    participant BankApp as اپلیکیشن بانک خریدار

    Shopper->>BankApp: باز کردن اپلیکیشن بانک و دریافت کد ۶ رقمی
    Shopper->>Storefront: وارد کردن کد (مثال: 777123) در چک‌اوت
    Storefront->>Plugin: ارسال درخواست initiate با کد ۶ رقمی
    Plugin->>Gateway: POST /transaction/register (مبلغ به گروش + کد)
    Gateway->>PSP: استعلام چالش بلیک
    PSP->>BankApp: ارسال پوش‌نوتیفیکیشن: «تایید مبلغ ۱۵۰ زلوتی به فروشگاه وبیتو»
    Plugin-->>Storefront: اعلام وضعیت PENDING_USER_CONFIRMATION
    Storefront->>Shopper: نمایش تایمر شمارش معکوس (۱۲۰ ثانیه)
    Shopper->>BankApp: تایید با اثر انگشت یا پین‌کد
    BankApp->>PSP: تایید هویت و کسر وجه
    PSP->>Gateway: تایید پرداخت موفق
    Gateway->>Plugin: وب‌هوک وضعیت PAID
    Plugin-->>Storefront: تایید سفارش و نمایش فاکتور نهایی

۳. مدارک، اپراتورها و نحوه دریافت کلیدهای دسترسی

در لهستان، امکان اتصال مستقیم شرکت‌ها به سوئیچ مرکزی PSP وجود ندارد و پذیرندگان باید از طریق یکی از اپراتورهای پرداخت دارای مجوز نظارت مالی لهستان (KNF) اقدام کنند:

  1. Przelewy24 (P24): بزرگ‌ترین پردازشگر پرداخت لهستان (przelewy24.pl).
  2. Tpay: پردازشگر اختصاصی و پیشرفته با API مدرن (tpay.com).
  3. PayU Poland: پردازشگر بین‌المللی با سهم بازار گسترده (payu.pl).

چک‌لیست فیلدهای تنظیمی در وبیتو:

عنوان فیلد در پنل وبیتوکلید سیستمیضرورتتوضیحات و کاربردنمونه مقدار
اپراتور درگاهgatewayOperatorالزامیانتخاب یکی از درگاه‌های przelewy24، tpay یا payuprzelewy24
شناسه پذیرنده (POS ID)merchantIdالزامیشناسه یکتای فروشگاه شما در پرتال پذیرندگان123456
کلید دسترسی (API Key)apiKeyالزامیکلید API جهت احراز هویت درخواست‌های RESTsec_api_99aabbccddee
کلید مخفی (CRC / Secret)apiSecretالزامیکلید هش جهت اعتبارسنجی امضای HMAC وب‌هوک‌هاsalt_crc_88776655
حالت سندباکسsandboxاختیاریفعال‌سازی محیط تست و شبیه‌سازی تراکنشtrue / false
پرداخت وان‌کلیک (Alias)blikAliasEnabledاختیاریفعال‌سازی ذخیره توکن جهت پرداخت ۱ کلیکی خرید بعدtrue
نکته کاربردی

نحوه تست در محیط سندباکس (Sandbox Testing): در محیط تست Przelewy24 و Tpay، برای شبیه‌سازی تراکنش موفق نیازی به باز کردن اپلیکیشن بانکی واقعی ندارید؛ کافی است هر کدی با فرمت 777XXX (مانند 777123 یا 777001) وارد نمایید. برای شبیه‌سازی رد تراکنش توسط کاربر نیز کدهای دیگر یا صبر کردن تا اتمام تایمر کارایی دارند.


۴. دیکشنری جامع خطاها و رفع اشکال (Troubleshooting)

کد / پیغام خطاعلت بروز خطااقدام اصلاحی در وبیتو
BLIK_CODE_EXPIREDاعتبار کد ۶ رقمی منقضی شده است (بیش از ۱۲۰ ثانیه گذشته).خریدار باید در اپلیکیشن بانکی خود کد جدیدی جنریت کند.
BLIK_USER_REJECTEDخریدار در اپلیکیشن بانک دکمه رد (Cancel) را فشرده است.سفارش در وضعیت معلق می‌ماند و کاربر می‌تواند مجدداً تلاش کند.
BLIK_TIMEOUTدر مدت زمان مجاز تایمر (معمولاً ۲ دقیقه) تاییدی از بانک واصل نشد.تراکنش لغو شده و مبلغی از حساب کسر نمی‌گردد.
BLIK_INVALID_AMOUNTمبلغ سفارش کمتر از حداقل یا بیشتر از سقف مجاز پرداخت بلیک است.بررسی سبد خرید؛ واحدهای پولی به درستی به گروش (Grosze) تبدیل شده‌اند.
INVALID_SIGNATUREهش اعتبارسنجی وب‌هوک با کلید CRC مطابقت ندارد.مقدار apiSecret را در پنل وبیتو با پرتال درگاه بازبینی کنید.

۵. پرسش‌های متداول (FAQ)

آیا خریدار برای پرداخت با BLIK نیاز به نصب اپلیکیشن وبیتو دارد؟
خیر؛ خریدار تنها از اپلیکیشن همراه بانک شخصی خود (مانند mBank, PKO BP, Santander, ING, Millennium) که از پیش روی گوشی نصب دارد استفاده می‌کند.

حداکثر سقف مجاز تراکنش با بلیک چقدر است؟
سقف استاندارد پیش‌فرض بانک‌های لهستان معمولاً بین ۱,۰۰۰ تا ۱۰,۰۰۰ زلوتی (PLN) متغیر است که توسط خود کاربر در تنظیمات همراه بانکش قابل افزایش است.

تسویه حساب وجه به حساب فروشگاه چگونه انجام می‌شود؟
اپراتورهای لهستانی (P24, Tpay) وجوه دریافتی را طبق سیکل استاندارد روزانه یا هفتگی به شماره شبای بانکی اروپایی (IBAN) شرکت واریز می‌کنند.