Afișare detalii despre plăți după ID

GET /v2/mia/payments/{payID}

Acest endpoint returnează detalii despre o anumită plată, identificată prin payId.


Parametri URL (path)

Parametru
Tip
Obligatoriu
Descriere

payId

string(guid)

Da

Identificatorul unic al plății.


Exemplu request

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

Structura răspunsului

Obiect result

Câmp
Tip
Descriere

payId

string(guid)

ID-ul unic al plății.

referenceId

string(15)

Codul RRN din cadrul serviciului de plăți instant.

qrId

string(guid)

ID-ul codului QR asociat plății.

extensionId

string(guid)

ID-ul extensiei codului QR asociat plății.

orderId

string(100)

ID-ul comenzii de pe partea comerciantului.

amount

number(decimal)

Suma plății.

commission

number(decimal)

Comisionul perceput pentru plată.

currency

string(enum)

Moneda în care a fost efectuată plata. Valori posibile: MDL.

description

string(500)

Descrierea comenzii.

payerName

string(200)

Numele prescurtat al plătitorului.

payerIban

string(100)

IBAN-ul plătitorului.

status

string(enum)

Starea plății. Valori posibile: Executed, Refunded.

executedAt

string(datetime)

Timpul la care a fost executată plata. Format: ISO 8601-1:2019.

refundedAt

string(datetime)

Timpul la care a fost rambursată plata. Format: ISO 8601-1:2019.

terminalId

string(100)

ID-ul terminalului, oferit de bancă.


Alte câmpuri de răspuns

Câmp
Tip
Descriere

ok

boolean

Statusul procesării request-ului. true înseamnă succes, false indică o eroare.

errors

array

Lista erorilor (dacă există).

Obiect errors

Câmp
Tip
Descriere

errorCode

string

Codul erorii.

errorMessage

string

Descrierea erorii.


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
}

Last updated