Get checkout details

GET /v2/checkouts/{id}

Retrieves aggregated details for a checkout session. The response combines checkout metadata, order, payer info and information about the payment that completed checkout.

Request

HTTP Method: GET Endpoint:

/v2/checkouts/{id}

Headers:

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

---

Path Parameters

Name	Type	Required	Description
id	string (UUID)	Yes	Identifier of the checkout session.

---

Response

Response Parameters

Name	Type	Description
result	object	Operation result container.
ok	boolean	Indicates successful request execution.
errors	array	List of validation/processing errors, if any.

---

result object (Checkout)

Name	Type	Description
id	string (UUID)	Checkout identifier.
createdAt	string (date-time)	Creation timestamp (ISO 8601).
status	string	Checkout status. Possible values: WaitingForInit — The checkout session was successfully created and is awaiting initialization when the user accesses the link Initialized — The user accessed the link and the session was initialized PaymentMethodSelected — The user selected a payment method Completed — The checkout was completed successfully Expired — The checkout session has expired Abandoned — The user did not access the checkout at all and the session was abandoned Cancelled — The checkout was explicitly cancelled by the merchant Failed — The checkout failed
amount	number	Checkout amount (major units).
currency	string	ISO 4217 currency code (e.g., MDL).
callbackUrl	string	Callback url for this checkout
successUrl	string	Success url for this checkout
failUrl	string	Fail url for this checkout
language	string	Language for this checkout ("ro", "ru", "en")
url	string	Url of checkout session
order	object | null	Order summary.
payer	object | null	Payer summary
expiresAt	string (date-time)	Expiration timestamp (ISO 8601).
CompletedAt	string (date-time) | null	Completion timestamp (ISO 8601).
FailedAt	string (date-time) | null	Failure timestamp (ISO 8601).
CancelledAt	string (date-time) | null	Cancelling timestamp (ISO 8601).
payment	object | null	Payment summary

---

result.order object

Name	Type	Description
id	string | null	Merchant’s order identifier.
description	string | null	Order description.
amount	number | null	Order amount (major units).
currency	string | null	ISO 4217 currency code (e.g., MDL).
deliveryAmount	number | null	Delivery amount
deliveryCurrency	string | null	ISO 4217 currency code (e.g., MDL).
date	string (date-time) | null	Order date
orderItems	object[] | null	List of order items

---

result.order.orderItems[] object

Field	Type	Description
externalId	string | null	External product identifier (SKU).
title	string | null	Product name or title.
amount	number | null	Item price, in major currency units.
currency	string | null	ISO 4217 code of the item currency.
quantity	number | null	Number of items ordered.
displayOrder	integer | null	Optional display order index.

---

result.payer object

Field	Type	Description
name	string | null	Payer full name.
email	string | null	Payer email address.
phone	string | null	Payer phone number (E.164 format).
ip	string | null	IP address of the payer.
userAgent	string | null	User agent string of the payer’s device.

result.payment object

Name	Type	Description
PaymentId	string (UUID)	Payment identifier.
executedAt	string (date-time)	Execution timestamp.
status	string	Payment status (e.g., Executed, Failed).
amount	number	Amount in minor/major units (per system contract).
currency	string	ISO 4217 currency code.
type	string	Payment type (e.g., MIA).
providerType	string	Provider type
senderName	string | null	Sender name.
senderIban	string | null	Sender IBAN.
recipientIban	string | null	Recipient IBAN.
referenceNumber	string	Payment reference number.
mcc	string	Merchant Category Code.
orderId	string | null	Order identifier.
terminalId	string | null	Terminal identifier.
refundedAmount	number	Refunded amount.
paymentMethod	string | null	Payment method used (e.g., Card, MiaQr).
approvalCode	string | null	Provider approval code.
requestedRefundAmount	number	Requested refund amount.
firstRefundedAt	string (date-time) | null	First refund timestamp.
lastRefundedAt	string (date-time) | null	Last refund timestamp.
note	string | null	Free-form note.

---

Example Successful Response

{
    "result": {
        "id": "37193a81-a24f-4336-9f0e-5a2f544e0e8c",
        "createdAt": "2026-02-05T16:47:44.049+00:00",
        "status": "Completed",
        "amount": 3.00,
        "callbackUrl": "https://example.com/callback",
        "successUrl": "https://example.com/ok",
        "failUrl": "https://example.com/fail",
        "currency": "MDL",
        "language": "ro",
        "url": "https://checkout.maib.md/37193a81a24f43369f0e5a2f544e0e8c",
        "order": {
            "id": "some-order-id",
            "description": "My awesome order",
            "amount": 2.00,
            "currency": "MDL",
            "deliveryAmount": 1.00,
            "deliveryCurrency": "MDL",
            "date": "2026-01-01T00:00:00+00:00",
            "orderItems": [
                {
                    "externalId": "item-2",
                    "title": "Cookies",
                    "amount": 1.00,
                    "currency": "MDL",
                    "quantity": 1.00,
                    "displayOrder": 1
                },
                {
                    "externalId": "item-1",
                    "title": "Tea",
                    "amount": 1.00,
                    "currency": "MDL",
                    "quantity": 1.00,
                    "displayOrder": 0
                }
            ]
        },
        "payer": {
            "name": "John Doe",
            "email": "[email protected]",
            "phone": "[phone]",
            "ip": "127.0.0.1",
            "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36"
        },
        "completedAt": "2026-02-05T16:47:52.765+00:00",
        "expiresAt": "2026-02-05T17:12:44.057+00:00",
        "payment": {
            "paymentId": "373827c5-6644-4ee3-a241-60de7c7af116",
            "executedAt": "2026-02-05T16:47:52.522+00:00",
            "status": "Executed",
            "amount": 3.00,
            "currency": "MDL",
            "type": "MMC",
            "providerType": "MMC",
            "referenceNumber": "603616098154",
            "mcc": "4511",
            "orderId": "some-order-id",
            "terminalId": "01E12345",
            "refundedAmount": 0.00,
            "paymentMethod": "Card",
            "approvalCode": "929776",
            "requestedRefundAmount": 0.00
        }
    },
    "ok": true,
    "errors": null
}

---