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)
qrId
string (guid)
Unique identifier of the QR code.
Response parameters
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