Skip to main content

Get Pre-Order Detail

View as Markdown

This endpoint retrieves the current status and detailed information for a specific pre-order that has already been created. By providing the unique pre_order_id, a merchant can check whether a payment link is still active, has been paid, or has expired, and view the associated transaction details.

Method: GET v1/pre-orders/{pre_order_id}/detail

Headers: See Common Headers​

AuthorizationrequiredBearer Token

Required. The JWT access_token for authenticating the API call.

Path Parameters​

pre_order_idrequiredstring

Required. The unique identifier of the pre-order, which was returned when the pre-order was created.

Response Parameters​

pre_order_idstring

The unique identifier for the pre-order.

zoned_create_datestring

The date and time when the pre-order was created, in UTC (ISO 8601 format).

zoned_expire_datestring

The date and time when the pre-order is set to expire, in UTC (ISO 8601 format).

pre_order_statusobject

An object containing the current status of the payment link itself.

pre_order_status.keystring

Preorder status key: active, performed, deactivated, expired

pre_order_status.valuestring

Preorder status description.

transaction_statusobject / null

The status of the associated payment transaction. This will be null if no payment attempt has been made.

payment_detailobject

An object containing details about the payment method used.

payment_detail.transfer_methodobject

The method used for the transfer (e.g., card payment).

payment_detail.transfer_method.keystring

Key for the payment method: card, google_pay, apple_pay, bog_p2p, bog_loyalty

payment_detail.transfer_method.valuestring

Payment method description

payment_detail.transaction_idstring / null

RRN - The unique identifier for the payment transaction, if one has occurred.

payment_detail.payer_identifierstring / null

An identifier for the payer, such as a masked card number.

payment_detail.order_idstring / null

UUID - The unique identifier of the payment transaction, if one has occurred, generated by bank's system.

purchase_unitsobject

An object containing the monetary amounts associated with the pre-order.

purchase_units.request_amountstring

The original amount requested in the pre-order.

purchase_units.transfer_amountstring / null

The amount that was successfully transferred.

purchase_units.refund_amountstring / null

The amount that has been refunded, if any.

purchase_units.currency_codestring

The three-letter currency code for the transaction (e.g., "GEL").

purchase_units.itemsarray / null

A list of items included in the purchase. null if not provided.

langstring

The language setting for the payment page (e.g., "ka" for Georgian).

invoice_payment_urlstring

The short URL for the payment page (payment link).

descriptionstring

The original description provided when the pre-order was created.

external_order_idstring

The merchant-provided unique identifier for the order.

{
    "pre_order_id": "0873d2db-5bf5-4845-91a3-f25e65f4749d",
    "zoned_create_date": "2026-04-21T11:09:31.458943Z",
    "zoned_expire_date": "2026-04-22T11:09:31.458943Z",
    "pre_order_status": {
        "key": "performed",
        "value": "Performed"
    },
    "transaction_status": {
        "key": "refunded_partially",
        "value": "Partially refunded"
    },
    "payment_detail": {
        "transfer_method": {
            "key": "card",
            "value": "Card Payment"
        },
        "transaction_id": "611115529598",
        "payer_identifier": "411634***8449",
        "order_id": "d300e690-83ba-4f88-afbf-3d3fdaeda95b"
    },
    "purchase_units": {
        "request_amount": "1.0",
        "transfer_amount": "0.4",
        "refund_amount": "0.6",
        "currency_code": "GEL",
        "items": null
    },
    "lang": "ka",
    "invoice_payment_url": "https://link.bog.ge/HnisFqRnzJz",
    "description": "string",
    "external_order_id": "string"
}