---
title: "Changes to POST /deals"
method: POST
path: "/deals"
---

# Changes to POST /deals

`POST /deals`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 7 revisions.

- **2026-02-14** `fe24d3dfadad`: 10 breaking, 1 warning, 27 info

## Changes

- **2026-02-14** `fe24d3dfadad`: 10 breaking, 1 warning, 27 info
  - added `#/components/schemas/DealType` to the `type` request property `allOf` list
  - added `#/components/schemas/FeeMoment` to the `fee_moment` request property `allOf` list
  - the request property `metadata/additionalProperties/` became not nullable
  - removed the enum value `deal_closed` of the request property `fee_moment`
  - removed the enum value `payment_succeeded` of the request property `fee_moment`
  - removed the enum value `safe_deal` of the request property `type`
  - the `fee_moment` request property type changed from `string` to no type
  - the `type` request property type changed from `string` to no type
  - the response's body type changed from no type to `object` for status `200`
  - the `allOf[#/components/schemas/BaseDeal]/type` response's property type changed from `string` to no type for status `200`
  - removed `subschema #2` from the `description` request property `allOf` list
  - api operation id `Deals_create` was added
  - removed the pattern `[0-9a-zA-Z+-_.]{1,64}` from the `header` request parameter `Idempotence-Key`
  - the `fee_moment` request property default value `payment_succeeded` was removed
  - removed `subschema #2` from the response body `allOf` list for the response status `200`
  - removed `subschema #2` from the response body `allOf` list for the response status `400`
  - removed `subschema #2` from the response body `allOf` list for the response status `401`
  - removed `subschema #2` from the response body `allOf` list for the response status `403`
  - removed `subschema #2` from the response body `allOf` list for the response status `429`
  - removed `subschema #2` from the response body `allOf` list for the response status `500`
  - added the optional property `description` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added `#/components/schemas/DealType` to the `allOf[#/components/schemas/BaseDeal]/type` response property `allOf` list for the response status `200`
  - removed discriminator from `allOf[#/components/schemas/BaseDeal]/` response property for the response status `200`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `400`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `401`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `403`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `429`
  - removed the `error` enum value from the `allOf[#/components/schemas/Error]/type` response property for the response status `500`
  - removed the `safe_deal` enum value from the `allOf[#/components/schemas/BaseDeal]/type` response property for the response status `200`
  - added the required property `balance` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `expires_at` to the response with the `200` status
  - added the required property `fee_moment` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `payout_balance` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
  - added the required property `test` to the response with the `200` status

---

[Operation](https://skmtc.dev/hexlet/apis/api-kassa/docs/deals/post.md) - [API](https://skmtc.dev/hexlet/apis/api-kassa.md) - [Page](https://skmtc.dev/hexlet/apis/api-kassa/changes/deals/post)