Refund

Returns the amounts actually refunded per ticket for an order that has already been cancelled/returned. Identical shape to Cancel Conditions, but the amounts reflect the realised refund rather than a preview.

This is a safe, idempotent read.

Endpoint

Method: GET

URL: /v1/order/{order_id}/refund

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	Bearer <token> from Login

Path Parameters

Parameter	Type	Required	Description
order_id	String	Yes	Provider order id (Order.id returned by Create Order)

Query Parameters

Parameter	Type	Required	Description
locale	String	No	Localises the human-readable refund notes, refer to Locale List

Response Parameters

The response is identical in shape to Cancel Conditions: a conditions object with per-ticket RefundTicket lines reflecting the realised refund.

Response Example

{
  "conditions": {
    "can_be_canceled": false,
    "currency": "UAH",
    "tickets": [
      {
        "ticket_code": "BK-9931",
        "currency": "UAH",
        "refund_amount": 585.0,
        "refund_fee_amount": 65.0,
        "full_refund": false
      }
    ]
  }
}

Error Code List

code	message	Description
UNAUTHORIZED	Invalid token	The bearer token is missing, invalid, or expired (401).
NOT_FOUND	No refund for order	The order has no refund (never cancelled, or unknown order_id).