Garanti BBVA

لاستخدام نظام الدفع Garanti BBVA (Sanal POS) في Mavibot، يجب الحصول على بيانات اعتماد المحطة الطرفية الافتراضية من البنك وإدخالها في إعدادات التكامل. تتم معالجة الدفع على صفحة البنك الآمنة مع تأكيد 3D Secure.

الحصول على بيانات الاعتماد

قم بتوقيع اتفاقية مع Garanti BBVA لخدمة Sanal POS (المحطة الطرفية الافتراضية). عند تفعيل الخدمة، اطلب من البنك تمكين Ortak Ödeme (صفحة الدفع المشتركة) لمحطتك الطرفية. بدون هذه الميزة، لن تعمل المدفوعات عبر صفحة دفع البنك.

سيوفر لك البنك ما يلي:

معرف التاجر (Üye İşyeri No) — معرف التاجر الخاص بك؛
معرف المحطة الطرفية — معرف المحطة الطرفية الخاص بك؛
معرف مستخدم التزويد — اسم مستخدم التزويد (عادةً PROVAUT أو PROVOOS)؛
كلمة مرور التزويد — كلمة مرور مستخدم التزويد.

مفتاح المتجر (مفتاح 3D Secure) يتم إنشاؤه بواسطتك في لوحة إدارة Sanal POS (Yönetim → 3D Secure). تأكد من حفظه، حيث أنه مطلوب أيضًا للتكامل.

كيفية ربط Garanti BBVA بـ Mavibot؟

في قسم الاستحواذ في Mavibot، اختر Garanti BBVA وأدخل التفاصيل التالية:

معرف التاجر — معرف التاجر الخاص بك.
معرف المحطة الطرفية — معرف المحطة الطرفية الخاص بك.
معرف مستخدم التزويد — اسم مستخدم التزويد. إذا تركت هذا الحقل فارغًا، سيتم استخدام PROVAUT.
كلمة مرور التزويد — كلمة مرور مستخدم التزويد.
مفتاح المتجر — مفتاح 3D Secure الخاص بك.
اسم المتجر — الاسم المعروض للعملاء على صفحة دفع البنك. إذا تركت هذا الحقل فارغًا، سيتم عرض "متجر عبر الإنترنت".
وضع الاختبار — قم بتمكين هذا الخيار لاختبار التكامل باستخدام بيانات اعتماد الاختبار الخاصة بالبنك. لمعالجة المدفوعات الحية، يجب تعطيل هذا الخيار.

اكتمل التكامل الآن.

إنشاء رابط دفع

وظيفة الحاسبة:

get_garanti_payment_url(amount, description, currency, customer_email, language)

المعلمات:

المعامل	الوصف	مطلوب	القيم الافتراضية / المسموح بها
`amount`	مبلغ الدفع.	✅	—
`description`	وصف الدفع.	لا	—
`currency`	عملة الدفع.	لا	`TRY` (افتراضي). القيم المدعومة: `TRY`, `USD`, `EUR`, `GBP`, `JPY`
`customer_email`	عنوان البريد الإلكتروني للعميل.	لا	—
`language`	لغة صفحة الدفع.	لا	`tr` (افتراضي). القيم المدعومة: `tr`, `en`

تقوم الوظيفة بإرجاع رابط دفع.

رابط الدفع في زر

لإرسال زر مع رابط دفع، اختر نوع الزر الدفع واختر Garanti BBVA كموفر الدفع. ثم أدخل اسم المنتج ومبلغ الدفع، وإذا لزم الأمر، عملة الدفع.

مثال 1: تكوين سير العمل

الخطوة 1. قم بإنشاء كتلة بدء.

كتلة البداية تُستخدم عادةً لعرض أول رسالة ترحيب في سير العمل، بالإضافة إلى أي معلومات تمهيدية يحتاجها المستخدم.

الخطوة 2. قم بإنشاء الكتلة الموضحة أدناه.

الخطوة 3. انتقل إلى إعدادات الاتصال.

ستحتاج إلى التعبير النمطي التالي للتحقق من أن العميل قد أدخل عنوان بريد إلكتروني صالح:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

أيضًا، قم بتمكين خيار المستخدم يدخل البيانات وأدخل customer_email.

الخطوة 4. أدخل الرسالة في الكتلة الثانية.

الخطوة 5. قم بإنشاء كتلة ثالثة وافتح إعدادات الاتصال بين الكتلتين الثانية والثالثة.

قم بتمكين المؤقت للانتقال تلقائيًا إلى الكتلة التالية.

الخطوة 6. في الكتلة الثالثة، أدخل الوظيفة في الحاسبة.

مثال للنسخ:

amount = 1000
description = "المنتج 1 هو منتج ذو موثوقية عالية!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

إذا كنت ترغب في قبول المدفوعات بعملة غير الليرة التركية (TRY)، حدد العملة كما هو موضح أدناه.

مثال للنسخ:

amount = 1000
description = "المنتج 1 هو منتج ذو موثوقية عالية!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

مثال 2. زر الفوترة

هذا المثال مطابق تقريبًا لـ المثال 1.

ومع ذلك، بدلاً من إنشاء كتلة ثالثة بوظيفة لإنشاء رابط الدفع، يمكنك إنشاء زر في الكتلة الثانية.

في النافذة التي تفتح:

أدخل نص الزر.
اختر وظيفة الفوترة.
اختر Garanti BBVA كموفر الدفع.

ثم أدخل ما يلي:

اسم المنتج.
مبلغ الدفع.
العملة (اختياري).
الاسم الكامل للعميل (اختياري). يمكنك تكوين هذا بنفس طريقة تكوين إدخال البريد الإلكتروني للعميل.
البريد الإلكتروني للعميل — أدخل المتغير #{customer_email}.