Get checkout details

GET /v2/checkouts/{id}

Retrieves aggregated details for a checkout session. The response combines checkout metadata, order, available payment methods, and the active paymentIntent with attempts.

Request

HTTP Method: GET Endpoint:

/v2/checkouts/{id}

Headers:

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

Path Parameters

Name

Type

Required

Description

string (UUID)

Yes

Identifier of the checkout session.

Response

Response Parameters

Name

Type

Description

result

object

Operation result container.

boolean

Indicates successful request execution.

errors

array

List of validation/processing errors, if any.

`result` object (Checkout core)

Name

Type

Description

string (UUID)

Checkout identifier.

createdAt

string (date-time)

Creation timestamp (ISO 8601).

merchantId

string (UUID)

Merchant identifier.

paymentIntentId

string (UUID)

Current payment intent identifier.

status

string

Checkout status (e.g., PaymentMethodSelected).

redirectUrl

string (uri)

URL for redirect if applicable.

amount

number

Checkout amount (major units).

currency

string

ISO 4217 currency code (e.g., MDL).

order

object

Order summary.

expiresAt

string (date-time)

Expiration timestamp (ISO 8601).

paymentMethods

array<object>

Available payment methods for this checkout.

paymentIntent

object

Full payment intent details.

`result.order` object

Name

Type

Description

string

Merchant’s order identifier.

description

string

Order description.

amount

number

Order amount (major units).

`result.paymentMethods[]` object

Name

Type

Description

paymentMethodKey

string

Internal key (e.g., MiaQr, Card).

displayOrder

integer

Display order index.

`result.paymentIntent` object

Name

Type

Description

string (UUID)

Payment intent identifier.

total

object

Total amount object.

orderId

string

Merchant order ID carried by the intent.

note

string

Free-form note.

status

string

Intent status (e.g., Created).

createdAt

string (date-time)

Creation timestamp (ISO 8601).

updatedAt

string (date-time)

Last update timestamp (ISO 8601).

cancelledAt

string (date-time)

Cancellation timestamp.

expiresAt

string (date-time)

Expiration timestamp (ISO 8601).

completedAt

string (date-time)

Completion timestamp.

lastAttemptId

string (UUID)

Last attempt identifier.

completionAttemptId

string (UUID)

Attempt that completed the intent.

attempts

array<object>

Attempts associated with this intent.

result.paymentIntent.total object

Name

Type

Description

amount

number

Amount in major units.

currency

string

ISO 4217 currency code.

`result.paymentIntent.attempts[]` object

Name

Type

Description

string (UUID)

Attempt identifier.

paymentIntentId

string (UUID)

Parent payment intent.

paymentMethodKey

string

Payment method used (e.g., MiaQr).

providerType

string

Provider type.

status

string

Attempt status (e.g., Completed).

cancelledAt

string (date-time)

Cancellation timestamp.

autoRefundedAt

string (date-time)

Auto-refund timestamp.

completedAt

string (date-time)

Completion timestamp.

expiredAt

string (date-time)

Expiration timestamp.

payUrl

string (uri)

URL to perform action (if applicable).

providerExternalId

string

External provider reference.

paymentId

string (UUID)

Linked payment identifier.

payment

object

Embedded payment details.

`result.paymentIntent.attempts[].payment` object

Name

Type

Description

string (UUID)

Payment identifier.

paymentIntentId

string (UUID)

Parent intent.

createdAt

string (date-time)

Creation timestamp (ISO 8601).

updatedAt

string (date-time)

Last update timestamp (ISO 8601).

executedAt

string (date-time)

Execution timestamp.

status

string

Payment status (e.g., Executed).

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

providerHeaderId

string

Provider header reference.

providerExtensionId

string

Provider extension reference.

senderCustomerId

integer

Sender customer ID.

senderName

string

Sender name.

senderTaxId

string

Sender tax ID.

senderIban

string

Sender IBAN.

senderAccountNumber

string

Sender account number.

senderBic

string

Sender BIC.

senderCountryCode

string

Sender country (ISO 3166-1 alpha-2).

senderCardNumber

string

Masked sender card.

senderAmount

number

Sender amount.

senderConversionRate

number

Sender conversion rate.

senderCurrency

string

Sender currency.

senderReferenceNumber

string

Sender reference number.

senderCommissionAmount

number

Sender commission amount.

senderCommissionPercentage

number

Sender commission percentage.

senderCommissionReference

string

Sender commission reference.

recipientId

string (UUID)

Recipient identifier.

recipientCustomerId

integer

Recipient customer ID.

recipientTaxId

string

Recipient tax ID.

recipientIban

string

Recipient IBAN.

recipientAccountNumber

string

Recipient account number.

recipientBic

string

Recipient BIC.

recipientCountryCode

string

Recipient country code.

recipientAmount

number

Recipient amount.

recipientConversionRate

number

Recipient conversion rate.

recipientCurrency

string

Recipient currency.

recipientCardNumber

string

Masked recipient card.

recipientReferenceNumber

string

Recipient reference number.

recipientCommissionAmount

number

Recipient commission amount.

recipientCommissionPercentage

number

Recipient commission percentage.

recipientCommissionReference

string

Recipient commission reference.

commissionAccountId

string (UUID)

Commission account ID.

channelCategory

string

Channel category

channel

string

Channel (e.g., maib.web).

referenceNumber

string

Reference number.

referenceT24

string

T24 reference.

referenceExternalId

string

External reference ID.

mcc

string

Merchant Category Code.

orderId

string

Order identifier.

terminalId

string

Terminal identifier.

refundedAmount

number

Refunded amount.

requestedRefundAmount

number

Requested refund amount.

