Retrieve all checkouts

GET /v2/checkouts

Returns a list of checkout sessions associated with the authenticated merchant. Supports filtering by order, amount, currency, status, creation/expiration date, and sorting options. No request body is required — all filters are passed as query parameters.

Request

HTTP Method: GET Endpoint:

/v2/checkouts

Headers:

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

---

Query Parameters

Name	Type	Description
id	string (UUID)	Filter by checkout ID.
orderId	string	Filter by merchant order ID.
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
minAmount	number	Minimum checkout amount.
maxAmount	number	Maximum checkout amount.
currency	string	Currency code (ISO 4217).
language	string	Checkout language (e.g., ro, ru, en).
payerName	string	Payer name.
payerEmail	string	Payer email.
payerPhone	string	Payer phone.
payerIp	string	Payer IP.
createdAtFrom	string (date-time)	Return records created after this timestamp.
createdAtTo	string (date-time)	Return records created before this timestamp.
expiresAtFrom	string (date-time)	Return records expiring after this timestamp.
expiresAtTo	string (date-time)	Return records expiring before this timestamp.
cancelledAtFrom	string (date-time)	Return records cancelled after this timestamp.
cancelledAtTo	string (date-time)	Return records cancelled before this timestamp.
failedAtFrom	string (date-time)	Return records failed after this timestamp.
failedAtTo	string (date-time)	Return records failed before this timestamp.
completedAtFrom	string (date-time)	Return records completed after this timestamp.
completedAtTo	string (date-time)	Return records completed before this timestamp.
count	integer	Number of items to return per page.
offset	integer	Pagination offset.
sortBy	string	Field to sort results by (e.g., createdAt, amount).
order	string	Sort direction (asc or desc).

Query example

GET /checkouts?status=Completed&currency=MDL&count=10&offset=0&sortBy=createdAt&order=desc HTTP/1.1

---

Response

Response Parameters

Name	Type	Description
result	object	Operation result container.
result.items	array<object>	List of checkout sessions.
result.count	integer	Number of items returned.
result.totalCount	integer	Total number of items available.
ok	boolean	Indicates successful request execution.
errors	array	List of validation or processing errors, if any.

---

result.items[] 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.items[].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.itesms[].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.items[].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.items[].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": {
        "items": [
            {
                "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
                }
            },
            {
                "id": "7ce7c327-c17f-4a2b-a9a9-9196118174f5",
                "createdAt": "2026-02-05T16:32:52.921+00:00",
                "status": "Completed",
                "amount": 3.00,
                "callbackUrl": "https://example.com/callback",
                "successUrl": "https://example.com/success",
                "failUrl": "https://example.com/fail",
                "currency": "MDL",
                "language": "ro",
                "url": "https://checkout.maib.md/7ce7c327c17f4a2ba9a99196118174f5",
                "order": {
                    "orderItems": []
                },
                "payer": {
                    "ip": "192.168.0.1"
                },
                "completedAt": "2026-02-05T16:33:06.269+00:00",
                "expiresAt": "2026-02-05T16:57:52.924+00:00",
                "payment": {
                    "paymentId": "a8aee8bd-d5c0-4207-ae30-ab17c7d3410a",
                    "executedAt": "2026-02-05T16:33:05.986+00:00",
                    "status": "Executed",
                    "amount": 3.00,
                    "currency": "MDL",
                    "type": "MMC",
                    "providerType": "MMC",
                    "referenceNumber": "603616098134",
                    "mcc": "4511",
                    "terminalId": "01E12345",
                    "refundedAmount": 0.00,
                    "paymentMethod": "Card",
                    "approvalCode": "438331",
                    "requestedRefundAmount": 0.00
                }
            }
        ],
        "count": 2,
        "totalCount": 101
    },
    "ok": true,
    "errors": null
}

---

Notes

• All query parameters are optional; absence returns all checkouts.

• Pagination is controlled via count and offset.