{
  "success": true,
  "code": 200,
  "qr_code": "iVBORw0KGgoAAAANSUhEUgAAAMgAAADIAQAAAACFI5MzAAABaklEQVR42u3aQW7DMAwFUP//p88j...",
  "operation_uuid": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
}
The endpoints defined in the next section require a special API key generated by Flouci upon request. These endpoints allow for the seemless integration of QR code payments within your external system without redirects or embedding of external pages. These APIs allow you to generate dynamic QR codes that Flouci wallets - or any other wallet licensed by the Central Bank of Tunisia - can scan and pay. You can simply display the QR code string provided to the client in digital or paper form. Wallet payments are verified and settled instantly, and will appear in your available balance within seconds.

​
Generate Custom QR Code

This API allows you to generate a custom QR code with a specified amount. 
curl -X GET '@IP/api/business/generate_custom_qr_code?amount=1000&merchant_id=123' \
  -H 'Authorization: Api-Key <YOUR_API_KEY>'

​
Query Parameters

​
amount_in_millimes
decimal
required
The transaction amount in millimes
​
merchant_id
integer
required
Your merchant ID.
​
operation_uuid
uuid
A unique ID for the operation. If not provided, a random UUID will be generated.
​
barcode
boolean
default:"false"
Set to true to receive a slug representation of the QR code.

​
Headers

​
Authorization
string
required
Your API key. Should be in the format Api-Key YOUR_API_KEY.
{
  "success": true,
  "code": 200,
  "qr_code": "iVBORw0KGgoAAAANSUhEUgAAAMgAAADIAQAAAACFI5MzAAABaklEQVR42u3aQW7DMAwFUP//p88j...",
  "operation_uuid": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
}

​
Verify Custom Transaction

This API allows you to verify the transaction associated with a dynamically generated QR code. 
curl -X GET 'https://@IP/api/business/custom_transaction/status?operation_uuid=a1b2c3d3-e5f6-7890-1234-567890abcdef' \
  -H 'Authorization: Api-Key <YOUR_API_KEY>'

​
Query Parameters

​
operation_uuid
uuid
required
The operation_uuid of the dynamic QR code.

​
Headers

​
Authorization
string
required
Your API key. Should be in the format Api-Key <YOUR_API_KEY>.
{
  "success": true,
  "code": 200,
  "transactions": [
    {
      "transaction_unique_id": "t1u2n3i4q5u6e7i8d9",
      "time": "2025-08-02T12:00:00Z",
      "amount": 1000,
      "channel": "Flouci"
    }
  ]
}

​
History of Purchases

This API allows you to fetch the transaction history of a merchant. 
curl -X GET '@IP/api/business/custom_transactions/history?merchant_id=123' \
  -H 'Authorization: Api-Key YOUR_API_KEY'

​
Query Parameters

​
merchant_id
integer
required
Your merchant ID.
​
start_date
datetime
The start date of the transaction history.
​
end_date
datetime
The end date of the transaction history.
​
size
integer
The number of items per page.

​
Headers

​
Authorization
string
required
Your API key. Should be in the format Api-Key YOUR_API_KEY.
{
  "success": true,
  "code": 200,
  "result": [
    {
      "transaction_unique_id": "t1u2n3i4q5u6e7i8d9",
      "time": "2025-08-02T12:00:00Z",
      "amount": 1000,
      "channel": "Flouci"
    }
  ]
}