refundedRecipientCommissionAmount

number

Refunded recipient commission.

requestedRefundRecipientCommissionAmount

number

Requested refund recipient commission.

firstRefundedAt

string (date-time)

First refund timestamp.

lastRefundedAt

string (date-time)

Last refund timestamp.

note

string

Free-form note.

Example Successful Response

{
  "result": {
    "id": "5d526a22-9354-4721-99da-fa58fb53216e",
    "createdAt": "2024-01-12T01:10:10+03:00",
    "merchantId": "b6d34b50-3713-4ca2-aa6d-e6c14a5c3c25",
    "paymentIntentId": "4f486662-6933-410b-8d01-1e054ee8c4f2",
    "status": "PaymentMethodSelected",
    "redirectUrl": null,
    "amount": 50.61,
    "currency": "MDL",
    "order": {
      "id": "123",
      "description": "Order description",
      "amount": 50.61
    },
    "expiresAt": "2025-01-12T01:10:10+03:00",
    "paymentMethods": [
      {
        "paymentMethodKey": "MiaQr",
        "displayOrder": 3
      }
    ],
    "paymentIntent": {
      "id": "26f6f2b4-9694-4801-8cb2-4acfa99deec4",
      "total": {
        "amount": 50.61,
        "currency": "MDL"
      },
      "orderId": "Order123",
      "note": "Example payment intent for testing",
      "status": "Created",
      "createdAt": "2024-01-12T01:10:10+03:00",
      "updatedAt": "2024-01-12T01:10:10+03:00",
      "cancelledAt": null,
      "expiresAt": "2025-01-12T01:10:10+03:00",
      "completedAt": null,
      "lastAttemptId": "68e84762-2832-4faf-9088-f80c6bc0fee6",
      "completionAttemptId": null,
      "attempts": [
        {
          "id": "9f0a6af0-472f-4e7a-ae12-649f311f8408",
          "paymentIntentId": "f5e86b9a-3d66-4c09-8ad2-ad852fdd34db",
          "paymentMethodKey": "MiaQr",
          "providerType": null,
          "status": "Completed",
          "cancelledAt": null,
          "autoRefundedAt": null,
          "completedAt": "2024-01-12T01:10:10+03:00",
          "expiredAt": null,
          "payUrl": "https://example.com/payment-action",
          "providerExternalId": null,
          "paymentId": "ae20c2ae-328b-456d-bed1-52646b5eacab",
          "payment": {
            "id": "00000000-0000-0000-0000-000000000000",
            "paymentIntentId": null,
            "createdAt": "0001-01-01T00:00:00+00:00",
            "updatedAt": "0001-01-01T00:00:00+00:00",
            "executedAt": "2024-01-12T01:10:10+03:00",
            "status": "Executed",
            "amount": 1200,
            "currency": "MDL",
            "type": "MIA",
            "providerType": "RTP",
            "providerHeaderId": "305f9c68-dd8b-4261-a494-9aa0a8724776",
            "providerExtensionId": "936db666-43c8-49cb-aeb7-93015c950c84",
            "senderCustomerId": 100001,
            "senderName": "John Doe",
            "senderTaxId": "1234567890123",
            "senderIban": "MD21AG000000000001234567",
            "senderAccountNumber": "1111222233334444",
            "senderBic": "AGROMD22",
            "senderCountryCode": "MD",
            "senderCardNumber": "411111******1234",
            "senderAmount": 1180,
            "senderConversionRate": 0.98,
            "senderCurrency": "USD",
            "senderReferenceNumber": "SRN000001",
            "senderCommissionAmount": 1.95,
            "senderCommissionPercentage": 0.5,
            "senderCommissionReference": "COMM0001",
            "recipientId": "a8083bf9-dd88-4fa9-ad8b-a2421b376f7b",
            "recipientCustomerId": 200001,
            "recipientTaxId": "9988776655443",
            "recipientIban": "MD44MO000000000000987654",
            "recipientAccountNumber": "9876543210000001",
            "recipientBic": "MOBIMD22",
            "recipientCountryCode": "MD",
            "recipientAmount": 1200,
            "recipientConversionRate": 1,
            "recipientCurrency": "MDL",
            "recipientCardNumber": "555544******4321",
            "recipientReferenceNumber": "RRN000001",
            "recipientCommissionAmount": 0,
            "recipientCommissionPercentage": null,
            "recipientCommissionReference": null,
            "commissionAccountId": "8c0e0e97-729c-42bd-af2f-3406f7de57a2",
            "channelCategory": "Online",
            "channel": "maib.web",
            "referenceNumber": "REF000001",
            "referenceT24": "T24-0001",
            "referenceExternalId": "EXT000001",
            "mcc": "6012",
            "orderId": "ORD001",
            "terminalId": "TERM001",
            "refundedAmount": 0,
            "requestedRefundAmount": 0,
            "refundedRecipientCommissionAmount": 0,
            "requestedRefundRecipientCommissionAmount": 0,
            "firstRefundedAt": null,
            "lastRefundedAt": null,
            "note": null
          }
        }
      ]
    }
  },
  "ok": true,
  "errors": null
}

PreviousCancel a checkout session NextRetrieve all checkouts

Last updated 2 days ago

Request

Response

Response Parameters

result object (Checkout core)

result.order object

result.paymentMethods[] object

result.paymentIntent object

result.paymentIntent.attempts[] object

result.paymentIntent.attempts[].payment object

Example Successful Response

`result` object (Checkout core)

`result.order` object

`result.paymentMethods[]` object

`result.paymentIntent` object

`result.paymentIntent.attempts[]` object

`result.paymentIntent.attempts[].payment` object