---
title: "QiCard payment gateway setup"
description: "QiCard, QiCard payment gateway, Iraq card payments, QiCard integration, QiCard merchant account, Iraq payment processing"
url: https://support.onde.app/en/articles/13610149-qicard-payment-gateway-setup
collection: "Payment Gateways Setup"
updated: 2026-09-22
language: en
alternates: [ru, es]
---

# QiCard payment gateway setup

QiCard, QiCard payment gateway, Iraq card payments, QiCard integration, QiCard merchant account, Iraq payment processing

QiCard is integrated for **Iraq**.

Steps to activate QiCard for your company:

**1\. Request QiCard account from** [](https://montypay.com/documentation/)[**https://qi.iq/en/home**](https://qi.iq/en/home) 

QiCard contacts are:

-   qicard@qi.iq (general)
    
-   fatimah.alkhateeb@qi.iq (contact to start merchant onboarding)
    
-   Nora Jafar <nora.jafar@qi.iq (technical integration support)
    

**2\. Create a QiCard gateway entity in your Brand panel on Merchant level: go to Brand > Merchant > Payment gateways > Add > Credit & debit cards > QiCard.**

![](https://staticfiles.gleap.io/gattachments/BCXjYGd2rk6ctVk5LvZaqnBtEgP5YviUoZuxl89GXeyyUVmZ6oLqx5FOZxEZWzM1GniejERittW.png)

After that fill out payment gateway credentials and don't forget to save the changes!

![](https://files.gleap.io/pf/gattachments/QGFUWE0gtKBUm8lalt7jNFRB47mAa61AnXSD66kbmUXrMZ88oClFB13OU6Ppmtr8l5QMTpRXtdw.png?v=1&k=a&s=api&e=1793750400&sig=WspNqOpV49aAHnCbMeasr5VANx1Dp1cD-wDNrbsL-KY)

**IMPORTANT**

**Mind that your default Public key value from the QiCard account can not be added to “Public key” field in the Payment gateway settings. The Public key has to be encoded via Base64 first .**

### **How to Encode a String in Base64**

You need to take your string (for example, a key, a `login:password` pair, or whatever value QiCard asks for) and convert it to Base64. Below are instructions for three systems. Choose yours.  
  
Option 1. macOS  
**1\. Open Terminal**

-   Press `Cmd + Space` to open Spotlight search.
    
-   Type `Terminal` and press `Enter`.
    
-   A window with a text prompt will open. This is the console.
    

**2\. Enter the command**  
  
bash

```javascript
echo -n 'your_string' | base64
```

Replace `your_string` with your own text and keep the quotes. For example:  
  
bash

```javascript
echo -n 'hello world' | base64
```

**3\. Press** `Enter`**.** The terminal will print the result:  

```javascript
aGVsbG8gd29ybGQ=
```

This is your encoded string. Select it with the mouse and copy it (`Cmd + C`).  
  
Option 2. Linux (Ubuntu, Debian, Mint, Fedora, etc.)  
**1\. Open the terminal**

-   The fastest way is the shortcut `Ctrl + Alt + T`.
    
-   Or find the "Terminal" app (Terminal / Konsole / GNOME Terminal) in your applications menu.
    

**2\. Enter the command**  
  
bash

```javascript
echo -n 'your_string' | base64 | tr -d '\n'
```

Example:  
  
bash

```javascript
echo -n 'hello world' | base64 | tr -d '\n'
```

**3\. Press** `Enter`**.** Result:  

```javascript
aGVsbG8gd29ybGQ=
```

Copy it with `Ctrl + Shift + C` (in a terminal, plain `Ctrl + C` does not copy).

> **If you see** `base64: command not found`**:** on minimal distributions (for example, Alpine) the utility may be missing. Install the `coreutils` or `busybox` package using your system's package manager, or contact your administrator.

  
  
Option 3. Windows (PowerShell)  
Windows has no `base64` command, but PowerShell can do the same thing.  
**1\. Open PowerShell**

-   Press the `Win` key (the one with the Windows logo).
    
-   Type `PowerShell`.
    
-   Select "Windows PowerShell" and press `Enter`.
    
-   A window with a blue (or black) background will open. This is the console.
    

**2\. Enter the command**  
  
powershell

```javascript
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_string"))
```

Example:  
  
powershell

```javascript
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("hello world"))
```

**3\. Press** `Enter`**.** Result:  

```javascript
aGVsbG8gd29ybGQ=
```

Copy it: select the text with the mouse and press `Ctrl + C` (or right-click → "Copy").  
  
Good to Know

-   **The** `-n` **flag is required** (macOS and Linux). It removes the trailing newline character. Without it, the newline gets encoded too and the result will be wrong.
    
-   **No extra spaces** at the beginning or end of your string. Spaces are encoded as well.
    
-   **If your string contains special characters** (`$`, `!`, backticks), use **single** quotes `' '` on macOS and Linux, as in the examples above. This prevents the shell from interpreting those characters.
    
-   **Copy the whole result**, including any `=` signs at the end. They are part of the encoded string.
    
-   **Quick check:** encode `hello world`. You should get `aGVsbG8gd29ybGQ=`.
    

**3\. Enable QiCard gateway in MyHub for required companies: My hub > Company settings > Payment gateways > Edit > in "Credit & debit cards" field choose the payment gateway that you've created > Save. The flow is shared in the** [**video**](https://support.onde.app/en/articles/5591902-adding-a-payment-gateway.md)**.**

**4\. Do some live testing with credit cards.**

One may check that:

\- on trip payments with credit card;

\- [driver wallet](https://support.onde.app/en/articles/1047523-driver-balance-and-automated-driver-billing-logic.md) and [customer wallet](https://support.onde.app/en/articles/6254228-customer-wallet.md) top-ups with credit cards.

Add your credit card with QiCard as below:

![](https://staticfiles.gleap.io/gattachments/Qfs29wxtGrd1ncWNVeQx4DDMmSb5NGv4lL8FRDFFsLsw2UNDrSWXpmidrV7Yw7HPm2Ad4q8mCwL.png)

![](https://staticfiles.gleap.io/gattachments/lclOZC2xPsN4I9QMXPAzrxHwTP9KuTeqO9hxCiMftOaqiohEt4uX1X4AOWbE0rTWw4wqFIO8ha9.png)

In case of any errors with card verifications or transactions emerge, kindly report to support@onde.app.