Tahseel IQ Logo

Help: Payment Gateways

Connecting First Iraqi Bank (FIB) to Tahseel IQ

To accept FIB payments through Tahseel IQ, you need FIB payment gateway API credentials for your business account. These credentials are issued by First Iraqi Bank and are linked directly to your own FIB account or terminal. You can use them in Tahseel IQ and in any other website or app you own. Tahseel IQ never touches your funds - money moves from the customer straight to your FIB account using your Client ID and Secret ID.

Before you continue, remember:

  • API credentials are unique IDs and secrets that prove your business is initiating each payment.
  • You own these credentials and can also use them on your own websites or applications.
  • Tahseel IQ never handles your funds. Customers pay directly into your wallet or bank account.

1. What you need before you start

  • An active FIB business account or terminal that can receive online payments.
  • Permission from FIB to use live (production) API credentials for that account.

2. Request live API credentials from FIB

FIB will give you two main values, often called API credentials:

  • Client ID
  • Secret ID

These credentials identify your business when Tahseel IQ initiates a payment with FIB on your behalf.

To request these credentials, fill FIB's integration form:

Open the FIB integration form

In the form, use your normal business details (name, city, contact, website). In any "Details" or "Notes" field, you can write:

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

If FIB asks you for a Callback or Status URL, provide this endpoint:

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. Enter your FIB credentials in Tahseel IQ

After FIB sends you your live API credentials:

  1. Sign in to Tahseel IQ.
  2. Go to Settings > Payment Gateways > FIB > Settings.
  3. Fill Client ID with the value provided by FIB.
  4. Fill Secret ID with the value provided by FIB.
  5. Turn on Enable FIB Payments.
  6. Click Save Configuration.

When customers choose FIB, the funds move directly to your FIB account. Tahseel IQ only generates and tracks the payment - it never receives or holds your money.

Connecting First Iraqi Bank (FIB) to Tahseel IQ | Tahseel IQ