QR Code Payments

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

decimal

required

The transaction amount in millimes

integer

required

Your merchant ID.

uuid

A unique ID for the operation. If not provided, a random UUID will be generated.

boolean

default:"false"

Set to true to receive a slug representation of the QR code.

Headers

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"
}

{
  "success": false,
  "code": 400,
  "message": "<parameter> is required"
}

{
  "success": false,
  "code": 403,
  "message": "Forbidden"
}

{
  "success": false,
  "code": 404,
  "message": "precondition fails, code 3"
}

{
  "success": false,
  "code": 500,
  "message": "Unexpected Error"
}

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

uuid

required

The operation_uuid of the dynamic QR code.

Headers

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"
    }
  ]
}

{
  "success": false,
  "code": 400,
  "message": "<parameter> is required"
}

{
  "success": false,
  "code": 403,
  "message": "Forbidden"
}

{
  "success": false,
  "code": 500,
  "message": "Unexpected Error"
}

{
  "success": false,
  "code": 503,
  "message": "Service unavailable"
}

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

integer

required

Your merchant ID.

datetime

The start date of the transaction history.

datetime

The end date of the transaction history.

integer

The number of items per page.

Headers

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"
    }
  ]
}

{
  "success": false,
  "code": 400,
  "message": "<parameter> is required"
}

{
  "success": false,
  "code": 403,
  "message": "Forbidden"
}

{
  "success": false,
  "code": 404,
  "message": "precondition fails, code 3"
}

{
  "success": false,
  "code": 500,
  "message": "Unexpected Error"
}

Introduction

Basic Payment Flows

Advanced payment flows

Partner APIs

Payment Plugins

Business Dashboard

Environments

Changelog

Generate Custom QR Code

Query Parameters

Headers

Verify Custom Transaction

Query Parameters

Headers

History of Purchases

Query Parameters

Headers

​Generate Custom QR Code

​Query Parameters

​Headers

​Verify Custom Transaction

​Query Parameters

​Headers

​History of Purchases

​Query Parameters

​Headers

Generate Custom QR Code

Query Parameters

Headers

Verify Custom Transaction

Query Parameters

Headers

History of Purchases

Query Parameters

Headers