Skip to content

Создание апелляции

Создает апелляцию по сделке

http
POST /api/v1/disputes/create

Пример запроса

bash
curl -X POST "https://api.luckypay.pro/api/v1/disputes/create" \
-H "X-API-Key: your_api_key" \
-F "order_id=068f12u8-833t-715g-8000-cu619b95j830" \
-F "amount=1050.50" \
-F "files=@/path/to/file/504.pdf;type=application/pdf" \

Параметры тела запроса (multipart/form-data)

Тело запроса передается в формате multipart/form-data (в curl-примере — флаги -F).

ПараметрТипОписание
order_idstringID ордера в системе. Обязательный
amountnumberСумма апелляции. Обязательный
filesarray<file>, nullableФайлы, сопутствующие апелляции: скриншоты, видео

Ограничения на файлы:

  • максимум 5 файлов — при превышении вернется ошибка 400;
  • размер каждого файла — не более 5 MB, иначе 413;
  • допустимые типы: image/*, application/pdf, video/* — иначе 415.

Пример ответа 201

json
{
  "order_id": "068f13g6-89d0-45a8-8000-6y392dfty671",
  "dispute_id": "8737378",
  "dispute_files": [
    "appeals/068f13g6-89d0-45a8-8000-6y392dfty671_1753600000/evidence_3fa85f6457174562b3fc2c963f66afa6.mp4",
    "appeals/068f13g6-89d0-45a8-8000-6y392dfty671_1753600000/evidence_a1b2c3d4e5f60718293a4b5c6d7e8f90.png"
  ]
}

Описание ошибок

  • 400 - апелляция по данному ордеру уже существует или уже обработана
  • 403 - ордер не принадлежит вашему терминалу

Ошибки 400/413/415, связанные с файлами, описаны в ограничениях выше.