Получить собственные сохранённые платёжные квитанции

{
  "type": "object",
  "description": "Страница фиксированного размера, не более 25 собственных сохранённых квитанций, с сортировкой по убыванию consumedAt, затем по убыванию id квитанции. Подписанное продолжение связано с текущей областью гостя и правилами истории.",
  "required": [
    "items",
    "nextCursor",
    "hasMore"
  ],
  "properties": {
    "items": {
      "type": "array",
      "maxItems": 25,
      "description": "Полные проверенные сводки этой страницы с сохранением зафиксированного порядка финансовых записей.",
      "items": {
        "type": "object",
        "description": "Принадлежащая гостю сохранённая финансовая сводка с исходными суммами, зафиксированным получателем платежа и отдельно обозначенным сохранённым текущим прогрессом. Не содержит capability управления или оплаты и редиректа в hosted checkout.",
        "required": [
          "id",
          "acceptedAt",
          "consumedAt",
          "payee",
          "purpose",
          "provider",
          "mode",
          "original",
          "current"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,191}$",
            "minLength": 1,
            "maxLength": 191,
            "description": "Неизменный идентификатор квитанции использованного согласия, задающий границу cursor платёжных квитанций.",
            "example": "example-id"
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Исходный момент UTC принятия показанных условий.",
            "example": "2026-01-15T12:00:00.000Z"
          },
          "consumedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Неизменный момент UTC, когда исходная команда checkout использовала согласие; основной ключ пагинации по убыванию.",
            "example": "2026-01-15T12:00:00.000Z"
          },
          "payee": {
            "type": "object",
            "description": "Исходные данные получателя платежа из принятых подтверждающих данных; текущие наименования заведения или юридического лица не подставляются.",
            "required": [
              "venueName",
              "legalName"
            ],
            "properties": {
              "venueName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "Наименование получателя платежа, зафиксированное в исходном принятом манифесте согласия.",
                "example": "example"
              },
              "legalName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "Наименование получателя платежа, зафиксированное в исходном принятом манифесте согласия.",
                "example": "Example name"
              }
            },
            "example": {
              "venueName": "example",
              "legalName": "Example name"
            }
          },
          "purpose": {
            "type": "string",
            "enum": [
              "ORDER_BILL",
              "RESERVATION_GUARANTEE"
            ],
            "description": "Исходное зафиксированное финансовое назначение checkout.",
            "example": "ORDER_BILL"
          },
          "provider": {
            "type": "string",
            "enum": [
              "STRIPE_CONNECT",
              "BOG_PAYMENT_MANAGER",
              "TBC_CHECKOUT"
            ],
            "description": "Исходный провайдер, выбранный для этого зафиксированного checkout.",
            "example": "STRIPE_CONNECT"
          },
          "mode": {
            "type": "string",
            "enum": [
              "TEST",
              "LIVE"
            ],
            "description": "Исходный режим TEST или LIVE для checkout.",
            "example": "TEST"
          },
          "original": {
            "allOf": [
              {
                "$ref": "#/components/schemas/GuestPaymentCommandReceiptDto"
              }
            ],
            "description": "Неизменное подтверждение исходной команды checkout; текущий прогресс оплаты возвращается отдельно.",
            "example": {
              "schema": "hallify.restaurant-payment.command-result",
              "version": 1,
              "checkoutId": "f5ef2bdc-76ae-45b6-851a-399882860529",
              "operationId": "44352441-86e0-4a70-8642-d5863bea459a",
              "action": "CREATE_CHECKOUT",
              "state": "PREPARED",
              "currency": "USD",
              "principalAmount": "12.50",
              "tipAmount": "0.00",
              "totalAmount": "12.50"
            }
          },
          "current": {
            "type": "object",
            "description": "Сохранённый текущий прогресс checkout, отдельный от неизменного исходного подтверждения. Чтение этой проекции не выполняет сверку или нативное применение.",
            "required": [
              "fundsState",
              "applicationState",
              "applicationBlockedReason",
              "checkoutRevision"
            ],
            "properties": {
              "fundsState": {
                "type": "string",
                "enum": [
                  "NOT_STARTED",
                  "REQUIRES_ACTION",
                  "PROCESSING",
                  "AUTHORIZED",
                  "CAPTURED",
                  "PARTIALLY_REFUNDED",
                  "REFUNDED",
                  "CANCELED",
                  "DECLINED",
                  "EXPIRED",
                  "UNKNOWN"
                ],
                "description": "Текущее сохранённое состояние средств, включая последующие списание, возврат, отмену или неразрешённые подтверждающие данные.",
                "example": "NOT_STARTED"
              },
              "applicationState": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "APPLIED",
                  "APPLICATION_BLOCKED",
                  "RECONCILIATION_REQUIRED"
                ],
                "description": "Текущее сохранённое состояние применения к нативным финансовым данным.",
                "example": "PENDING"
              },
              "applicationBlockedReason": {
                "type": "string",
                "nullable": true,
                "minLength": 1,
                "maxLength": 64,
                "description": "Сохранённый код причины нативного применения либо null при отсутствии блокирующей причины.",
                "example": "Synthetic example"
              },
              "checkoutRevision": {
                "type": "integer",
                "minimum": 1,
                "maximum": 2147483647,
                "description": "Текущая сохранённая ревизия checkout.",
                "example": 1
              }
            },
            "example": {
              "fundsState": "NOT_STARTED",
              "applicationState": "PENDING",
              "applicationBlockedReason": null,
              "checkoutRevision": 1
            }
          }
        },
        "example": {
          "id": "example-id",
          "acceptedAt": "2026-01-15T12:00:00.000Z",
          "consumedAt": "2026-01-15T12:00:00.000Z",
          "payee": {
            "venueName": "example",
            "legalName": "Example name"
          },
          "purpose": "ORDER_BILL",
          "provider": "STRIPE_CONNECT",
          "mode": "TEST",
          "original": {
            "schema": "hallify.restaurant-payment.command-result",
            "version": 1,
            "checkoutId": "f5ef2bdc-76ae-45b6-851a-399882860529",
            "operationId": "44352441-86e0-4a70-8642-d5863bea459a",
            "action": "CREATE_CHECKOUT",
            "state": "PREPARED",
            "currency": "USD",
            "principalAmount": "12.50",
            "tipAmount": "0.00",
            "totalAmount": "12.50"
          },
          "current": {
            "fundsState": "NOT_STARTED",
            "applicationState": "PENDING",
            "applicationBlockedReason": null,
            "checkoutRevision": 1
          }
        }
      },
      "example": [
        {
          "id": "example-id",
          "acceptedAt": "2026-01-15T12:00:00.000Z",
          "consumedAt": "2026-01-15T12:00:00.000Z",
          "payee": {
            "venueName": "example",
            "legalName": "Example name"
          },
          "purpose": "ORDER_BILL",
          "provider": "STRIPE_CONNECT",
          "mode": "TEST",
          "original": {
            "schema": "hallify.restaurant-payment.command-result",
            "version": 1,
            "checkoutId": "f5ef2bdc-76ae-45b6-851a-399882860529",
            "operationId": "44352441-86e0-4a70-8642-d5863bea459a",
            "action": "CREATE_CHECKOUT",
            "state": "PREPARED",
            "currency": "USD",
            "principalAmount": "12.50",
            "tipAmount": "0.00",
            "totalAmount": "12.50"
          },
          "current": {
            "fundsState": "NOT_STARTED",
            "applicationState": "PENDING",
            "applicationBlockedReason": null,
            "checkoutRevision": 1
          }
        }
      ]
    },
    "nextCursor": {
      "type": "string",
      "nullable": true,
      "minLength": 1,
      "maxLength": 2048,
      "description": "Непрозрачное PAYMENT_RECEIPTS-продолжение точной последней возвращённой границы при hasMore = true; null в конце истории.",
      "example": "example"
    },
    "hasMore": {
      "type": "boolean",
      "description": "После возвращённой страницы существует ещё одна полностью проверенная допустимая квитанция.",
      "example": true
    }
  },
  "example": {
    "items": [
      {
        "id": "example-id",
        "acceptedAt": "2026-01-15T12:00:00.000Z",
        "consumedAt": "2026-01-15T12:00:00.000Z",
        "payee": {
          "venueName": "example",
          "legalName": "Example name"
        },
        "purpose": "ORDER_BILL",
        "provider": "STRIPE_CONNECT",
        "mode": "TEST",
        "original": {
          "schema": "hallify.restaurant-payment.command-result",
          "version": 1,
          "checkoutId": "f5ef2bdc-76ae-45b6-851a-399882860529",
          "operationId": "44352441-86e0-4a70-8642-d5863bea459a",
          "action": "CREATE_CHECKOUT",
          "state": "PREPARED",
          "currency": "USD",
          "principalAmount": "12.50",
          "tipAmount": "0.00",
          "totalAmount": "12.50"
        },
        "current": {
          "fundsState": "NOT_STARTED",
          "applicationState": "PENDING",
          "applicationBlockedReason": null,
          "checkoutRevision": 1
        }
      }
    ],
    "nextCursor": null,
    "hasMore": true
  }
}

