Retrieve QR Details by ID

Endpoint: GET /v2/mia/qr/{qrId}

This method allows retrieving details of an existing QR code using the unique identifier qrId. The same type of information can also be received automatically through the callback mechanism.


Request parameter (path)

Name
Type
Description

qrId

string (guid)

Unique identifier of the QR code.


Response parameters

ield
Type
Description

result

object

Response object.

result.qrId

string (guid)

Unique QR code identifier.

result.extensionId

string (guid)

QR extension identifier.

result.orderId

string (100)

Merchant-side order identifier.

result.status

string (enum)

QR status. Possible values: Active, Inactive, Expired, Paid, Cancelled.

- Active – QR is active.

- Inactive – Static/Hybrid QR without payments in the last 30 days.

- Expired – Dynamic/Hybrid QR expired with no payment.

- Paid – QR has been paid.

- Cancelled – QR was cancelled.

result.type

string (enum)

QR type: Static, Dynamic, Hybrid.

result.url

string (1000)

QR URL. Format: HTTPS URL.

result.amountType

string (enum)

Amount type: Fixed, Controlled, Free.

result.amount

number (decimal)

Fixed amount (for fixed-type QR).

result.amountMin

number (decimal)

Minimum amount (for controlled-type QR).

result.amountMax

number (decimal)

Maximum amount (for controlled-type QR).

result.currency

string (enum)

Payment currency. Value: MDL (ISO 4217).

result.description

string (500)

Order description.

result.callbackUrl

string (1000)

Merchant callback URL for payment notification. Format: HTTPS URL.

result.redirectUrl

string (1000)

Redirect URL after payment (for web integration). Format: HTTPS URL.

result.createdAt

string (datetime)

QR code creation timestamp (ISO 8601-1:2019).

result.updatedAt

string (datetime)

Last status update timestamp.

result.expiresAt

string (datetime)

Expiry timestamp for dynamic/hybrid QR.

result.terminalId

string (100)

Terminal ID provided by the bank.

ok

boolean

Request processing status. true – successful, false – error occurred.

errors

array

Error list (if any).

errors.errorCode

string

Error code.

errors.errorMessage

string

Error description.


Example request

curl -G "https://api.example.com/v2/mia/qr/123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer {{access_token}}"

Example response

{
  "result": {
    "qrId": "123e4567-e89b-12d3-a456-426614174000",
    "extensionId": "40e6ba44-7dff-48cc-91ec-386a38318c68",
    "status": "Paid",
    "type": "Dynamic",
    "url": "https://example.com/qr/123e4567-e89b-12d3-a456-426614174000",
    "amountType": "Fixed",
    "amount": 50.00,
    "currency": "MDL",
    "description": "Order description",
    "callbackUrl": "https://example.com/callback",
    "redirectUrl": "https://example.com/success",
    "createdAt": "2029-10-22T10:32:28+03:00",
    "updatedAt": "2029-10-22T10:32:58+03:00",
    "expiresAt": "2029-10-22T10:33:28+03:00",
    "terminalId": "P011111"
  },
  "ok": true
}

Last updated