[{"data":1,"prerenderedAt":132},["ShallowReactive",2],{"page:\u002Far\u002Fapi-integration":3},{"id":4,"title":5,"body":6,"cta":107,"description":108,"extension":109,"eyebrow":110,"faq":111,"h1":121,"key":122,"lead":123,"meta":124,"navigation":125,"path":126,"rawbody":127,"schemaType":107,"seo":128,"stem":129,"updated":130,"__hash__":131},"pages_ar\u002Far\u002Fapi-integration.md","الربط بالـAPI: اقبل الدفع بالتحويل البنكي",{"type":7,"value":8,"toc":97},"minimark",[9,25,30,33,37,50,54,62,66,69,73,76,85],[10,11,12],"callout",{},[13,14,15,19,20,24],"p",{},[16,17,18],"strong",{},"شنوّة اللي virement.tn موش هو",": بوابة دفع بالبطاقة. ما فماش صفحة دفع مستضافة ولا إعادة توجيه ولا رد «مخلّص» في آخر طلب الـAPI. وقت اللي يرجع الطلب، الطلب التجاري موش مخلّص — هو ",[21,22,23],"em",{},"ملتزم بيه",". تحرّروه وقت اللي يوصل الـWebhook، موش قبل.",[26,27,29],"h2",{"id":28},"مسار-المشتري","مسار المشتري",[31,32],"integration-flow",{},[26,34,36],{"id":35},"شنوّة-تحتاج","شنوّة تحتاج",[38,39,40,44],"ul",{},[41,42,43],"li",{},"حساب تاجر نشيط على virement.tn.",[41,45,46,49],{},[16,47,48],{},"RIB مثبّت"," مربوط بالحساب هذا — من غيرو إنشاء الفواتير يتّرفض. التثبّت يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← RIB).",[26,51,53],{"id":52},"مبدأ-التوثيق","مبدأ التوثيق",[13,55,56,57,61],{},"كل طلب يحمل مفتاح API في الـheader ",[58,59,60],"code",{},"X-Api-Key",". المفتاح يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← مفاتيح API ← إنشاء مفتاح، ويلزم دور المسيّر) ومربوط بالحساب متاعك: تنجّم تفوتر كان لروحك. المفتاح وسرّ إمضاء الـWebhook يظهروا مرّة وحدة برك وقت الإنشاء — والمفتاح تنجّم تلغيه في أي وقت.",[26,63,65],{"id":64},"رمز-التحقق","رمز التحقق",[13,67,68],{},"هو المحور الأساسي في المسار: يثبّت موافقة المشتري ويغنيك على كتابة رقم بطاقة. المشتري يلقاه في فضاءو الخاص على virement.tn («رمز التحقق متاعي») — يعني الاستمارة متاعك تطلب منّو زوز حقول برك: نمرة التليفون متاعو والرمز هذا. الرمز يتستعمل مرّة وحدة وتنتهي صلاحيتو بعد 24 ساعة.",[26,70,72],{"id":71},"webhook-التأكيد","Webhook التأكيد",[13,74,75],{},"وقت اللي بنك المشتري يأكّد أنّ التحويل تنفّذ، virement.tn تعلّم عنوان الـWebhook متاعك (اللي حدّدتو وقت إنشاء المفتاح) بحمولة موقّعة — الإشارة هاذي، وهي وحدها، هي اللي لازم تطلق تسليم السلعة ولا الخدمة المطلوبة.",[13,77,78,79,84],{},"باش تعرف كيفاش تخدم المنصّة بصفة عامة، شوف ",[80,81,83],"a",{"href":82},"\u002Far\u002Fhow-it-works","كيفاش يخدم",".",[13,86,87,88,92,93,84],{},"باش تاخذ المرجع التقني والدخول للبيئة التجريبية، ",[80,89,91],{"href":90},"\u002Far\u002Fcontact","اتصل بينا",". دليل خطوة بخطوة: ",[80,94,96],{"href":95},"\u002Far\u002Fblog\u002Faccept-bank-transfer-payments-on-your-website","قبول الدفع بالتحويل البنكي في المتجر الإلكتروني متاعك",{"title":98,"searchDepth":99,"depth":99,"links":100},"",3,[101,103,104,105,106],{"id":28,"depth":102,"text":29},2,{"id":35,"depth":102,"text":36},{"id":52,"depth":102,"text":53},{"id":64,"depth":102,"text":65},{"id":71,"depth":102,"text":72},null,"اعتمد virement.tn كوسيلة دفع: تحويل بنكي مباشر، رمز تحقق، وWebhook موقّع — بلا بوابة بطاقات وبلا إعادة توجيه.","md","للمطوّرين",[112,115,118],{"q":113,"a":114},"طلب الـAPI متاع إنشاء الفاتورة يأكّد الخلاص؟","لا. وقت اللي يرجع الرد، الطلب ملتزم بيه أما موش مخلّص. ما يتحرّرش كان وقت اللي يوصل الـWebhook متاع التأكيد، اللي يعلّم أنّ البنك أكّد التحويل.",{"q":116,"a":117},"كيفاش يتعمل التوثيق متاع الطلب؟","بمفتاح API يتبعث في الـheader اللي اسمو X-Api-Key، ويتعمل من الفضاء متاعك على virement.tn (الإعدادات، مفاتيح API). المفتاح مربوط بالحساب متاعك: تنجّم تفوتر كان لروحك.",{"q":119,"a":120},"وين نلقى المرجع التقني الكامل؟","يتعطى مباشرة للشركاء اللي في طور الربط، مع الـendpoints والصيغ والبيئة التجريبية. اكتبولنا من صفحة اتصل بينا باش تاخذوه.","اعتمد virement.tn كوسيلة دفع في المنصّة متاعك","integration-partenaires","الحرفاء متاعك يخلّصوك بتحويل بنكي من تطبيق البنك متاعهم — بلا رقم بطاقة يتكتب، وبلا عمولات بطاقات عليك.",{},true,"\u002Far\u002Fapi-integration","---\nkey: \"integration-partenaires\"\ntitle: \"الربط بالـAPI: اقبل الدفع بالتحويل البنكي\"\ndescription: \"اعتمد virement.tn كوسيلة دفع: تحويل بنكي مباشر، رمز تحقق، وWebhook موقّع — بلا بوابة بطاقات وبلا إعادة توجيه.\"\neyebrow: \"للمطوّرين\"\nh1: \"اعتمد virement.tn كوسيلة دفع في المنصّة متاعك\"\nlead: \"الحرفاء متاعك يخلّصوك بتحويل بنكي من تطبيق البنك متاعهم — بلا رقم بطاقة يتكتب، وبلا عمولات بطاقات عليك.\"\nupdated: \"2026-09-19\"\nfaq:\n  - q: \"طلب الـAPI متاع إنشاء الفاتورة يأكّد الخلاص؟\"\n    a: \"لا. وقت اللي يرجع الرد، الطلب ملتزم بيه أما موش مخلّص. ما يتحرّرش كان وقت اللي يوصل الـWebhook متاع التأكيد، اللي يعلّم أنّ البنك أكّد التحويل.\"\n  - q: \"كيفاش يتعمل التوثيق متاع الطلب؟\"\n    a: \"بمفتاح API يتبعث في الـheader اللي اسمو X-Api-Key، ويتعمل من الفضاء متاعك على virement.tn (الإعدادات، مفاتيح API). المفتاح مربوط بالحساب متاعك: تنجّم تفوتر كان لروحك.\"\n  - q: \"وين نلقى المرجع التقني الكامل؟\"\n    a: \"يتعطى مباشرة للشركاء اللي في طور الربط، مع الـendpoints والصيغ والبيئة التجريبية. اكتبولنا من صفحة اتصل بينا باش تاخذوه.\"\n---\n\n::callout\n**شنوّة اللي virement.tn موش هو**: بوابة دفع بالبطاقة. ما فماش صفحة دفع مستضافة ولا إعادة توجيه ولا رد «مخلّص» في آخر طلب الـAPI. وقت اللي يرجع الطلب، الطلب التجاري موش مخلّص — هو *ملتزم بيه*. تحرّروه وقت اللي يوصل الـWebhook، موش قبل.\n::\n\n## مسار المشتري\n\n::integration-flow\n::\n\n## شنوّة تحتاج\n\n- حساب تاجر نشيط على virement.tn.\n- **RIB مثبّت** مربوط بالحساب هذا — من غيرو إنشاء الفواتير يتّرفض. التثبّت يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← RIB).\n\n## مبدأ التوثيق\n\nكل طلب يحمل مفتاح API في الـheader `X-Api-Key`. المفتاح يتعمل من الفضاء متاعك على virement.tn (الإعدادات ← مفاتيح API ← إنشاء مفتاح، ويلزم دور المسيّر) ومربوط بالحساب متاعك: تنجّم تفوتر كان لروحك. المفتاح وسرّ إمضاء الـWebhook يظهروا مرّة وحدة برك وقت الإنشاء — والمفتاح تنجّم تلغيه في أي وقت.\n\n## رمز التحقق\n\nهو المحور الأساسي في المسار: يثبّت موافقة المشتري ويغنيك على كتابة رقم بطاقة. المشتري يلقاه في فضاءو الخاص على virement.tn («رمز التحقق متاعي») — يعني الاستمارة متاعك تطلب منّو زوز حقول برك: نمرة التليفون متاعو والرمز هذا. الرمز يتستعمل مرّة وحدة وتنتهي صلاحيتو بعد 24 ساعة.\n\n## Webhook التأكيد\n\nوقت اللي بنك المشتري يأكّد أنّ التحويل تنفّذ، virement.tn تعلّم عنوان الـWebhook متاعك (اللي حدّدتو وقت إنشاء المفتاح) بحمولة موقّعة — الإشارة هاذي، وهي وحدها، هي اللي لازم تطلق تسليم السلعة ولا الخدمة المطلوبة.\n\nباش تعرف كيفاش تخدم المنصّة بصفة عامة، شوف [كيفاش يخدم](\u002Far\u002Fhow-it-works).\n\nباش تاخذ المرجع التقني والدخول للبيئة التجريبية، [اتصل بينا](\u002Far\u002Fcontact). دليل خطوة بخطوة: [قبول الدفع بالتحويل البنكي في المتجر الإلكتروني متاعك](\u002Far\u002Fblog\u002Faccept-bank-transfer-payments-on-your-website).\n",{"title":5,"description":108},"ar\u002Fapi-integration","2026-09-19","012urkFyg4ZEcAGlxUlFkl0ogh-TV4VImizfaHFag1E",1789922122448]