# الربط بالـAPI: اقبل الدفع بالتحويل البنكي

> اعتمد virement.tn كوسيلة دفع: تحويل بنكي مباشر، رمز تحقق، وWebhook موقّع — بلا بوابة بطاقات وبلا إعادة توجيه.

المصدر : https://virement.tn/ar/api-integration — آخر تحديث : 2026-09-19

**شنوّة اللي virement.tn موش هو**: بوابة دفع بالبطاقة. ما فماش صفحة دفع مستضافة ولا إعادة توجيه ولا رد «مخلّص» في آخر طلب الـAPI. وقت اللي يرجع الطلب، الطلب التجاري موش مخلّص — هو *ملتزم بيه*. تحرّروه وقت اللي يوصل الـWebhook، موش قبل.

## مسار المشتري

## شنوّة تحتاج

- حساب تاجر نشيط على virement.tn.
- **RIB مثبّت** مربوط بالحساب هذا — من غيرو إنشاء الفواتير يتّرفض. التثبّت يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← RIB).

## مبدأ التوثيق

كل طلب يحمل مفتاح API في الـheader `X-Api-Key`. المفتاح يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← مفاتيح API ← إنشاء مفتاح، ويلزم دور المسيّر) ومربوط بالحساب متاعك: تنجّم تفوتر كان لروحك. المفتاح وسرّ إمضاء الـWebhook يظهروا مرّة وحدة برك وقت الإنشاء — والمفتاح تنجّم تلغيه في أي وقت.

## رمز التحقق

هو المحور الأساسي في المسار: يثبّت موافقة المشتري ويغنيك على كتابة رقم بطاقة. المشتري يلقاه في فضاءو الخاص على virement.tn («رمز التحقق متاعي») — يعني الاستمارة متاعك تطلب منّو زوز حقول برك: نمرة التليفون متاعو والرمز هذا. الرمز يتستعمل مرّة وحدة وتنتهي صلاحيتو بعد 24 ساعة.

## Webhook التأكيد

وقت اللي بنك المشتري يأكّد أنّ التحويل تنفّذ، virement.tn تعلّم عنوان الـWebhook متاعك (اللي حدّدتو وقت إنشاء المفتاح) بحمولة موقّعة — الإشارة هاذي، وهي وحدها، هي اللي لازم تطلق تسليم السلعة ولا الخدمة المطلوبة.

باش تعرف كيفاش تخدم المنصّة بصفة عامة، شوف [كيفاش يخدم](/ar/how-it-works).

باش تاخذ المرجع التقني والدخول للبيئة التجريبية، [اتصل بينا](/ar/contact). دليل خطوة بخطوة: [قبول الدفع بالتحويل البنكي في المتجر الإلكتروني متاعك](/ar/blog/accept-bank-transfer-payments-on-your-website).

## أسئلة متكرّرة

### طلب الـAPI متاع إنشاء الفاتورة يأكّد الخلاص؟

لا. وقت اللي يرجع الرد، الطلب ملتزم بيه أما موش مخلّص. ما يتحرّرش كان وقت اللي يوصل الـWebhook متاع التأكيد، اللي يعلّم أنّ البنك أكّد التحويل.

### كيفاش يتعمل التوثيق متاع الطلب؟

بمفتاح API يتبعث في الـheader اللي اسمو X-Api-Key، ويتعمل من الفضاء متاعك على virement.tn (الإعدادات، مفاتيح API). المفتاح مربوط بالحساب متاعك: تنجّم تفوتر كان لروحك.

### وين نلقى المرجع التقني الكامل؟

يتعطى مباشرة للشركاء اللي في طور الربط، مع الـendpoints والصيغ والبيئة التجريبية. اكتبولنا من صفحة اتصل بينا باش تاخذوه.