Tahseel IQ Logo

المساعدة: بوابات الدفع

ربط بنك العراق الأول (FIB) مع تحصيل IQ

لتحصيل مدفوعات FIB عبر تحصيل IQ، تحتاج إلى قيم Client ID و Secret ID الخاصة بحسابك التجاري. تصدر هذه القيم من بنك العراق الأول وترتبط مباشرة بحسابك أو جهازك. يمكنك استخدامها داخل تحصيل IQ أو أي موقع أو تطبيق آخر تملكه. تحصيل IQ لا يلمس أموالك؛ تنتقل مباشرة من العميل إلى حسابك في FIB.

قبل أن تتابع، تذكّر:

  • القيم السرية (مثل معرّف التاجر والرمز السري للتاجر أو Client ID و Secret ID) هي معرّفات تثبت لبوابة الدفع أن نشاطك التجاري هو من يرسل كل طلب دفع.
  • أنت تملك هذه البيانات ويمكنك استخدامها أيضاً في موقعك الإلكتروني أو تطبيقاتك الأخرى.
  • تحصيل IQ لا يتعامل مع أموالك أبداً. يدفع عملاؤك مباشرة إلى محفظتك أو حسابك البنكي.

1. ما الذي تحتاجه قبل البدء

  • حساب أو جهاز FIB تجاري فعّال يستقبل المدفوعات عبر الإنترنت.
  • موافقة من FIB لتفعيل مفاتيح لايف (Client ID و Secret ID) لهذا الحساب.

2. اطلب مفاتيح لايف من FIB

سيزوّدك FIB بقيمتين رئيسيتين لتأكيد الهوية:

  • Client ID
  • Secret ID

هذه البيانات تعرّف نشاطك التجاري عندما يبادر تحصيل IQ بعملية دفع نيابةً عنك مع FIB.

لطلب هذه البيانات، عبئ نموذج تكامل FIB:

افتح نموذج تكامل FIB

في النموذج اكتب بيانات نشاطك المعتادة (الاسم، المدينة، معلومات التواصل، الموقع). في خانة "التفاصيل" أو "الملاحظات" يمكنك كتابة:

We want to accept online payments through the FIB payment gateway and will integrate it using the Tahseel IQ platform for invoicing and payment links. Please provide LIVE (production) API credentials (Client ID and Secret ID) for our account.

رابط الإشعار / حالة العملية

إذا طلب منك FIB رابط إشعار أو حالة التكامل، زوده بهذا المسار:

https://tahseeliq.com/api/pay-fib/callback

Sample answers for the FIB integration checklist

If the FIB team shares their checklist, you can reuse these Tahseel IQ answers. Replace the fields that say "your..." with your real business details.

Section A – Business account & purpose validation

  • Business Name → Your business name.
  • Business Activity → Your business activity.
  • Intended use case for our payment solution → Explain that you collect invoice and payment-link payments through Tahseel IQ.

Section B – Security verification

  • Do you use statuscallbackurl? → Yes.
  • Confirm functional public endpoint with SSL certificate (HTTPS) used → Yes, confirmed.
  • Provide your statuscallbackurl endpoint → https://tahseeliq.com/api/pay-fib/callback
  • The callback URL needs to be hosted on a Static IP Server → Dynamic (handled by Tahseel IQ).
  • If it’s Static provide the Static IP Server → N/A.

Section C – UI/UX check

  • Is the Payment Gateway section visual and highlighted? → Yes, FIB is shown clearly on Tahseel IQ payment pages.
  • Is the Payment Gateway reachable to the users? → Yes.

Section D – Payment status workflow

  • Suggested workflow confirmation → Answer: "Yes, I accept and use this workflow."
  • Workflow details → Follow FIB’s callback + check-payment-status cycle (wait 15 seconds for a callback, then poll every 5 seconds until it resolves).
  • Do you use our API or SDK/Plugin? → API.
  • If you only use our SDK/Plugin, specify the type → Not applicable / leave blank.
  • Do you use Check Payment Status endpoint? → Yes.
  • Do you use refund endpoint? → No (refunds handled directly with FIB).
  • Do you use cancel endpoint? → No.

Section F – Website & app information

  • Website URLs → Your business URL (if available).
  • Application URLs (iOS/Android) → N/A.
  • Technical stack → Tahseel IQ web app (Next.js) with secure APIs.
  • Technical team contacts → Your technical team email or point of contact.

3. أدخل Client ID و Secret ID داخل تحصيل IQ

بعد أن يرسل لك FIB مفاتيح لايف الخاصة بك:

  1. سجّل الدخول إلى تحصيل IQ.
  2. اذهب إلى الإعدادات > بوابات الدفع > FIB > الإعدادات.
  3. أدخل Client ID الذي استلمته من FIB.
  4. أدخل Secret ID الذي استلمته من FIB.
  5. فعّل خيار تفعيل مدفوعات FIB.
  6. اضغط على حفظ الإعدادات.

عندما يختار العميل الدفع عبر FIB ستذهب الأموال مباشرة إلى حسابك في FIB. تحصيل IQ ينشئ الرابط ويتابع الحالة فقط - ولا يستلم أو يحتفظ بأي مبلغ.

ربط بنك العراق الأول (FIB) مع تحصيل IQ | Tahseel IQ