POST /set-qr-config: Attach Amount Configuration to QR Code

Use the /set-qr-config endpoint to associate one or more Algerian Dinar (DZD) amounts with a static QR code. If you call this endpoint again with the same token, the previous configuration is replaced entirely. When multiple amounts are configured, the customer selects one on the payment platform. When a single amount is configured, the platform skips selection and displays that amount directly.

Request

Method: POST
URL: {api_base_url}/set-qr-config
Headers:

Header	Value
`Content-Type`	`application/json`
`x-api-key`	`<your_api_key>`

Your api_base_url and API key are both retrieved from the Mizaniya Partner Platform.

Body parameters

string

required

The QR code identifier retrieved from the Partner Platform.

number[]

required

An array of DZD amounts. Supply a single amount to skip the customer selection step. Must contain at least one positive number.

string | null

An ISO 8601 timestamp indicating when the configuration expires. Pass null or omit for a permanent configuration.

boolean

required

When true, the configuration is automatically cleared after the first successful payment.

Code examples

curl -X POST "{api_base_url}/set-qr-config" \
  -H "Content-Type: application/json" \
  -H "x-api-key: <your_api_key>" \
  -d '{
    "token": "8f2c1a52-9be4-4d0e-b1a7-3f65c02a9e11",
    "amounts": [1000, 2000, 3000],
    "expiresAt": "2026-08-01T00:00:00.000Z",
    "singleUse": false
  }'

const response = await fetch(`${apiBaseUrl}/set-qr-config`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': apiKey,
  },
  body: JSON.stringify({
    token: '8f2c1a52-9be4-4d0e-b1a7-3f65c02a9e11',
    amounts: [1000, 2000, 3000],
    expiresAt: '2026-08-01T00:00:00.000Z',
    singleUse: false,
  }),
});

const data = await response.json();
console.log(data);

import requests

url = f"{api_base_url}/set-qr-config"
headers = {
    "Content-Type": "application/json",
    "x-api-key": api_key,
}
payload = {
    "token": "8f2c1a52-9be4-4d0e-b1a7-3f65c02a9e11",
    "amounts": [1000, 2000, 3000],
    "expiresAt": "2026-08-01T00:00:00.000Z",
    "singleUse": False,
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

Responses

200 — Success

{
  "statusCode": 200,
  "message": "QR configuration set successfully"
}

400 — Bad Request

{
  "statusCode": 400,
  "message": [
    "token must be a string",
    "amounts must contain at least 1 elements",
    "expiresAt must be a valid ISO 8601 date string",
    "singleUse must be a boolean value"
  ],
  "error": "Bad Request"
}

401 — Unauthorized

{
  "statusCode": 401,
  "message": "Unauthorized",
  "errorCode": "AUTH401_UNAUTHORIZED_ACCESS",
  "timestamp": "2026-07-13T09:00:00.000Z"
}

404 — QR Code Not Found

{
  "statusCode": 404,
  "message": "QR code not found",
  "errorCode": "QR_CODE404_NOT_FOUND",
  "timestamp": "2026-07-13T09:00:00.000Z",
  "details": {
    "token": "8f2c1a52-9be4-4d0e-b1a7-3f65c02a9e11"
  }
}

Always branch your error handling on the errorCode field, not the message string. Message wording may change between API versions.

Overview

Payments

Webhooks

Static QR Codes

POST /set-qr-config: Attach Amount Configuration to QR Code

Request

Body parameters

Code examples

Responses

200 — Success

400 — Bad Request

401 — Unauthorized

404 — QR Code Not Found

​Request

​Body parameters

​Code examples

​Responses

​200 — Success

​400 — Bad Request

​401 — Unauthorized

​404 — QR Code Not Found

Request

Body parameters

Code examples

Responses

200 — Success

400 — Bad Request

401 — Unauthorized

404 — QR Code Not Found