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

Attach one or more DZD payment amounts to a static Mizaniya Pay QR code, with optional expiry and single-use settings.

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

token · string · required

The QR code identifier retrieved from the Partner Platform.

amounts · number[] · required

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

expiresAt · string | null

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

singleUse · boolean · required

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

Code examples

cURL

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

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.