---
title: "Создать диспут"
method: POST
path: "/create"
tags: ["disputes"]
---

# Создать диспут

`POST /create`

## Request body

- object
  - `invoiceId` string, required — Идентификатор инвоиса, на основе которого был создан платёж
  - `paymentId` string, required — Идентификатор платежа
  - `attachments` object[], required
    - `data` string, byte, required — base64-encoded file contents
    - `mimeType` string, required — Тип файла
  - `amount` integer — Сумма платежа в минорных единицах, которая будет оспариваться в диспуте
  - `reason` string — Причина открытия диспута
  - `notificationUrl` string, http-url — URL-адрес, на который будут приходить уведомления о изменении статуса диспута

## Response `200`

Диспут создан

- object
  - `disputeId` string, required — Идентификатор диспута

## Other responses

- `400` — Invalid request data
- `401` — Authorization error
- `404` — Target resource not found

## Changes

- **2025-03-04** `c8f8968366c6` — 1 warning, 1 info
  - deleted the `header` request parameter `X-Request-ID`
  - added the new optional request property `notificationUrl`
- **2024-08-27** `cac78134f427` — 2 breaking
  - removed the media type `application/json` for the response with the status `404`
  - removed the required property `code` from the response with the `400` status
- **2024-08-22** `a9135cd8c49b` — 1 breaking, 3 warning
  - the `amount` request property type/format changed from `object`/`` to `integer`/`int64`
  - the `amount` request property's min was set to `1.00`
  - removed the request property `amount/amount`
  - removed the request property `amount/currency`
- **2024-08-21** `cf95bcb18779` — 1 breaking, 2 info
  - removed the media type `multipart/form-data` from the request body
  - added the media type `application/json` to the request body
  - removed the non-success response with the status `422`

[Change history](https://skmtc.dev/valitydev/apis/vality-disputes/changes/create/post.md)

---

[API](https://skmtc.dev/valitydev/apis/vality-disputes.md) · [All operations](https://skmtc.dev/valitydev/apis/vality-disputes/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/valitydev/vality-disputes/revisions/c8f8968366c6/schema)