راهنمای راه‌اندازی درگاه پرداخت بانکی JCC قبرس در وبیتو

درگاه پرداخت بانکی JCC Payment Systems قبرس

شرکت JCC Payment Systems بزرگ‌ترین و معتبرترین سوئیچ پرداخت الکترونیک و تسویه کارت‌های بانکی در جمهوری قبرس است که توسط کنسرسیومی از بانک‌های تراز اول قبرس از جمله Bank of Cyprus، Hellenic Bank و Eurobank پشتیبانی می‌شود. اتصال مستقیم وبیتو به این شبکه، امکان پذیرش کلیه کارت‌های اعتباری و نقدی بین‌المللی (Visa, Mastercard, Maestro, American Express) را با تسویه مستقیم به حساب بانکی شرکت شما در قبرس فراهم می‌سازد.

۱. مزایای درگاه رسمی JCC برای کسب‌وکارهای بین‌المللی

• تسویه مستقیم به یورو (€ EUR): وجوه حاصل از فروش بدون واسطه به شماره حساب IBAN شرکت شما در بانک‌های قبرس واریز می‌شود.
• انطباق کامل با استاندارد 3D Secure v2: کاهش چشمگیر ریسک کلاهبرداری و بازپرداخت اجباری (Chargeback) با احراز هویت پیامکی و اپلیکیشن بانکی.
• پایداری ۹۹.۹۸٪ و پروتکل REST: اتصال از طریق اندپوینت رسمی gateway.jcc.com.cy با رمزنگاری دوطرفه TLS 1.3.
• امکان استرداد وجه از پنل وبیتو: بدون نیاز به ورود به پورتال بانکی JCC، امکان عودت کامل یا جزئی مبلغ تراکنش به خریدار مهیا است.

۲. اطلاعات و پیش‌نیازهای دریافت درگاه از JCC

برای فعال‌سازی درگاه JCC نیاز به ثبت قرارداد Merchant Agreement با JCC و دریافت شناسه اختصاصی پذیرنده دارید:

۳. مراحل پیکربندی درگاه در پنل وبیتو

1. وارد پنل مدیریت وبیتو شده و به بخش پلاگین‌ها و ادغام‌ها > درگاه‌های پرداخت بروید.
2. پلاگین JCC Payment Systems را پیدا کرده و بر روی پیکربندی (Configure) کلیک نمایید.
3. مقادیر Merchant ID، Acquirer ID و Merchant Password را در فیلدهای مربوطه وارد نمایید.
4. در صورت آزمایش در محیط تستی، گزینه محیط تست (Sandbox Mode) را فعال بگذارید تا درخواست‌ها به سرور gateway-test.jcc.com.cy هدایت شوند.
5. دکمه ذخیره تغییرات و سپس فعال‌سازی پلاگین را بزنید.

۴. چرخه فنی تراکنش و اعتبارسنجی امنیتی

در وبیتو، پرداخت‌های JCC در ۳ مرحله پردازش می‌شوند:

1. ثبت اولیه سفارش (register.do): وبیتو مبلغ سفارش را به کوچک‌ترین واحد پولی (یورو سنت) تبدیل کرده و سفارش را ثبت می‌کند. JCC یک شناسه orderId و پیوند فرم پرداخت امن (formUrl) بازمی‌گرداند.
2. هدایت خریدار و ورود به صفحه امن بانک: خریدار به صفحه تحت حفاظت JCC با گواهی PCI-DSS هدایت شده و رمز یکبار مصرف 3DS2 را وارد می‌کند.
3. استعلام خودکار و تسویه نهایی (getOrderStatusExtended.do): پس از بازگشت خریدار، وبیتو وضعیت را از سرور مرکزی JCC استعلام می‌گیرد. سفارش فقط در صورتی به وضعیت «پرداخت‌شده» تغییر می‌کند که کد وضعیت برابر با 2 (Deposited) باشد.

bashکپی
# نمونه پاسخ استعلام موفق از سوئیچ JCC
{
  "orderStatus": 2,
  "actionCode": 0,
  "actionCodeDescription": "APPROVED",
  "amount": 4900,
  "currency": "978"
}

۵. مدیریت استرداد وجه (Refunds)

چنانچه مشتری سفارشی را لغو نماید، می‌توانید از برگه جزئیات سفارش در پنل وبیتو، روی گزینه استرداد وجه کلیک کنید. وبیتو با فراخوانی متد refund.do در درگاه JCC، مبلغ را مستقیماً به کارت بانکی مشتری بازمی‌گرداند.