{
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "enum": [
        "hallify.restaurant-payment.command-result"
      ],
      "description": "Дискриминатор версионированного документа исходного результата платёжной команды.",
      "example": "hallify.restaurant-payment.command-result"
    },
    "version": {
      "type": "integer",
      "enum": [
        1
      ],
      "description": "Версия схемы результата команды, сохранённая этим acknowledgement.",
      "example": 1
    },
    "checkoutId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID исходного checkout, выделенного один раз для этой постоянной команды.",
      "example": "f5ef2bdc-76ae-45b6-851a-399882860529"
    },
    "operationId": {
      "type": "string",
      "format": "uuid",
      "description": "UUID исходной provider operation CREATE_CHECKOUT; replay и восстановление сохраняют идентичность этой операции.",
      "example": "44352441-86e0-4a70-8642-d5863bea459a"
    },
    "action": {
      "type": "string",
      "enum": [
        "CREATE_CHECKOUT"
      ],
      "description": "Действие исходной принятой команды; эта гостевая граница подтверждает CREATE_CHECKOUT.",
      "example": "CREATE_CHECKOUT"
    },
    "state": {
      "type": "string",
      "enum": [
        "PREPARED"
      ],
      "description": "Состояние первого сохранённого acknowledgement, всегда PREPARED. Текущие состояния операции, средств и нативного применения возвращаются методом progress checkout.",
      "example": "PREPARED"
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "GEL"
      ],
      "description": "Валюта исходных зафиксированных основной суммы, чаевых и итога.",
      "example": "USD"
    },
    "principalAmount": {
      "type": "string",
      "example": "12.50",
      "description": "Исходная зафиксированная основная сумма до отдельно принятых чаевых строкой с двумя дробными знаками в валюте результата."
    },
    "tipAmount": {
      "type": "string",
      "example": "0.00",
      "description": "Исходные зафиксированные чаевые, принятые с командой, неотрицательной строкой с двумя дробными знаками в валюте результата."
    },
    "totalAmount": {
      "type": "string",
      "example": "12.50",
      "description": "Исходная сумма зафиксированных основной суммы и принятых чаевых строкой с двумя дробными знаками в валюте результата."
    }
  },
  "description": "Неизменяемое первое PREPARED acknowledgement постоянной гостевой команды CREATE_CHECKOUT, сохраняемое при точном replay и восстановлении исходной команды.",
  "required": [
    "schema",
    "version",
    "checkoutId",
    "operationId",
    "action",
    "state",
    "currency",
    "principalAmount",
    "tipAmount",
    "totalAmount"
  ],
  "example": {
    "schema": "hallify.restaurant-payment.command-result",
    "version": 1,
    "checkoutId": "f5ef2bdc-76ae-45b6-851a-399882860529",
    "operationId": "44352441-86e0-4a70-8642-d5863bea459a",
    "action": "CREATE_CHECKOUT",
    "state": "PREPARED",
    "currency": "USD",
    "principalAmount": "12.50",
    "tipAmount": "0.00",
    "totalAmount": "12.50"
  }
}

