اقبل الدفع بالتحويل البنكي في الموقع متاعك للتجارة الإلكترونية

في متجر إلكتروني، الدفع بالبطاقة يعدّي عبر بوابة تردّ «مخلّص» ولا «مرفوض» في ثواني. أما التحويل البنكي يخدم بطريقة أخرى: المشتري هو اللي يعملو في بنكو، بعد الطلب. هاذا كيفاش تدمجو من غير مخاطر.

شنوّة يتبدّل بالنسبة للبطاقة

• ما فماش صفحة دفع مستضافة ولا إعادة توجيه. المشتري يبقى في الموقع متاعك.
• ما فماش رد «مخلّص» في الحين. طلب الـAPI اللي يعمل الفاتورة يرد أنّ الطلب التجاري ملتزم بيه.
• التأكيد يوصل بعد، بالـWebhook، وقت اللي بنك المشتري يأكّد التحويل.

يعني: الطلب ما يتحرّرش كان على الـWebhook هاذا.

المسار في خمس خطوات

1. المشتري يختار «الخلاص بـvirement.tn» في صفحة الدفع متاعك.
2. الاستمارة متاعك تطلب زوز حقول: نمرة التليفون ورمز التحقق (6 خانات، يتستعمل مرّة وحدة، صالح 24 ساعة، موجود في فضاءو على virement.tn). الرمز هاذا يغنيه على كتابة رقم بطاقة: يثبّت الموافقة.
3. السيرفر متاعك يعمل الفاتورة بالـAPI، ويوثّق الطلب بالمفتاح متاعك في الـheader X-Api-Key. الرد يقول أنّ الفاتورة مؤكّدة: الطلب التجاري ملتزم بيه.
4. المشتري يعمل التحويل من تطبيق البنك متاعو للـRIB المثبّت متاعك.
5. البنك يأكّد، وvirement.tn تبعث الـWebhook الموقّع للسيرفر متاعك. هاذي هي الإشارة باش تحرّر الطلب.

شنوّة تحتاج قبل ما تبدا

• حساب تاجر نشيط على virement.tn.
• RIB مثبّت: من غيرو إنشاء الفواتير يتّرفض.
• مفتاح API، يتعمل من الإعدادات ← مفاتيح API (ويلزم دور المسيّر). المفتاح وسرّ إمضاء الـWebhook يظهروا مرّة وحدة برك: احتفظ بيهم في جهة السيرفر.

الأخطاء اللي لازم تتفاداها

• تحرير الطلب وقت رد الـAPI. هاذا أخطر غلطة: التحويل ما تمّش بعد.
• تستدعي الـAPI من المتصفّح. المفتاح متاع الـAPI لازم يبقى على السيرفر متاعك.
• ما تتثبّتش من إمضاء الـWebhook. من غيرو، أي واحد ينجّم يقلّد تأكيد.
• ما تخلّيش المعالجة idempotent. احتياطًا، اعمل باش استلام نفس التأكيد زوز مرّات ما يخرّب حتى حاجة (تحرير طلب متحرّر من قبل لازم ما يعمل حتى أثر).
• تنسى حالة «ما تخلّصش أبدًا». توقّع انتهاء صلاحية الطلبات اللي تستنّى تحويل ولا إلغاءها.

علاش تعرض التحويل البنكي زيادة على البطاقة

• ما فماش عمولات بطاقات.
• ما فماش بيانات بطاقة تتعامل معاها ولا تحميها.
• خيار طبيعي للحرفاء اللي ما يحبّوش يكتبوا البطاقة متاعهم على الإنترنت.

موش لازم تختار: التحويل البنكي ينجّم يكمّل البطاقة. ومقارنتنا بين التحويل والبطاقة والاقتطاع تعاونك تقرّر على حسب المبيعات متاعك.

باش تزيد تعرف

صفحة الربط تلخّص المبدأ. والمرجع التقني الكامل — الـendpoints والصيغ والبيئة التجريبية — يتعطى مباشرة للشركاء اللي في طور الربط.