Tahseel IQ Logo

Help: Payment Gateways

Connecting ZainCash to Tahseel IQ

To accept ZainCash payments through Tahseel IQ, you need ZainCash API credentials for your wallet. These credentials are issued by ZainCash and are linked directly to your own wallet account. You can use them in Tahseel IQ and in any other website or app you build. Tahseel IQ never holds your money - all funds go straight from your customer to your ZainCash wallet.

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 ZainCash wallet that you want to receive payments into.
  • Permission from ZainCash to use live (production) API credentials for that wallet.

Keep your ask simple when you contact ZainCash. You just need live credentials that are linked to your wallet.

2. Ask ZainCash for live API credentials

ZainCash will give you three pieces of information, often called API credentials:

  • Merchant ID
  • Wallet number (MSISDN)
  • Merchant secret / API secret

These values prove to ZainCash that a payment request is coming from your business.

To request your live credentials, send an email to ZainCash using the template below.

Email template

To: bd@zaincash.iq

Cc: support@zaincash.iq

Subject: ZainCash Live API Credentials Request - <Your Business Name>

Dear ZainCash team,

I would like to request LIVE (production) API credentials for my ZainCash wallet so I can accept online payments.

Business name: <YOUR BUSINESS NAME>
Wallet phone number: <07XX XXX XXXX>
City: <CITY>
Website / social links: <LINKS>

I will use these credentials with:
- Tahseel IQ (invoicing and payment links platform)
- and optionally on my own website or application.

Please let me know the next steps to get my live API credentials.

Thank you,
<Your full name>
<Phone>
<Email>

3. Enter your ZainCash credentials in Tahseel IQ

After ZainCash sends you your live credentials:

  1. Sign in to Tahseel IQ.
  2. Go to Settings > Payment Gateways > ZainCash > Settings.
  3. Fill Merchant ID with the value ZainCash sent you.
  4. Fill MSISDN (Wallet Number) with your wallet phone number.
  5. Fill Merchant Secret with your API secret.
  6. Turn on Enable ZainCash Payments.
  7. Click Update Configuration.

From now on, when a customer chooses ZainCash, the funds go directly to your ZainCash wallet. Tahseel IQ only generates and tracks the payment - it never receives or holds your money.

Connecting ZainCash to Tahseel IQ | Tahseel IQ