{
  "type": "object",
  "properties": {
    "statusCode": {
      "type": "integer",
      "description": "HTTP-статус, повторённый из ответа.",
      "example": 400
    },
    "error": {
      "type": "string",
      "description": "Ключ перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.",
      "example": "errors.request.invalid"
    },
    "code": {
      "type": "string",
      "example": "HTTP_BAD_REQUEST",
      "description": "Стабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями."
    },
    "message": {
      "type": "string",
      "example": "errors:http.badRequest",
      "description": "Ключ перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе."
    },
    "translationKey": {
      "type": "string",
      "example": "errors:http.badRequest",
      "description": "Канонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте."
    },
    "translationValues": {
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string",
            "example": "example"
          },
          {
            "type": "number",
            "example": 0
          },
          {
            "type": "boolean",
            "example": true
          }
        ],
        "example": "example"
      },
      "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
      "example": {
        "exampleKey": "example"
      }
    },
    "validationErrors": {
      "description": "Ошибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorDto"
      },
      "example": [
        {
          "field": "email",
          "translationKey": "validation:isEmail",
          "code": "isEmail",
          "message": "validation:isEmail"
        }
      ]
    },
    "details": {
      "description": "Необязательные сведения о доменных препятствиях или ошибках валидации.",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/JsonValue"
          },
          "example": [
            "example"
          ]
        },
        {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/JsonValue"
          },
          "example": {
            "exampleKey": "example"
          }
        }
      ],
      "example": [
        "example"
      ]
    }
  },
  "required": [
    "statusCode",
    "error",
    "code",
    "message",
    "translationKey"
  ],
  "description": "Стабильная оболочка ошибки общего обработчика HTTP-исключений. Дополнительные машинные данные домена вложены в details.",
  "example": {
    "statusCode": 400,
    "error": "errors:http.badRequest",
    "code": "HTTP_BAD_REQUEST",
    "message": "errors:http.badRequest",
    "translationKey": "errors:http.badRequest"
  }
}

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "example": "email",
      "description": "Публичный путь поля. Вложенные свойства и индексы массива разделены точками."
    },
    "translationKey": {
      "type": "string",
      "example": "validation:isEmail",
      "description": "Ключ перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers."
    },
    "code": {
      "type": "string",
      "example": "isEmail",
      "description": "Стабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы."
    },
    "message": {
      "type": "string",
      "example": "validation:isEmail",
      "description": "Ключ перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются."
    },
    "translationValues": {
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string",
            "example": "example"
          },
          {
            "type": "number",
            "example": 0
          },
          {
            "type": "boolean",
            "example": true
          }
        ],
        "example": "example"
      },
      "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
      "example": {
        "exampleKey": "example"
      }
    }
  },
  "required": [
    "field",
    "translationKey",
    "code",
    "message"
  ],
  "description": "Ошибка проверки поля с путём поля, стабильным кодом валидатора и ключом перевода. Человекочитаемый текст принадлежит приложению-потребителю.",
  "example": {
    "field": "email",
    "translationKey": "validation:isEmail",
    "code": "isEmail",
    "message": "validation:isEmail"
  }
}

{
  "oneOf": [
    {
      "type": "string",
      "nullable": true,
      "example": "example"
    },
    {
      "type": "number",
      "example": 0
    },
    {
      "type": "boolean",
      "example": true
    },
    {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": [
        "example"
      ]
    },
    {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": {
        "exampleKey": "example"
      }
    }
  ],
  "description": "Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.",
  "example": "example"
}