Get payment by id

/v2/payments/{id}

Retrieves details for a specific payment.

Request

HTTP Method: GET Endpoint:

/v2/payments/{id}

Headers:

Authorization: {tokenType} {access_token}
Content-Type: application/json

---

Path Parameters

Name	Type	Required	Description
id	string (UUID)	Yes	Unique identifier of the payment to be retrieved.

---

Response

Response Parameters

result object

Name	Type	Description
paymentId	string (UUID)	Unique identifier of the executed payment.
paymentIntentId	string | null	Identifier of the related payment intent, if applicable.
executedAt	string (ISO 8601 datetime)	Date and time when the payment was executed.
status	string	Current status of the payment Possible values: Executed — The payment was successfully executed PartiallyRefunded — The payment was partially refunded Refunded — The payment was fully refunded Failed — The payment failed
amount	number	Amount of the payment.
currency	string	Currency code of the payment amount (ISO 4217).
type	string	Payment type (e.g. MIA).
providerType	string	Provider channel used for the payment (e.g. QR).
senderName	string	Name of the payment sender.
senderIban	string	IBAN of the payment sender.
recipientIban	string	IBAN of the payment recipient.
referenceNumber	string	Reference number assigned to the payment.
mcc	string	Merchant Category Code associated with the payment.
orderId	string	Merchant order identifier linked to the payment.
terminalId	string	Identifier of the terminal that initiated the payment.
refundedAmount	number	Total amount already refunded for this payment.
requestedRefundAmount	number	Total refund amount currently requested.
firstRefundedAt	string | null	Date and time of the first refund operation, if any.
lastRefundedAt	string | null	Date and time of the most recent refund operation, if any.
note	string | null	Optional note attached to the payment.

Root-level fields

Name	Type	Description
ok	boolean	Indicates whether the request was processed successfully.
errors	array | null	List of errors, if the request failed.

---

Example Successful Response

{
  "result": {
    "paymentId": "ae20c2ae-328b-456d-bed1-52646b5eacab",
    "paymentIntentId": null,
    "executedAt": "2024-01-12T00:00:00+03:00",
    "status": "Executed",
    "amount": 50.61,
    "currency": "MDL",
    "type": "MIA",
    "providerType": "QR",
    "senderName": "John D.",
    "senderIban": "MD16AG000000022595083585",
    "recipientIban": "MD16AG000000011111111111",
    "referenceNumber": "MIA012345678",
    "mcc": "5811",
    "orderId": "123",
    "terminalId": "123456789012345678901234567890123456",
    "refundedAmount": 0,
    "requestedRefundAmount": 0,
    "firstRefundedAt": null,
    "lastRefundedAt": null,
    "note": null
  },
  "ok": true,
  "errors": null
}

---