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

راهنمای راه‌اندازی درگاه هوشمند Viva.com Smart Checkout در وبیتو

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


درگاه پرداخت هوشمند Viva.com Smart Checkout v2

Viva.com (که پیش‌تر با نام Viva Wallet شناخته می‌شد) پیشرفته‌ترین نئوبانک و ارائه‌دهنده خدمات پرداخت ابری در سراسر اتحادیه اروپا و بریتانیا است. این درگاه در کشورهایی نظیر قبرس، یونان و سایر کشورهای منطقه اقتصادی اروپا (EEA) به عنوان مدرن‌ترین درگاه پرداختی شناخته می‌شود که از ۳۰+ روش پرداخت شامل Apple Pay، Google Pay و کارت‌های اعتباری اروپایی پشتیبانی می‌نماید.


۱. ویژگی‌های کلیدی درگاه Viva.com

  • درگاه هوشمند تطبیقی (Smart Checkout): شناسایی خودکار ملیت خریدار و نمایش محبوب‌ترین روش‌های پرداخت محلی آن کشور.
  • پشتیبانی بومی از کیف‌های دیجیتال: پرداخت تک‌لمسی با Apple Pay و Google Pay بدون نیاز به وارد کردن دستی اطلاعات کارت.
  • تسویه فوق سریع: واریز وجه فروش در همان روز به حساب تجاری IBAN شما در ویوا والت.
  • امکان به صفر رساندن کارمزد پرداخت (0% Fees): با خرج کردن درآمد حاصل از فروش از طریق کارت نقدی تجاری Viva Debit Card، کارمزد تراکنش‌های فروشگاه شما تا سقف ۱۰۰٪ بازپرداخت نقدی (Cashback) می‌شود.

۲. اطلاعات مورد نیاز برای اتصال درگاه

برای اتصال وبیتو به پورتال Viva.com، نیاز به اطلاعات زیر از بخش Settings > API Access پنل ویوا دارید:

پارامترتوضیحات
Client IDشناسه کلاینت احراز هویت OAuth2 برای ایجاد نشست خرید
Client Secretکلید امنیتی کلاینت برای دریافت توکن‌های Bearer
Source Codeکد چهاررقمی منبع پرداخت که در پنل ویوا برای سایت خود تعریف کرده‌اید
Webhook Secretکد احراز اصالت وب‌هوک‌های برگشتی جهت تایید آنی پرداخت‌ها

۳. مراحل فعال‌سازی در پنل مدیریت وبیتو

  1. وارد پنل مدیریت وبیتو شده و به بخش پلاگین‌ها > Viva Wallet مراجعه کنید.
  2. کلیدهای Client ID و Client Secret دریافت شده از پرتال بانکی ویوا را جای‌گذاری نمایید.
  3. کد منبع فروشگاه خود (Source Code) را وارد کنید (به عنوان مثال Default یا شناسه اختصاصی).
  4. در صورت استفاده از حساب دمو، تیک حالت تستی (Demo Mode) را فعال کنید تا تراکنش‌ها از طریق دامنه demo-api.vivapayments.com هدایت شوند.
  5. دکمه ذخیره را بزنید و سپس پلاگین را در حالت فعال قرار دهید.
وب‌هوک تایید آنی تراکنش (Event 1796)

پلاگین وبیتو به صورت کاملاً خودکار رویداد Transaction Payment Created (1796) را پردازش کرده و تنها زمانی که شناسه وضعیت تراکنش برابر با "F" (تکمیل‌شده/Fully Paid) باشد، فاکتور خرید را نهایی و کسر موجودی انبار را اعمال می‌کند.