Спор по выплате
Открывает спор по исполненной выплате, если получатель сообщает, что деньги не пришли.
Запрос
POST /v1/payouts/{id}/dispute — application/json или multipart/form-data (с файлом); заголовки: см. Авторизация.
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
comment | string | нет | Комментарий |
receipt | file | нет | Файл (multipart): до 10 МБ, png/jpg/jpeg/webp/heic/pdf |
data | string (JSON) | нет | В multipart — поля выше одной JSON-строкой |
Доступно для completed. Срока на открытие спора нет.
Пример запроса
curl -X POST https://api.bopay.io/v1/payouts/7c1d2b9e-1f2a-4c3d-9e8f-0a1b2c3d4e5f/dispute \
-H "X-Identity: <API-key>" \
-H "X-Signature: <Signature>" \
-F 'data={"comment":"Клиент не получил перевод"}' \
-F "[email protected]"
Ответ
Объект выплаты, как в получении выплаты, со статусом dispute.
Статусы
dispute → completed (выплата подтверждена или спор отозван) или cancelled (выплата не прошла, резерв возвращён на баланс). Итог приходит уведомлением.
Ошибки
| Код | HTTP | Причина |
|---|---|---|
PAY_001 | 404 | Выплата не найдена |
PAY_002 | 400 | Неверные параметры |
PAY_009 | 400 | Файл больше 10 МБ |
PAY_010 | 400 | Неподдерживаемый формат файла |
DIS_001 | 400 | Выплата не в completed |
DIS_002 | 409 | Спор уже открыт |
SYS_001 | 500 | Внутренняя ошибка |