maib MIA QR API
EN
EN
  • Overview
    • General Technical Specifications
    • MIA QR Types
  • Endpoints
    • Authentication
      • Obtain Authentication Token
    • Payment Initiation
      • Create QR Code (Static, Dynamic)
      • Create Hybrid QR Code
        • Create Extension for QR Code by ID
    • Payment Cancellation
      • Cancel Active QR (Static, Dynamic)
      • Cancel Active QR Extension (Hybrid)
    • Payment Refund
      • Refund Completed Payment
    • Information Retrieval (GET)
      • Display List of QR Codes with Filtering Options
      • Retrieve QR Details by ID
      • Retrieve List of Payments with Filtering Options
      • Retrieve Payment Details by ID
  • Payment Simulation (Sandbox)
  • Notifications on Callback URL
  • Errors
    • API Errors
    • HTTP Status Codes
  • Glossary
  • maib e-commerce API
Powered by GitBook
On this page
  1. Endpoints
  2. Information Retrieval (GET)

Retrieve QR Details by ID

GET /v2/mia/payments/{payId}

This endpoint allows retrieving the details of a payment using its unique identifier (payId). The returned data includes information such as the paid amount, commission, payment status, payer details, and more. The same type of information can also be received automatically through the callback mechanism.


Request parameter (path)

Name
Type
Required
Description

payId

string (guid)

Yes

Unique payment identifier


Response parameters

Name
Type
Description

result.payId

string (guid)

Unique payment identifier

result.referenceId

string (15)

RRN code of the instant payment service

result.qrId

string (guid)

QR code identifier associated with the payment

result.extensionId

string (guid)

Associated QR extension identifier

result.orderId

string (100)

Merchant order identifier

result.amount

number (decimal)

Payment amount

result.commission

number (decimal)

Applied commission

result.currency

string (enum)

Payment currency (e.g., MDL, format ISO 4217)

result.description

string (500)

Order description

result.payerName

string (200)

Abbreviated name of the payer

result.payerIban

string (100)

Payer’s IBAN

result.status

string (enum)

Payment status (Executed, Refunded)

result.executedAt

string (datetime)

Payment execution time (ISO 8601-1:2019 format)

result.refundedAt

string (datetime)

Payment refund time (if applicable, ISO 8601-1:2019 format)

result.terminalId

string (100)

Terminal identifier provided by the bank

ok

boolean

Request processing status (true if no errors occurred)

errors[]

array

Error list (if ok = false)

errors[].errorCode

string

Error code

errors[].errorMessage

string

Error description


Example response

{
  "result": {
    "payId": "123e4567-e89b-12d3-a456-426614174000",
    "referenceId": "QR000123456789",
    "qrId": "789e0123-f456-7890-a123-456789012345",
    "extensionId": "40e6ba44-7dff-48cc-91ec-386a38318c68",
    "amount": 50.00,
    "commission": 0.50,
    "currency": "MDL",
    "description": "Payment for order #123",
    "payerName": "John D.",
    "payerIban": "MD24AG00225100013104168",
    "status": "Executed",
    "executedAt": "2024-08-05T10:32:28+03:00",
    "terminalId": "P011111"
  },
  "ok": true
}

PreviousDisplay List of QR Codes with Filtering OptionsNextRetrieve List of Payments with Filtering Options

Last updated 1 day ago