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 Payment Details by ID

GET /v2/mia/payments/{payID}

This endpoint returns the details of a specific payment, identified by the payId.


URL Parameters (path)

Parameter
Type
Required
Description

payId

string(guid)

Yes

Unique identifier of the payment.


Request example

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

Response structure

Object result

Field
Type
Description

payId

string(guid)

Unique ID of the payment.

referenceId

string(15)

RRN code from the instant payments service.

qrId

string(guid)

ID of the QR code associated with the payment.

extensionId

string(guid)

ID of the QR code extension associated with the payment.

orderId

string(100)

ID of the merchant-side order.

amount

number(decimal)

Payment amount.

commission

number(decimal)

Fee applied to the payment.

currency

string(enum)

Currency in which the payment was made. Possible value: MDL.

description

string(500)

Description of the order.

payerName

string(200)

Abbreviated name of the payer.

payerIban

string(100)

Payer’s IBAN.

status

string(enum)

Payment status. Possible values: Executed, Refunded.

executedAt

string(datetime)

Timestamp of payment execution. Format: ISO 8601-1:2019.

refundedAt

string(datetime)

Timestamp of payment refund, if applicable. Format: ISO 8601-1:2019.

terminalId

string(100)

Terminal ID provided by the bank.


Other response fields

Field
Type
Description

ok

boolean

Processing status. true means success, false indicates an error.

errors

array

List of errors, if any.

Object errors

Field
Type
Description

errorCode

string

Error code.

errorMessage

string

Description of the error.


Exemplu răspuns

{
    "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": "Plată pentru comanda #123",
        "payerName": "John D.",
        "payerIban": "MD24AG00225100013104168",
        "status": "Executed",
        "executedAt": "2024-08-05T10:32:28+03:00",
        "terminalId": "P011111"
    },
    "ok": true
}

PreviousRetrieve List of Payments with Filtering OptionsNextPayment Simulation (Sandbox)

Last updated 1 day ago