{
  "openapi": "3.2.0",
  "paths": {
    "/v1/brands": {
      "get": {
        "description": "Возвращает пагинированный список брендов, для которых в текущем workspace есть доступные офферы, с логотипом, описанием, FAQ и списком доступных типов продуктов.",
        "operationId": "BrandsController_findMany",
        "parameters": [
          {
            "name": "search",
            "required": false,
            "in": "query",
            "description": "Поиск по названию или слагу бренда",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Количество записей на страницу (1-100)",
            "schema": {
              "default": 50,
              "type": "number"
            }
          },
          {
            "name": "offset",
            "required": false,
            "in": "query",
            "description": "Смещение выборки",
            "schema": {
              "default": 0,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Список брендов успешно получен",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/PaginatedDto"
                    },
                    {
                      "properties": {
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/BrandListItemResponseDto"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Список брендов",
        "tags": [
          "Brands"
        ]
      }
    },
    "/v1/brands/{idOrSlug}": {
      "get": {
        "description": "Возвращает детальную информацию о бренде (включая список типов продуктов с доступными для текущего workspace офферами) по его ID (UUID) или уникальному слагу (slug).",
        "operationId": "BrandsController_findByIdOrSlug",
        "parameters": [
          {
            "name": "idOrSlug",
            "required": true,
            "in": "path",
            "description": "UUID или уникальный slug бренда (например, \"mlbb\" или \"0199c440-149f-77d9-99f1-9a9c18037bea\")",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Информация о бренде",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BrandDetailResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "BRAND_NOT_FOUND"
                          ],
                          "x-enum-descriptions": {
                            "BRAND_NOT_FOUND": "Бренд с указанным ID или slug не найден или недоступен для текущего workspace"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Детальная информация о бренде",
        "tags": [
          "Brands"
        ]
      }
    },
    "/v1/orders/validate": {
      "post": {
        "description": "Проверяет данные получателя (`input` в формате `order_input_schema` оффера) для указанного бренда (`brand_id` — UUID или `slug`) и опционального типа продукта (`product_id` — UUID или `slug`), возвращает данные проверенного получателя (игровой никнейм или профиль пользователя) и список доступных для покупки персональных лимитированных офферов воркспейса.",
        "operationId": "OrdersController_validate",
        "parameters": [],
        "requestBody": {
          "required": true,
          "description": "Идентификатор бренда, опциональный тип продукта и данные получателя из order_input_schema",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ValidateOrderDto"
              },
              "examples": {
                "mlbb_by_slug": {
                  "summary": "Mobile Legends: Bang Bang (по slug)",
                  "value": {
                    "brand_id": "mlbb",
                    "product_id": "crystals",
                    "input": {
                      "game_user_key": "1919293471",
                      "game_server_key": "6956"
                    }
                  }
                },
                "mlbb_by_uuid": {
                  "summary": "Mobile Legends: Bang Bang (по UUID)",
                  "value": {
                    "brand_id": "0199c440-149f-77d9-99f1-9a9c18037bea",
                    "product_id": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7",
                    "input": {
                      "game_user_key": "1919293471",
                      "game_server_key": "6956"
                    }
                  }
                },
                "telegram_stars": {
                  "summary": "Telegram Stars",
                  "value": {
                    "brand_id": "telegram",
                    "product_id": "stars",
                    "input": {
                      "username": "durov"
                    }
                  }
                },
                "telegram_premium": {
                  "summary": "Telegram Premium",
                  "value": {
                    "brand_id": "telegram",
                    "product_id": "premium",
                    "input": {
                      "username": "durov"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidateOrderResponseDto"
                },
                "examples": {
                  "mlbb_available_limited_offers": {
                    "summary": "Mobile Legends: Bang Bang — игрок найден, доступны лимитированные офферы",
                    "value": {
                      "recipient": {
                        "name": "Индиана*24",
                        "username": null,
                        "avatar_url": null
                      },
                      "limited_offers": [
                        {
                          "id": "01981de8-7cb6-77e0-a2f0-3a174689750d",
                          "offer_title": "150+150"
                        }
                      ]
                    }
                  },
                  "telegram_recipient": {
                    "summary": "Telegram — пользователь найден",
                    "value": {
                      "recipient": {
                        "name": "Pavel Durov",
                        "username": "durov",
                        "avatar_url": "https://t.me/i/userpic/320/durov.jpg"
                      },
                      "limited_offers": []
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED",
                            "INVALID_ORDER_INPUT"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации структуры тела запроса",
                            "INVALID_ORDER_INPUT": "Поле input не соответствует JSON-схеме order_input_schema продукта"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "BRAND_NOT_FOUND",
                            "PRODUCT_NOT_FOUND",
                            "VALIDATION_NOT_SUPPORTED",
                            "INVALID_RECIPIENT"
                          ],
                          "x-enum-descriptions": {
                            "BRAND_NOT_FOUND": "Бренд с указанным brand_id (UUID или slug) не найден",
                            "PRODUCT_NOT_FOUND": "Продукт с указанным product_id (UUID или slug) не найден",
                            "VALIDATION_NOT_SUPPORTED": "Внешняя предзаказная проверка получателя не поддерживается для указанного бренда или product_id",
                            "INVALID_RECIPIENT": "Получатель не найден либо не может принять выбранный продукт"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "RATE_LIMIT_EXCEEDED"
                          ],
                          "x-enum-descriptions": {
                            "RATE_LIMIT_EXCEEDED": "Превышен лимит запросов на проверку получателя, повторите попытку позже"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          },
          "502": {
            "description": "Bad Gateway",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "UPSTREAM_UNAVAILABLE"
                          ],
                          "x-enum-descriptions": {
                            "UPSTREAM_UNAVAILABLE": "Внешний сервис проверки получателя временно недоступен"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "summary": "Валидация перед заказом",
        "tags": [
          "Orders"
        ],
        "x-handler": "return {\"recipient\":{\"name\":\"Индиана*24\",\"username\":null,\"avatar_url\":null},\"limited_offers\":[{\"id\":\"01981de8-7cb6-77e0-a2f0-3a174689750d\",\"offer_title\":\"150+150\"}]}"
      }
    },
    "/v1/orders": {
      "post": {
        "description": "Создает новый заказ с указанными данными.",
        "operationId": "OrdersController_create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "description": "Данные для создания заказа",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateOrderDto"
              },
              "examples": {
                "mlbb_ru_50": {
                  "summary": "MLBB Crystals 50+50",
                  "value": {
                    "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                    "input": {
                      "game_user_key": "1919293471",
                      "game_server_key": "6956"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderResponseDto"
                },
                "examples": {
                  "mlbb_ru_50_50": {
                    "summary": "MLBB Crystals 50+50",
                    "value": {
                      "id": "019818bc-1285-7c55-9477-5020aebf7782",
                      "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_150_150": {
                    "summary": "MLBB Crystals 150+150",
                    "value": {
                      "id": "019aefaa-a624-7b8b-8bdc-c8297cbe9004",
                      "offer_id": "01981de8-7cb6-77e0-a2f0-3a174689750d",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_250_250": {
                    "summary": "MLBB Crystals 250+250",
                    "value": {
                      "id": "019aefac-58c0-7f8d-a38f-882a2205b8e0",
                      "offer_id": "01981de8-7cb7-7cc9-8037-39dc04d7dadb",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_500_500": {
                    "summary": "MLBB Crystals 500+500",
                    "value": {
                      "id": "019aefac-6b89-7477-a813-e1c7df2fcaba",
                      "offer_id": "01981de8-7cb9-7d9c-810e-fe6448e91652",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_32_3": {
                    "summary": "MLBB Crystals 32+3",
                    "value": {
                      "id": "019afced-81da-7fa2-a6a2-41fbf84cc77a",
                      "offer_id": "01997a9d-3d8d-7e85-b757-c31b4769c764",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_50_5": {
                    "summary": "MLBB Crystals 50+5",
                    "value": {
                      "id": "019afced-81da-7fac-b08f-2cf2427b7aa1",
                      "offer_id": "01997a9d-3d8e-70dd-8eff-d96b7dbc5201",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_150_15": {
                    "summary": "MLBB Crystals 150+15",
                    "value": {
                      "id": "019afced-81da-7fb6-bef5-28f9ea8b121b",
                      "offer_id": "01997a9d-3d8f-78fc-a1c3-7912320734d9",
                      "status": "pending"
                    }
                  },
                  "mlbb_ru_250_25": {
                    "summary": "MLBB Crystals 250+25",
                    "value": {
                      "id": "019afced-81da-7fc0-8f48-89e95f288a3d",
                      "offer_id": "01997a9d-3d90-771d-9a4e-2ff212888b98",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_500_65": {
                    "summary": "MLBB Crystals 500+65",
                    "value": {
                      "id": "019afced-81da-7fca-8496-16a78cff50d5",
                      "offer_id": "01997a9d-3d91-7040-a651-6dd334878ac0",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_1000_155": {
                    "summary": "MLBB Crystals 1000+155",
                    "value": {
                      "id": "019afced-81da-7fdf-9f78-78b95b38ec81",
                      "offer_id": "01997a9d-3d92-7a5e-8be3-0d0af262abdb",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_1500_265": {
                    "summary": "MLBB Crystals 1500+265",
                    "value": {
                      "id": "019afced-81da-7fd4-b8d5-0a6ddc325f64",
                      "offer_id": "01997a9d-3d92-73c0-a5c4-d6b685d13f0b",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_2500_475": {
                    "summary": "MLBB Crystals 2500+475",
                    "value": {
                      "id": "019afced-81da-7fe8-97b8-6352cb643e83",
                      "offer_id": "01997a9d-3d93-7206-97a2-5ef197889cc2",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_5000_1000": {
                    "summary": "MLBB Crystals 5000+1000",
                    "value": {
                      "id": "019afced-81da-7ff2-b4e6-15fd27155bd9",
                      "offer_id": "01997a9d-3d94-79b0-b847-a44b7371f22d",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED",
                            "INVALID_ORDER_INPUT"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации структуры тела запроса",
                            "INVALID_ORDER_INPUT": "Поле input не соответствует JSON-схеме order_input_schema продукта"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "402": {
            "description": "Payment Required",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "ACCOUNT_NOT_FOUND",
                            "ACCOUNT_HAS_NO_ENOUGH_BALANCE"
                          ],
                          "x-enum-descriptions": {
                            "ACCOUNT_NOT_FOUND": "Балансовый счёт воркспейса для валюты оффера не найден",
                            "ACCOUNT_HAS_NO_ENOUGH_BALANCE": "На балансе воркспейса недостаточно средств для создания заказа"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "OFFER_ID_NOT_FOUND",
                            "ORDER_ID_NOT_FOUND",
                            "OFFER_HAS_NO_VALID_PRICES",
                            "OFFER_NOT_AVAILABLE"
                          ],
                          "x-enum-descriptions": {
                            "OFFER_ID_NOT_FOUND": "Оффер с указанным offer_id не найден или недоступен воркспейсу",
                            "ORDER_ID_NOT_FOUND": "Заказ с указанным ID не найден в текущем воркспейсе",
                            "OFFER_HAS_NO_VALID_PRICES": "Для оффера не настроена актуальная цена в поддерживаемой валюте",
                            "OFFER_NOT_AVAILABLE": "Оффер временно отключён (disabled: true) и недоступен для заказа"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Создать заказ",
        "tags": [
          "Orders"
        ],
        "x-handler": "return store.create('Order', { id: faker.string.uuid(), offer_id: req.body.offer_id, status: 'pending' })"
      },
      "get": {
        "description": "Получает список всех заказов текущего воркспейса с поддержкой пагинации и фильтрации.",
        "operationId": "OrdersController_findAll",
        "parameters": [
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Количество заказов на странице",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 50,
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "required": false,
            "in": "query",
            "description": "Смещение",
            "schema": {
              "minimum": 0,
              "default": 0,
              "type": "integer"
            }
          },
          {
            "name": "offer_id",
            "required": false,
            "in": "query",
            "description": "ID предложения для фильтрации",
            "schema": {
              "format": "uuid",
              "example": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
              "type": "string"
            }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "description": "Статус заказа для фильтрации",
            "schema": {
              "type": "string",
              "enum": [
                "pending",
                "processing",
                "completed",
                "error",
                "failed"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/PaginatedDto"
                    },
                    {
                      "properties": {
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/OrderResponseDto"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Список моих заказов",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v1/orders/{id}": {
      "get": {
        "description": "Возвращает заказ с указанным ID.",
        "operationId": "OrdersController_findOne",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Уникальный идентификатор заказа",
            "schema": {
              "example": "019818bc-1285-7c55-9477-5020aebf7782",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderResponseDto"
                },
                "examples": {
                  "mlbb_ru_50_50_pending": {
                    "summary": "MLBB Crystals 50+50 - pending",
                    "value": {
                      "id": "019818bc-1285-7c55-9477-5020aebf7782",
                      "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                      "status": "pending",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_150_150_processing": {
                    "summary": "MLBB Crystals 150+150 - processing",
                    "value": {
                      "id": "019aefaa-a624-7b8b-8bdc-c8297cbe9004",
                      "offer_id": "01981de8-7cb6-77e0-a2f0-3a174689750d",
                      "status": "processing",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_250_250_completed": {
                    "summary": "MLBB Crystals 250+250 - completed",
                    "value": {
                      "id": "019aefac-58c0-7f8d-a38f-882a2205b8e0",
                      "offer_id": "01981de8-7cb7-7cc9-8037-39dc04d7dadb",
                      "status": "completed",
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  },
                  "mlbb_ru_500_500_error": {
                    "summary": "MLBB Crystals 500+500 - error",
                    "value": {
                      "id": "019aefac-6b89-7477-a813-e1c7df2fcaba",
                      "offer_id": "01981de8-7cb9-7d9c-810e-fe6448e91652",
                      "status": "error",
                      "price": "1.0958",
                      "currency": "USD",
                      "reason": {
                        "code": "PURCHASE_LIMIT_EXCEEDED",
                        "message": "Purchase limit exceeded for this product or account"
                      }
                    }
                  },
                  "mlbb_ru_50_50_failed": {
                    "summary": "MLBB Crystals 50+50 - failed",
                    "value": {
                      "id": "019818bc-1285-7c55-9477-5020aebf7782",
                      "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                      "status": "failed",
                      "price": "1.0958",
                      "currency": "USD",
                      "reason": {
                        "code": "PURCHASE_LIMIT_EXCEEDED",
                        "message": "Purchase limit exceeded for this product or account"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "ORDER_ID_NOT_FOUND"
                          ],
                          "x-enum-descriptions": {
                            "ORDER_ID_NOT_FOUND": "Заказ с указанным ID не найден в текущем воркспейсе"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Данные заказа",
        "tags": [
          "Orders"
        ],
        "x-handler": "return store.get('Order', req.params.id)"
      }
    },
    "/v1/orders/{id}/credentials": {
      "post": {
        "description": "Принимает учетные данные (код подтверждения, ссылку, пароль и т.д.) для продолжения обработки и успешного выполнения заказа.",
        "operationId": "OrdersController_submitCredentials",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Уникальный идентификатор заказа",
            "schema": {
              "example": "019818bc-1285-7c55-9477-5020aebf7782",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Учетные данные для заказа",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitOrderCredentialsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Учетные данные успешно приняты",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Credentials submitted successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Передать учетные данные для заказа",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v1/orders/{id}/confirm-receipt": {
      "post": {
        "description": "Вызывается партнером при подтверждении получения цифрового товара покупателем. Завершает обработку заказа.",
        "operationId": "OrdersController_confirmReceipt",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Уникальный идентификатор заказа",
            "schema": {
              "example": "019818bc-1285-7c55-9477-5020aebf7782",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Получение заказа успешно подтверждено",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Order receipt confirmed successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Подтверждение получения заказа",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v1/orders/{id}/dispute": {
      "post": {
        "description": "Вызывается партнером в случае неполучения цифрового товара или возникновения проблем. Приостанавливает завершение заказа и передает обращение в арбитраж поставщика.",
        "operationId": "OrdersController_disputeOrder",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Уникальный идентификатор заказа",
            "schema": {
              "example": "019818bc-1285-7c55-9477-5020aebf7782",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Данные спора / причина проблемы",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisputeOrderDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Обращение по заказу успешно зарегистрировано",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Order dispute submitted successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Открытие спора по заказу",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v1/webhooks": {
      "post": {
        "description": "Устанавливает URL-адрес вашего сервера для получения уведомлений о событиях.\n\n  > [!IMPORTANT]\n  > Ваш сервер должен быть доступен по **HTTPS** и возвращать **200 OK** при успешном получении уведомления.\n\n  ### 🚚 Гарантия доставки\n  Мы используем принцип **at-least-once**: это означает, что уведомление будет доставлено как минимум один раз, но изредка возможны повторные отправки одного и того же события.\n\n  > [!TIP]\n  > **Идемпотентность**: Ваш сервер должен корректно обрабатывать дубликаты. Используйте заголовок `X-Event-Id` для проверки, было ли событие обработано ранее.\n\n  ### 🔄 Повторные попытки (Retries)\n  Если ваш сервер недоступен или возвращает ошибку, мы повторим попытку 8 раз по расписанию: через **1м, 5м, 30м, 1ч, 3ч, 6ч, 12ч и 24ч**.  \n\n  > [!NOTE]\n  > Любой HTTP-код **2xx** считается успешным приёмом и останавливает очередь ретраев.  \n  > \n  > Любой другой HTTP-код (кроме 2xx) или таймаут приведет к повторной попытке согласно расписанию.  \n\n  ### 🔐 Проверка подписи (Security)\n  Мы подписываем каждый Webhook, чтобы вы могли убедиться, что он отправлен именно нами. Подпись передается в заголовке `X-Signature` (в формате `sha256=...`).\n\n  **Алгоритм проверки:**\n  1. Получите ваш **Webhook Secret** (секретный ключ) в личном кабинете.\n  2. Извлеките время из заголовка `X-Timestamp`.\n  3. Возьмите **сырое (нераспарсенное)** тело запроса.\n  4. Сформируйте строку-сообщение, соединив время и тело через точку: `{timestamp}.{rawBody}`.\n  5. Вычислите **HMAC-SHA256** хеш от этой строки, используя ваш секретный ключ.\n  6. Сравните результат (с префиксом `sha256=`) со значением из заголовка `X-Signature`.\n\n  > [!WARNING]\n  > **Самая частая ошибка** — использование распарсенного JSON-тела. Фреймворки (например, Express) часто автоматически парсят JSON, удаляя лишние пробелы. При вычислении подписи нужно обязательно использовать **оригинальное, нетронутое** тело запроса в виде байтов (`Buffer`) или строки.\n\n  <details>\n  <summary>Показать примеры кода (TypeScript, PHP, Python)</summary>\n\n  #### TypeScript (Native Node.js)\n  ```typescript\n  import * as http from 'http';\n  import * as crypto from 'crypto';\n\n  const SECRET = 'your_webhook_secret';\n\n  const server = http.createServer((req, res) => {\n    if (req.method !== 'POST') {\n      res.writeHead(405).end('Method Not Allowed');\n      return;\n    }\n\n    const timestamp = req.headers['x-timestamp'] as string;\n    const signatureHeader = req.headers['x-signature'] as string;\n    \n    // Собираем сырое тело запроса по кусочкам (chunks)\n    const chunks: Buffer[] = [];\n    req.on('data', (chunk) => chunks.push(chunk));\n\n    req.on('end', () => {\n      const rawBody = Buffer.concat(chunks);\n\n      if (!timestamp || !signatureHeader) {\n        res.writeHead(400).end('Bad Request');\n        return;\n      }\n\n      // Вычисляем подпись\n      const signature = crypto.createHmac('sha256', SECRET)\n        .update(timestamp + '.')\n        .update(rawBody) // передаем оригинальный Buffer\n        .digest('hex');\n        \n      const isValid = ('sha256=' + signature) === signatureHeader;\n      \n      if (isValid) {\n        res.writeHead(200).end('OK');\n      } else {\n        res.writeHead(401).end('Unauthorized');\n      }\n    });\n  });\n\n  server.listen(3000, () => console.log('Server running on port 3000'));\n  ```\n\n  #### PHP (Встроенный веб-сервер / PHP-FPM)\n  ```php\n  <?php\n  if ($_SERVER['REQUEST_METHOD'] !== 'POST') {\n      http_response_code(405);\n      exit('Method Not Allowed');\n  }\n\n  $secret = 'your_webhook_secret';\n  $timestamp = $_SERVER['HTTP_X_TIMESTAMP'] ?? '';\n  $signatureHeader = $_SERVER['HTTP_X_SIGNATURE'] ?? '';\n  \n  // file_get_contents('php://input') получает оригинальное сырое тело запроса\n  $body = file_get_contents('php://input'); \n  \n  $signature = hash_hmac('sha256', $timestamp . '.' . $body, $secret);\n  $isValid = ('sha256=' . $signature) === $signatureHeader;\n\n  if ($isValid) {\n      http_response_code(200);\n      echo 'OK';\n  } else {\n      http_response_code(401);\n      echo 'Unauthorized';\n  }\n  ```\n\n  #### Python (Flask)\n  ```python\n  import hmac\n  import hashlib\n  from flask import request\n\n  @app.route('/webhook', methods=['POST'])\n  def webhook():\n      secret = b'your_webhook_secret'\n      timestamp = request.headers.get('X-Timestamp')\n      body = request.get_data() # Получает сырые байты тела запроса\n      \n      message = timestamp.encode() + b'.' + body\n      signature = hmac.new(secret, message, hashlib.sha256).hexdigest()\n      \n      is_valid = f\"sha256={signature}\" == request.headers.get('X-Signature')\n      \n      if is_valid:\n          return \"OK\", 200\n      return \"Unauthorized\", 401\n  ```\n\n  </details>",
        "operationId": "WebhooksController_setWebhook",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebhookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Webhook URL успешно установлен",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SetWebhookResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Настроить Webhook",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "/v1/accounts": {
      "get": {
        "description": "Получает список счетов текущего воркспейса.",
        "operationId": "AccountsController_list",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResellerAccountsListResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров или структуры тела запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Список счетов",
        "tags": [
          "Accounts"
        ]
      }
    },
    "/v1/offers": {
      "get": {
        "description": "Получает список всех доступных офферов с поддержкой пагинации.",
        "operationId": "OffersController_findAll",
        "parameters": [
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Количество офферов на странице",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 50,
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "required": false,
            "in": "query",
            "description": "Смещение",
            "schema": {
              "minimum": 0,
              "default": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/PaginatedDto"
                    },
                    {
                      "properties": {
                        "results": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/OfferListItemResponseDto"
                          }
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "offers": {
                    "summary": "Offers",
                    "value": {
                      "total": 13,
                      "limit": 50,
                      "offset": 0,
                      "results": [
                        {
                          "id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "50+50",
                          "offer_description": null,
                          "disabled": false,
                          "limited": true,
                          "price": "1.0958",
                          "currency": "USD"
                        },
                        {
                          "id": "01981de8-7cb6-77e0-a2f0-3a174689750d",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "150+150",
                          "offer_description": null,
                          "disabled": false,
                          "limited": true,
                          "price": "3.2876",
                          "currency": "USD"
                        },
                        {
                          "id": "01981de8-7cb7-7cc9-8037-39dc04d7dadb",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "250+250",
                          "offer_description": null,
                          "disabled": false,
                          "limited": true,
                          "price": "5.4793",
                          "currency": "USD"
                        },
                        {
                          "id": "01981de8-7cb9-7d9c-810e-fe6448e91652",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "500+500",
                          "offer_description": null,
                          "disabled": false,
                          "limited": true,
                          "price": "11.0271",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d8d-7e85-b757-c31b4769c764",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "32+3",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "0.6383",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d8e-70dd-8eff-d96b7dbc5201",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "50+5",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "1.0012",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d8f-78fc-a1c3-7912320734d9",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "150+15",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "3.0036",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d90-771d-9a4e-2ff212888b98",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "250+25",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "5.0061",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d91-7040-a651-6dd334878ac0",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "500+65",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "10.0747",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d92-73c0-a5c4-d6b685d13f0b",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "1500+265",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "30.2243",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d92-7a5e-8be3-0d0af262abdb",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "1000+155",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "20.2121",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d93-7206-97a2-5ef197889cc2",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "2500+475",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "50.4363",
                          "currency": "USD"
                        },
                        {
                          "id": "01997a9d-3d94-79b0-b847-a44b7371f22d",
                          "brand_slug": "mlbb",
                          "brand_title": "Mobile Legends: Bang Bang",
                          "product_slug": "crystals",
                          "product_title": "Кристаллы",
                          "offer_title": "5000+1000",
                          "offer_description": null,
                          "disabled": false,
                          "limited": false,
                          "price": "100.7475",
                          "currency": "USD"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Список офферов",
        "tags": [
          "Offers"
        ],
        "x-handler": "return {\"total\":13,\"limit\":50,\"offset\":0,\"results\":[{\"id\":\"01981de8-7cb4-7f54-8672-57eb8ee8b47e\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"50+50\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"1.0958\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb6-77e0-a2f0-3a174689750d\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"150+150\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"3.2876\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb7-7cc9-8037-39dc04d7dadb\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"250+250\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"5.4793\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb9-7d9c-810e-fe6448e91652\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"500+500\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"11.0271\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8d-7e85-b757-c31b4769c764\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"32+3\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"0.6383\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8e-70dd-8eff-d96b7dbc5201\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"50+5\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"1.0012\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8f-78fc-a1c3-7912320734d9\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"150+15\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"3.0036\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d90-771d-9a4e-2ff212888b98\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"250+25\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"5.0061\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d91-7040-a651-6dd334878ac0\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"500+65\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"10.0747\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d92-73c0-a5c4-d6b685d13f0b\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"1500+265\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"30.2243\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d92-7a5e-8be3-0d0af262abdb\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"1000+155\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"20.2121\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d93-7206-97a2-5ef197889cc2\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"2500+475\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"50.4363\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d94-79b0-b847-a44b7371f22d\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"5000+1000\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"100.7475\",\"currency\":\"USD\"}]}"
      }
    },
    "/v1/offers/{id}": {
      "get": {
        "description": "Получает один оффер по его ID.",
        "operationId": "OffersController_findOne",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "ID оффера",
            "schema": {
              "format": "uuid",
              "example": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferResponseDto"
                },
                "examples": {
                  "mlbb_ru_50_50": {
                    "summary": "MLBB Crystals 50+50",
                    "value": {
                      "id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
                      "miniapp_id": null,
                      "brand_slug": "mlbb",
                      "brand_title": "Mobile Legends: Bang Bang",
                      "product_slug": "crystals",
                      "product_title": "Кристаллы",
                      "offer_title": "50+50",
                      "offer_description": null,
                      "disabled": false,
                      "limited": true,
                      "order_input_schema": {
                        "type": "object",
                        "required": [
                          "game_user_key",
                          "game_server_key"
                        ],
                        "properties": {
                          "game_user_key": {
                            "type": "string"
                          },
                          "game_server_key": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      },
                      "price": "1.0958",
                      "currency": "USD"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "VALIDATION_FAILED"
                          ],
                          "x-enum-descriptions": {
                            "VALIDATION_FAILED": "Ошибка валидации параметров запроса"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_MISSING",
                            "API_KEY_INVALID",
                            "API_KEY_EXPIRED"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_MISSING": "Заголовок Authorization: Bearer <API_KEY> отсутствует",
                            "API_KEY_INVALID": "Указан недействительный API-ключ",
                            "API_KEY_EXPIRED": "Срок действия API-ключа истёк"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "API_KEY_SCOPE_FORBIDDEN"
                          ],
                          "x-enum-descriptions": {
                            "API_KEY_SCOPE_FORBIDDEN": "У API-ключа отсутствует необходимый scope доступа для данного метода"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ErrorResponseDto"
                    },
                    {
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "OFFER_ID_NOT_FOUND"
                          ],
                          "x-enum-descriptions": {
                            "OFFER_ID_NOT_FOUND": "Оффер с указанным ID не найден или недоступен воркспейсу"
                          },
                          "description": "Код ошибки"
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseDto"
                },
                "example": {
                  "message": "Internal server error"
                }
              }
            }
          }
        },
        "summary": "Получить оффер",
        "tags": [
          "Offers"
        ],
        "x-handler": "const offers = [{\"id\":\"01981de8-7cb4-7f54-8672-57eb8ee8b47e\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"50+50\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"1.0958\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb6-77e0-a2f0-3a174689750d\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"150+150\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"3.2876\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb7-7cc9-8037-39dc04d7dadb\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"250+250\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"5.4793\",\"currency\":\"USD\"},{\"id\":\"01981de8-7cb9-7d9c-810e-fe6448e91652\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"500+500\",\"offer_description\":null,\"disabled\":false,\"limited\":true,\"price\":\"11.0271\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8d-7e85-b757-c31b4769c764\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"32+3\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"0.6383\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8e-70dd-8eff-d96b7dbc5201\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"50+5\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"1.0012\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d8f-78fc-a1c3-7912320734d9\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"150+15\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"3.0036\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d90-771d-9a4e-2ff212888b98\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"250+25\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"5.0061\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d91-7040-a651-6dd334878ac0\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"500+65\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"10.0747\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d92-73c0-a5c4-d6b685d13f0b\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"1500+265\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"30.2243\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d92-7a5e-8be3-0d0af262abdb\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"1000+155\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"20.2121\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d93-7206-97a2-5ef197889cc2\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"2500+475\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"50.4363\",\"currency\":\"USD\"},{\"id\":\"01997a9d-3d94-79b0-b847-a44b7371f22d\",\"brand_slug\":\"mlbb\",\"brand_title\":\"Mobile Legends: Bang Bang\",\"product_slug\":\"crystals\",\"product_title\":\"Кристаллы\",\"offer_title\":\"5000+1000\",\"offer_description\":null,\"disabled\":false,\"limited\":false,\"price\":\"100.7475\",\"currency\":\"USD\"}]; return offers.find(o => o.id === req.params.id) || offers[0]"
      }
    }
  },
  "info": {
    "title": "api.dandanpay.net",
    "description": "API для автоматической доставки цифровых товаров.",
    "version": "1.0",
    "contact": {}
  },
  "tags": [
    {
      "name": "Accounts",
      "description": "Аккаунты",
      "kind": "nav"
    },
    {
      "name": "Brands",
      "description": "Каталог брендов.",
      "kind": "nav"
    },
    {
      "name": "Offers",
      "description": "Каталог доступных офферов.",
      "kind": "nav"
    },
    {
      "name": "Orders",
      "description": "Создание и получение заказов.",
      "kind": "nav"
    },
    {
      "name": "Webhooks",
      "description": "Исходящие уведомления.",
      "kind": "nav"
    }
  ],
  "servers": [
    {
      "url": "https://api.dandanpay.net"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http",
        "description": "API-ключ авторизации"
      }
    },
    "schemas": {
      "ErrorResponseDto": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Сообщение об ошибке"
          },
          "code": {
            "type": "string",
            "description": "Код ошибки",
            "nullable": true
          }
        },
        "required": [
          "message"
        ]
      },
      "PaginatedDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "number",
            "description": "Общее количество элементов",
            "example": 1
          },
          "limit": {
            "type": "number",
            "description": "Количество элементов на странице",
            "example": 50
          },
          "offset": {
            "type": "number",
            "description": "Смещение",
            "example": 0
          }
        },
        "required": [
          "total",
          "limit",
          "offset"
        ]
      },
      "BrandLogoDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL логотипа",
            "example": "https://cdn.example.com/brands/mlbb.png"
          },
          "alt": {
            "type": "string",
            "description": "Alt-текст",
            "example": "Mobile Legends: Bang Bang logo"
          },
          "width": {
            "type": "number",
            "description": "Ширина логотипа в px",
            "example": 120
          },
          "height": {
            "type": "number",
            "description": "Высота логотипа в px",
            "example": 120
          }
        },
        "required": [
          "url"
        ]
      },
      "BrandProductDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID продукта (UUID, может передаваться как product_id в POST /v1/orders/validate)",
            "example": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7"
          },
          "slug": {
            "type": "string",
            "description": "Символьный код (slug) типа продукта (соответствует product_slug в GET /v1/offers и принимается как product_id в POST /v1/orders/validate)",
            "example": "crystals"
          },
          "title": {
            "type": "string",
            "description": "Название типа продукта",
            "example": "Кристаллы"
          }
        },
        "required": [
          "id",
          "slug",
          "title"
        ]
      },
      "BrandListItemResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID бренда (UUID)",
            "example": "0199c440-149f-77d9-99f1-9a9c18037bea"
          },
          "slug": {
            "type": "string",
            "description": "Слаг бренда",
            "example": "mlbb"
          },
          "title": {
            "type": "string",
            "description": "Название бренда",
            "example": "Mobile Legends: Bang Bang"
          },
          "description": {
            "type": "object",
            "description": "Мультиязычное описание бренда",
            "additionalProperties": {
              "type": "string"
            },
            "example": {
              "ru": "Описание бренда на русском",
              "en": "Brand description in English"
            }
          },
          "logo": {
            "description": "Метаданные логотипа бренда",
            "nullable": true,
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/BrandLogoDto"
              }
            ]
          },
          "faq": {
            "type": "object",
            "description": "Мультиязычный список часто задаваемых вопросов (FAQ), сгруппированный по кодам языков",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/BrandFaqItemDto"
              }
            },
            "example": {
              "ru": [
                {
                  "question": "Как активировать товар?",
                  "answer": "Инструкция по активации..."
                }
              ],
              "en": [
                {
                  "question": "How to activate item?",
                  "answer": "Activation instructions..."
                }
              ]
            }
          },
          "products": {
            "description": "Список типов продуктов, доступных у данного бренда",
            "example": [
              {
                "id": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7",
                "slug": "crystals",
                "title": "Кристаллы"
              },
              {
                "id": "019addf8-df00-7dac-a79d-1494d7a1ae04",
                "slug": "topup",
                "title": "Topup"
              }
            ],
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BrandProductDto"
            }
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата создания",
            "example": "2025-11-28T16:22:22.699Z"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата обновления",
            "example": "2026-01-23T06:46:06.889Z"
          }
        },
        "required": [
          "id",
          "slug",
          "title",
          "faq",
          "products",
          "created_at",
          "updated_at"
        ]
      },
      "BrandDetailResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID бренда (UUID)",
            "example": "0199c440-149f-77d9-99f1-9a9c18037bea"
          },
          "slug": {
            "type": "string",
            "description": "Слаг бренда",
            "example": "mlbb"
          },
          "title": {
            "type": "string",
            "description": "Название бренда",
            "example": "Mobile Legends: Bang Bang"
          },
          "description": {
            "type": "object",
            "description": "Мультиязычное описание бренда",
            "additionalProperties": {
              "type": "string"
            },
            "example": {
              "ru": "Описание бренда на русском",
              "en": "Brand description in English"
            }
          },
          "logo": {
            "description": "Метаданные логотипа бренда",
            "nullable": true,
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/BrandLogoDto"
              }
            ]
          },
          "faq": {
            "type": "object",
            "description": "Мультиязычный список часто задаваемых вопросов (FAQ), сгруппированный по кодам языков",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/BrandFaqItemDto"
              }
            },
            "example": {
              "ru": [
                {
                  "question": "Как активировать товар?",
                  "answer": "Инструкция по активации..."
                }
              ],
              "en": [
                {
                  "question": "How to activate item?",
                  "answer": "Activation instructions..."
                }
              ]
            }
          },
          "products": {
            "description": "Список типов продуктов, доступных у данного бренда",
            "example": [
              {
                "id": "019aca0a-269b-77bf-aa77-a05ddfd7c3e7",
                "slug": "crystals",
                "title": "Кристаллы"
              },
              {
                "id": "019addf8-df00-7dac-a79d-1494d7a1ae04",
                "slug": "topup",
                "title": "Topup"
              }
            ],
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BrandProductDto"
            }
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата создания",
            "example": "2025-11-28T16:22:22.699Z"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата обновления",
            "example": "2026-01-23T06:46:06.889Z"
          }
        },
        "required": [
          "id",
          "slug",
          "title",
          "faq",
          "products",
          "created_at",
          "updated_at"
        ]
      },
      "BrandFaqItemDto": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string",
            "description": "Вопрос",
            "example": "Как активировать товар данного бренда?"
          },
          "answer": {
            "type": "string",
            "description": "Ответ",
            "example": "Для активации перейдите в личный кабинет..."
          }
        },
        "required": [
          "question",
          "answer"
        ]
      },
      "OrderReasonDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Код ошибки",
            "enum": [
              "PURCHASE_LIMIT_EXCEEDED",
              "INVALID_RECIPIENT"
            ],
            "example": "PURCHASE_LIMIT_EXCEEDED",
            "x-enum-descriptions": {
              "PURCHASE_LIMIT_EXCEEDED": "Превышен лимит покупок для данного товара или аккаунта (Purchase limit exceeded)",
              "INVALID_RECIPIENT": "Не найден пользователь или неверные данные получателя (Invalid recipient)"
            }
          },
          "message": {
            "type": "string",
            "description": "Описание ошибки",
            "example": "Purchase limit exceeded for this product or account"
          }
        },
        "required": [
          "code",
          "message"
        ]
      },
      "OrderResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID заказа (order)",
            "format": "uuid"
          },
          "offer_id": {
            "type": "string",
            "description": "ID предложения (offer)",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "description": "Статус заказа в системе",
            "enum": [
              "pending",
              "processing",
              "completed",
              "error",
              "failed"
            ],
            "x-enum-descriptions": {
              "pending": "заказ создан",
              "processing": "обработка заказа",
              "completed": "заказ выполнен [конечный статус]",
              "error": "ошибка [может быть перезапущен в pending]",
              "failed": "ошибка [конечный статус]"
            }
          },
          "price": {
            "type": "string",
            "example": "1.0958",
            "description": "Сумма заказа (decimal string, до 6 знаков после запятой без лишних нулей)"
          },
          "currency": {
            "type": "string",
            "description": "Валюта заказа",
            "enum": [
              "USD"
            ],
            "example": "USD"
          },
          "reason": {
            "description": "Причина ошибки (присутствует при статусах error или failed)",
            "nullable": true,
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/OrderReasonDto"
              }
            ]
          },
          "delivered_at": {
            "type": "object",
            "description": "Время доставки / отгрузки товара",
            "example": "2026-09-12T10:00:00.000Z",
            "nullable": true
          },
          "client_confirmed_at": {
            "type": "object",
            "description": "Время подтверждения получения заказа клиентом",
            "example": "2026-09-12T11:00:00.000Z",
            "nullable": true
          },
          "disputed_at": {
            "type": "object",
            "description": "Время открытия спора клиентом",
            "example": "2026-09-12T11:00:00.000Z",
            "nullable": true
          },
          "auto_confirm_at": {
            "type": "object",
            "description": "Дедлайн автоподтверждения заказа по SLA при отсутствии действий клиента",
            "example": "2026-09-13T10:00:00.000Z",
            "nullable": true
          }
        },
        "required": [
          "id",
          "offer_id",
          "status",
          "price",
          "currency"
        ]
      },
      "ValidatedLimitedOfferDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "UUID лимитированного оффера из каталога воркспейса",
            "format": "uuid",
            "example": "01981de8-7cb6-77e0-a2f0-3a174689750d"
          },
          "offer_title": {
            "type": "string",
            "description": "Название оффера",
            "example": "150+150"
          }
        },
        "required": [
          "id",
          "offer_title"
        ]
      },
      "ValidatedRecipientDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Отображаемое имя пользователя или игровой никнейм получателя",
            "example": "Индиана*24"
          },
          "username": {
            "type": "string",
            "description": "Нормализованный логин получателя (без ведущего @) либо null, если для бренда логин не используется",
            "nullable": true,
            "example": null
          },
          "avatar_url": {
            "type": "string",
            "description": "Публичный URL аватара получателя либо null, если аватар отсутствует",
            "nullable": true,
            "example": null
          }
        },
        "required": [
          "name",
          "username",
          "avatar_url"
        ]
      },
      "ValidateOrderResponseDto": {
        "type": "object",
        "properties": {
          "recipient": {
            "description": "Информация о проверенном получателе",
            "allOf": [
              {
                "$ref": "#/components/schemas/ValidatedRecipientDto"
              }
            ]
          },
          "limited_offers": {
            "description": "Список лимитированных офферов воркспейса (акции первого пополнения, пропуски, бандлы), доступных для покупки данному получателю. Для брендов без персональных лимитированных офферов возвращается пустой массив.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidatedLimitedOfferDto"
            }
          }
        },
        "required": [
          "recipient",
          "limited_offers"
        ]
      },
      "ValidateOrderDto": {
        "type": "object",
        "properties": {
          "brand_id": {
            "type": "string",
            "description": "UUID или символьный код (slug) бренда из оффера (например, mlbb или telegram)",
            "example": "mlbb"
          },
          "product_id": {
            "type": "string",
            "description": "Опциональный UUID или символьный код (slug) типа продукта (например, crystals, stars или premium). Позволяет уточнить продукт, если внутри одного бренда используется разная логика проверки получателя.",
            "example": "crystals"
          },
          "input": {
            "type": "object",
            "description": "Данные получателя в формате order_input_schema оффера (те же поля, что передаются в POST /v1/orders)",
            "additionalProperties": true,
            "example": {
              "game_user_key": "1919293471",
              "game_server_key": "6956"
            }
          }
        },
        "required": [
          "brand_id",
          "input"
        ]
      },
      "CreateOrderDto": {
        "type": "object",
        "properties": {
          "offer_id": {
            "type": "string",
            "description": "ID предложения (offer)",
            "format": "uuid"
          },
          "input": {
            "type": "object",
            "description": "Данные, которые вводит пользователь",
            "nullable": true,
            "additionalProperties": true
          }
        },
        "required": [
          "offer_id"
        ]
      },
      "SubmitOrderCredentialsDto": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Тип учетных данных (otp, link, password, etc.)",
            "example": "otp"
          },
          "code": {
            "type": "string",
            "description": "Код подтверждения (OTP / 2FA)",
            "example": "123456"
          },
          "link": {
            "type": "string",
            "description": "Ссылка авторизации / подтверждения",
            "example": "https://example.com/auth"
          },
          "password": {
            "type": "string",
            "description": "Пароль (если применимо)"
          },
          "meta": {
            "type": "object",
            "description": "Дополнительные метаданные"
          }
        }
      },
      "DisputeOrderDto": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "description": "Причина открытия спора / описание проблемы",
            "example": "Товар не поступил на аккаунт"
          }
        },
        "required": [
          "reason"
        ]
      },
      "OrderCredentialsRequestedDataDto": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "description": "ID заказа в системе (order_id)",
            "format": "uuid",
            "example": "019818bc-1285-7c55-9477-5020aebf7782"
          },
          "type": {
            "type": "string",
            "description": "Тип требуемых учетных данных (otp, link, password и т.д.)",
            "example": "otp"
          },
          "is_repeat": {
            "type": "boolean",
            "description": "Флаг повторного запроса (true, если предыдущий код был неверным или истек)",
            "example": false
          },
          "requested_at": {
            "type": "string",
            "description": "Время запроса кода (ISO 8601)",
            "example": "2026-09-05T00:00:00.000Z"
          },
          "expires_in": {
            "type": "number",
            "description": "Время жизни кода в секундах",
            "example": 300
          },
          "expires_at": {
            "type": "string",
            "description": "Время окончания действия кода (ISO 8601)",
            "example": "2026-09-05T00:05:00.000Z"
          },
          "meta": {
            "type": "object",
            "description": "Дополнительные метаданные запроса",
            "example": {
              "step": "2fa"
            }
          }
        },
        "required": [
          "order_id",
          "is_repeat",
          "requested_at",
          "expires_in",
          "expires_at"
        ]
      },
      "OrderCredentialsRequestedWebhookDto": {
        "type": "object",
        "properties": {
          "event_id": {
            "type": "string",
            "description": "Уникальный ID события вебхука (используется для дедупликации)",
            "example": "evt_019c8f00-0000-7000-8000-000000000001"
          },
          "event": {
            "type": "string",
            "description": "Тип события",
            "enum": [
              "order.credentials_requested"
            ],
            "example": "order.credentials_requested"
          },
          "version": {
            "type": "number",
            "description": "Версия формата вебхука",
            "example": 1
          },
          "created_at": {
            "type": "string",
            "description": "Время создания события (ISO 8601)",
            "example": "2026-09-05T00:00:00.000Z"
          },
          "data": {
            "description": "Данные запроса учетных данных",
            "allOf": [
              {
                "$ref": "#/components/schemas/OrderCredentialsRequestedDataDto"
              }
            ]
          }
        },
        "required": [
          "event_id",
          "event",
          "version",
          "created_at",
          "data"
        ]
      },
      "OrderReceiptRequestedDataDto": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "description": "ID заказа в системе (order_id)",
            "format": "uuid",
            "example": "019818bc-1285-7c55-9477-5020aebf7782"
          },
          "delivered_at": {
            "type": "string",
            "description": "Время доставки / выполнения заказа (ISO 8601)",
            "example": "2026-09-12T10:00:00.000Z"
          },
          "auto_confirm_at": {
            "type": "string",
            "description": "Дедлайн автоматического подтверждения получения при отсутствии действий клиента (ISO 8601)",
            "example": "2026-09-13T10:00:00.000Z"
          },
          "screenshots": {
            "description": "Скриншоты выполнения заказа",
            "example": [
              "https://example.com/screenshot1.jpg"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "meta": {
            "type": "object",
            "description": "Дополнительные метаданные",
            "example": {}
          }
        },
        "required": [
          "order_id",
          "delivered_at"
        ]
      },
      "OrderReceiptRequestedWebhookDto": {
        "type": "object",
        "properties": {
          "event_id": {
            "type": "string",
            "description": "Уникальный ID события вебхука (используется для дедупликации)",
            "example": "evt_019c8f00-0000-7000-8000-000000000001"
          },
          "event": {
            "type": "string",
            "description": "Тип события",
            "enum": [
              "order.receipt-requested"
            ],
            "example": "order.receipt-requested"
          },
          "version": {
            "type": "number",
            "description": "Версия формата вебхука",
            "example": 1
          },
          "created_at": {
            "type": "string",
            "description": "Время создания события (ISO 8601)",
            "example": "2026-09-12T10:00:00.000Z"
          },
          "data": {
            "description": "Данные подтверждения получения заказа",
            "allOf": [
              {
                "$ref": "#/components/schemas/OrderReceiptRequestedDataDto"
              }
            ]
          }
        },
        "required": [
          "event_id",
          "event",
          "version",
          "created_at",
          "data"
        ]
      },
      "SetWebhookDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL для уведомлений (должен возвращать HTTP 200 OK)",
            "example": "https://api.myshop.com/webhooks/dandandpay"
          },
          "event": {
            "type": "string",
            "description": "Тип события, на которое подписывается ворспейс",
            "enum": [
              "order.status_updated",
              "order.credentials_requested",
              "order.receipt-requested"
            ],
            "example": "order.status_updated",
            "default": "order.status_updated"
          }
        },
        "required": [
          "url"
        ]
      },
      "SetWebhookResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "123e4567-e89b-12d3-a456-426614174000",
            "description": "ID настройки вебхука"
          },
          "workspace_id": {
            "type": "string",
            "example": "123e4567-e89b-12d3-a456-426614174000",
            "description": "ID мерчанта"
          },
          "event": {
            "type": "string",
            "example": "order.status_updated",
            "enum": [
              "order.status_updated",
              "order.credentials_requested",
              "order.receipt-requested"
            ],
            "description": "Тип события"
          },
          "url": {
            "type": "string",
            "example": "https://api.myshop.com/webhooks/dandandpay",
            "description": "URL вебхука"
          },
          "secret": {
            "type": "string",
            "example": "secret_key_123",
            "description": "Секрет для проверки подписи"
          },
          "is_active": {
            "type": "boolean",
            "example": true,
            "description": "Активен ли вебхук"
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "example": "2023-10-25T10:00:00Z",
            "description": "Дата создания"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string",
            "example": "2023-10-25T10:00:00Z",
            "description": "Дата обновления"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "event",
          "url",
          "secret",
          "is_active",
          "created_at",
          "updated_at"
        ]
      },
      "WorkspaceWebhookPayload": {
        "type": "object",
        "properties": {}
      },
      "ResellerAccountResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID счёта",
            "format": "uuid",
            "example": "019b027b-abf7-7d7d-95c0-a6b6b6098e83"
          },
          "workspace_id": {
            "type": "string",
            "description": "ID воркспейса",
            "format": "uuid",
            "example": "019b027b-c25d-761f-8485-4f89cc76cc52"
          },
          "slug": {
            "type": "string",
            "description": "Slug счёта",
            "example": "main_usd"
          },
          "available": {
            "type": "string",
            "example": "10000",
            "description": "Доступные средства (decimal string, до 6 знаков после запятой без лишних нулей)"
          },
          "frozen": {
            "type": "string",
            "example": "0",
            "description": "Замороженные средства (decimal string, до 6 знаков после запятой без лишних нулей)"
          },
          "currency": {
            "type": "string",
            "description": "Валюта",
            "example": "USD"
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата создания",
            "example": "2025-12-09T16:39:38.000Z"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string",
            "description": "Дата обновления",
            "example": "2025-12-09T16:39:38.000Z"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "slug",
          "available",
          "frozen",
          "currency",
          "created_at",
          "updated_at"
        ]
      },
      "ResellerAccountsListResponseDto": {
        "type": "object",
        "properties": {
          "results": {
            "description": "Счета воркспейса",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResellerAccountResponseDto"
            }
          }
        },
        "required": [
          "results"
        ]
      },
      "OfferListItemResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID предложения",
            "format": "uuid",
            "example": "019b027b-c25d-761f-8485-4f89cc76cc52"
          },
          "miniapp_id": {
            "type": "object",
            "description": "ID miniapp",
            "format": "uuid",
            "nullable": true
          },
          "brand_slug": {
            "type": "string",
            "description": "Slug бренда",
            "example": "mlbb"
          },
          "brand_title": {
            "type": "string",
            "description": "Название бренда",
            "example": "Mobile Legends: Bang Bang"
          },
          "product_slug": {
            "type": "string",
            "description": "Slug продукта",
            "example": "crystals"
          },
          "product_title": {
            "type": "string",
            "description": "Название продукта",
            "example": "Кристаллы"
          },
          "offer_title": {
            "type": "string",
            "description": "Название предложения",
            "example": "50+50"
          },
          "offer_description": {
            "type": "object",
            "description": "Описание предложения"
          },
          "disabled": {
            "type": "boolean",
            "description": "Оффер временно недоступен для заказа, но отображается в списке",
            "example": false
          },
          "limited": {
            "type": "boolean",
            "description": "Персонально лимитированный оффер: перед созданием заказа необходимо проверить его доступность для получателя через POST /v1/orders/validate (поле limited_offers)",
            "example": false
          },
          "price": {
            "type": "string",
            "example": "1.0958",
            "description": "Фиксированная часть цены предложения (decimal string, до 6 знаков после запятой без лишних нулей)"
          },
          "unit_price": {
            "type": "string",
            "example": "0",
            "description": "Цена за единицу пользовательского количества (decimal string, до 6 знаков после запятой без лишних нулей)",
            "default": "0"
          },
          "unit_quantity_field": {
            "type": "object",
            "description": "Поле input, из которого берется количество для unit_price",
            "example": "months",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "description": "Валюта",
            "enum": [
              "USD"
            ],
            "example": "USD"
          }
        },
        "required": [
          "id",
          "brand_slug",
          "brand_title",
          "product_slug",
          "product_title",
          "offer_title",
          "offer_description",
          "disabled",
          "limited",
          "price",
          "unit_price",
          "currency"
        ]
      },
      "OfferResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ID предложения",
            "format": "uuid",
            "example": "019b027b-c25d-761f-8485-4f89cc76cc52"
          },
          "miniapp_id": {
            "type": "object",
            "description": "ID miniapp",
            "format": "uuid",
            "nullable": true
          },
          "brand_slug": {
            "type": "string",
            "description": "Slug бренда",
            "example": "mlbb"
          },
          "brand_title": {
            "type": "string",
            "description": "Название бренда",
            "example": "Mobile Legends: Bang Bang"
          },
          "product_slug": {
            "type": "string",
            "description": "Slug продукта",
            "example": "crystals"
          },
          "product_title": {
            "type": "string",
            "description": "Название продукта",
            "example": "Кристаллы"
          },
          "offer_title": {
            "type": "string",
            "description": "Название предложения",
            "example": "50+50"
          },
          "offer_description": {
            "type": "object",
            "description": "Описание предложения"
          },
          "disabled": {
            "type": "boolean",
            "description": "Оффер временно недоступен для заказа, но отображается в списке",
            "example": false
          },
          "limited": {
            "type": "boolean",
            "description": "Персонально лимитированный оффер: перед созданием заказа необходимо проверить его доступность для получателя через POST /v1/orders/validate (поле limited_offers)",
            "example": false
          },
          "order_input_schema": {
            "type": "object",
            "description": "JSON Schema для данных заказа",
            "additionalProperties": true,
            "example": {
              "type": "object",
              "required": [
                "game_user_key",
                "game_server_key"
              ],
              "properties": {
                "game_user_key": {
                  "type": "string"
                },
                "game_server_key": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "price": {
            "type": "string",
            "example": "1.0958",
            "description": "Фиксированная часть цены предложения (decimal string, до 6 знаков после запятой без лишних нулей)"
          },
          "unit_price": {
            "type": "string",
            "example": "0",
            "description": "Цена за единицу пользовательского количества (decimal string, до 6 знаков после запятой без лишних нулей)",
            "default": "0"
          },
          "unit_quantity_field": {
            "type": "object",
            "description": "Поле input, из которого берется количество для unit_price",
            "example": "months",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "description": "Валюта",
            "enum": [
              "USD"
            ],
            "example": "USD"
          }
        },
        "required": [
          "id",
          "brand_slug",
          "brand_title",
          "product_slug",
          "product_title",
          "offer_title",
          "offer_description",
          "disabled",
          "limited",
          "order_input_schema",
          "price",
          "unit_price",
          "currency"
        ]
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ],
  "webhooks": {
    "order.status_updated": {
      "post": {
        "operationId": "order.status_updated",
        "tags": [
          "Webhooks"
        ],
        "summary": "Уведомление об изменении статуса заказа",
        "description": "Этот вебхук отправляется на ваш сервер, когда заказ меняет свое состояние (например, переходит в completed, error или failed).",
        "parameters": [
          {
            "name": "X-Event-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "order.status_updated"
            },
            "description": "Тип события. Позволяет определить логику обработки содержимого Body."
          },
          {
            "name": "X-Event-Id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "evt_123"
            },
            "description": "Уникальный ID события. Не изменяется при повторных попытках. Используйте для дедупликации (идемпотентности)."
          },
          {
            "name": "X-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "sha256=..."
            },
            "description": "HMAC-подпись (SHA256). Позволяет убедиться, что запрос отправлен нашей системой."
          },
          {
            "name": "X-Timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "integer",
              "example": 1705482000
            },
            "description": "Unix-timestamp (секунды). Рекомендуется проверять актуальность (например, не старше 5 минут)."
          },
          {
            "name": "X-Retry-Attempt",
            "in": "header",
            "required": false,
            "schema": {
              "type": "integer",
              "example": 3
            },
            "description": "Номер попытки (0 — первая отправка, 1+ — повторы)."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderResponseDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Любой HTTP-код 2xx считается успешным приёмом и останавливает очередь ретраев."
          },
          "4xx/5xx": {
            "description": "Любой другой HTTP-код (кроме 2xx) или таймаут приведет к повторной попытке согласно расписанию."
          }
        }
      }
    },
    "order.credentials_requested": {
      "post": {
        "operationId": "order.credentials_requested",
        "tags": [
          "Webhooks"
        ],
        "summary": "Уведомление о запросе учетных данных заказа",
        "description": "Этот вебхук отправляется на ваш сервер, когда для выполнения заказа требуются дополнительные учетные данные (например, одноразовый код подтверждения, ссылка авторизации или пароль). Для продолжения обработки заказа передайте полученные данные методом POST /orders/{id}/credentials.",
        "parameters": [
          {
            "name": "X-Event-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "order.credentials_requested"
            },
            "description": "Тип события. Позволяет определить логику обработки содержимого Body."
          },
          {
            "name": "X-Event-Id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "evt_123"
            },
            "description": "Уникальный ID события. Не изменяется при повторных попытках. Используйте для дедупликации (идемпотентности)."
          },
          {
            "name": "X-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "sha256=..."
            },
            "description": "HMAC-подпись (SHA256). Позволяет убедиться, что запрос отправлен нашей системой."
          },
          {
            "name": "X-Timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "integer",
              "example": 1705482000
            },
            "description": "Unix-timestamp (секунды). Рекомендуется проверять актуальность (например, не старше 5 минут)."
          },
          {
            "name": "X-Retry-Attempt",
            "in": "header",
            "required": false,
            "schema": {
              "type": "integer",
              "example": 3
            },
            "description": "Номер попытки (0 — первая отправка, 1+ — повторы)."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderCredentialsRequestedWebhookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Любой HTTP-код 2xx считается успешным приёмом и останавливает очередь ретраев."
          },
          "4xx/5xx": {
            "description": "Любой другой HTTP-код (кроме 2xx) или таймаут приведет к повторной попытке согласно расписанию."
          }
        }
      }
    },
    "order.receipt-requested": {
      "post": {
        "operationId": "order.receipt-requested",
        "tags": [
          "Webhooks"
        ],
        "summary": "Уведомление о доставке заказа и ожидании подтверждения получения",
        "description": "Этот вебхук отправляется на ваш сервер, когда товар или услуга по заказу доставлены поставщиком и ожидают подтверждения получения клиентом (POST /v1/orders/{id}/confirm-receipt) или открытия спора (POST /v1/orders/{id}/dispute). При отсутствии действий со стороны клиента заказ будет автоматически подтвержден по истечении SLA.",
        "parameters": [
          {
            "name": "X-Event-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "order.receipt-requested"
            },
            "description": "Тип события. Позволяет определить логику обработки содержимого Body."
          },
          {
            "name": "X-Event-Id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "evt_123"
            },
            "description": "Уникальный ID события. Не изменяется при повторных попытках. Используйте для дедупликации (идемпотентности)."
          },
          {
            "name": "X-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "example": "sha256=..."
            },
            "description": "HMAC-подпись (SHA256). Позволяет убедиться, что запрос отправлен нашей системой."
          },
          {
            "name": "X-Timestamp",
            "in": "header",
            "required": true,
            "schema": {
              "type": "integer",
              "example": 1705482000
            },
            "description": "Unix-timestamp (секунды). Рекомендуется проверять актуальность (например, не старше 5 минут)."
          },
          {
            "name": "X-Retry-Attempt",
            "in": "header",
            "required": false,
            "schema": {
              "type": "integer",
              "example": 3
            },
            "description": "Номер попытки (0 — первая отправка, 1+ — повторы)."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderReceiptRequestedWebhookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Любой HTTP-код 2xx считается успешным приёмом и останавливает очередь ретраев."
          },
          "4xx/5xx": {
            "description": "Любой другой HTTP-код (кроме 2xx) или таймаут приведет к повторной попытке согласно расписанию."
          }
        }
      }
    }
  }
}
