Tahseel IQ Logo

یارمەتی: دەروازەکانی پارەدان

بەستنەوەی بانکە عێراقیە یەکەم (FIB) بە Tahseel IQ

بۆ وەرگرتنی پارە بە FIB، پێویستە بە ناسێنەرەکانی API ی دەروازەی پارەدان بۆ هەژمارە کارەبارەکەت. ئەم ناسێنەرە لە FIBەوە دەردەچن و ڕاستەوخۆ بە هەژمار یان تێرمیناڵەکەت پەیوەستن. دەتوانیت لە Tahseel IQ و هەر پلاتفۆرمێکی تر بەکار بهێنیت. Tahseel IQ هەرگیز پارە نابەستێت - پارە ڕاستەوخۆ بۆ هەژمارەکەت دەچێت.

پێش ئەوەی بەردەوام بیت، ئەمانە لەبیر مەکە:

  • ناسێنەری API وشە نەهێنییە تایبەتەکانن کە دڵنیایی دەدەن کارەبارەکەت داوای پارەدان دەکات.
  • تۆ خاوەنی ئەم ناسێنەرەیت و دەتوانیت لە ماڵپەڕ یان ئەپەکانی تر بیکاری بهێنیت.
  • Tahseel IQ هەرگیز پارە ناگیردێت؛ پارە ڕاستەوخۆ بۆ جزدان یان هەژمارە بانکیەکەت دەچێت.

1. پێویستییەکان پێش دەستپێکردن

  • هەژمار یان تێرمیناڵێکی چالاک لە FIB بۆ پارەدانە ئۆنلاین.
  • مۆڵەت لە FIB بۆ بەکارهێنانی کریدێنشیالی پرۆدەکشن بۆ ئەو هەژمارە.

2. داوای کریدێنشیالی پرۆدەکشن لە FIB بکە

FIB دوو بەها پێدەدات کە بە ناسێنەرەکانی API ناسراون:

  • Client ID
  • Secret ID

ئەم ناسێنەرە ناسناسی کارەبارەکەت دەکەن کاتێک Tahseel IQ داخوازی پارەدان بۆ تۆ دەکات.

بۆ داواکاری، فۆرمەی تێکەڵکردنی 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.

Callback / Status URL

ئەگەر FIB هەنگاوەکانی Callback یان دۆخ داوا کرد، ئەم ناونیشانە بنووسە:

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. ناسێنەرەکانی FIB لە Tahseel IQ داخڵ بکە

دوای وەرگرتنی کریدێنشیالی پرۆدەکشن:

  1. بچۆ ژوورەوە بۆ Tahseel IQ.
  2. بڕۆ بۆ Settings > Payment Gateways > FIB > Settings.
  3. Client ID وەک لە FIB وەرگرتویت بنووسە.
  4. Secret ID داخڵ بکە.
  5. Enable FIB Payments چالاک بکە.
  6. Save Configuration دابگرە.

کاتێک کڕیارەکان FIB دەستنیشان دەکەن پارە ڕاستەوخۆ بۆ هەژمارەکەت دەچێت و Tahseel IQ تەنها لینکی پارەدان دروست و چاودێری دەکات.

بەستنەوەی FIB بە Tahseel IQ | Tahseel IQ