Garanti BBVA

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

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

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

سيزوّدك البنك بما يلي:

• معرّف التاجر (Üye İşyeri No) — معرّف التاجر الخاص بك؛

• معرّف الطرفية — معرّف الطرفية الخاص بك؛

• معرّف مستخدم التفويض — اسم مستخدم التفويض (عادةً PROVAUT أو PROVOOS);

• كلمة مرور التفويض — كلمة مرور مستخدم التفويض.

يتم إنشاء مفتاح المتجر (مفتاح 3D Secure) بواسطتك في نقطة بيع افتراضية لوحة الإدارة (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. أنشئ بداية كتلة.

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

الخطوة 2. أنشئ الكتلة الموضحة أدناه.

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

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

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

وأيضًا، فعّل إدخال المستخدم للبيانات الخيار وأدخل customer_email.

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

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

فعّل المؤقت للانتقال تلقائيًا إلى الكتلة التالية.

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

مثال للنسخ:

amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

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

مثال للنسخ:

amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

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

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

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

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

• أدخل نص الزر.

• اختر الفوترة الدالة.

• اختر Garanti BBVA كمزوّد الدفع.

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

• اسم المنتج.

• مبلغ الدفع.

• العملة (اختياري).

• الاسم الكامل للعميل (اختياري). يمكنك تكوين هذا بالطريقة نفسها التي قمت بها لتكوين إدخال بريد العميل الإلكتروني.

• بريد العميل الإلكتروني — أدخل المتغير #{customer_email}.

ثم انقر إضافة.

الإشعارات بعد الدفع

بعد أن يتبع العميل رابط الدفع ويكمل عملية الدفع، سيتم إرسال إشعار (callback) إلى المحادثة.

لعملية دفع ناجحة:

SDJ91MTKTT_success 100

حيث:

• SDJ91MTKTT هي أول 10 أحرف من مفتاح المتجر.

• 100 هو مبلغ الدفع.

إذا فشل الدفع، فسيتم إرسال الإشعار التالي:

SDJ91MTKTT_fail 100

كيفية إرسال رد على عملية دفع ناجحة أو فاشلة

الخطوة 1. أنشئ المشغّل كتلة.

الخطوة 2. في حقل الشرط، أدخل نص الإشعار SDJ91MTKTT_success — بدون مبلغ الدفع — إذا كنت تريد الاستجابة لكل عملية دفع.

في هذه الحالة، نوع المطابقة يجب أن يكون مضبوطًا على حسب الكلمات المفتاحية.

بدلًا من ذلك، أدخل نص الاستدعاء الكامل في حقل المحفّز إذا كنت تريد الاستجابة لعملية دفع محددة. في هذه الحالة، يجب ضبط نوع المطابقة على مطابقة تامة.

إذا كنت تريد متابعة سير العمل بعد عملية دفع ناجحة، يمكنك إنشاء بداية كتلة بدلًا من المشغّل كتلة ومتابعة بناء تدفق الروبوت من هناك.

متغيرات العميل بعد عملية دفع ناجحة

المتغير	الوصف
garanti_callback_data	معلومات الدفع المستلمة من نظام الدفع.
garanti_payment_completed	"True" إذا تمت معالجة الدفع بنجاح.
garanti_auth_code	رمز تفويض المعاملة الخاص بالبنك.