Открытие апелляции

Открывает апелляцию по отменённому платежу. Используется когда клиент произвёл оплату, но платёж был отменён системой.

Endpoint

POST /v1/payments/{id}/dispute

Параметры запроса

Параметр	Тип	Обязательный	Описание
amount	number	Нет	Фактическая сумма платежа (если отличается)
receipt_url	string	Нет	URL чека/скриншота
comment	string	Нет	Комментарий

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

curl -X POST https://api.settler.pw/api/v1/payments/550e8400-e29b-41d4/dispute \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "receipt_url": "https://your-site.com/receipts/12345.jpg",
    "comment": "Клиент предоставил чек об оплате"
  }'

Ответ

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "order_12345",
  "amount": 5000,
  "currency": "RUB",
  "status": "dispute",
  "method": "SBP",
  "dispute": {
    "amount": null,
    "receipt_url": "https://your-site.com/receipts/12345.jpg",
    "comment": "Клиент предоставил чек об оплате",
    "created_at": "2026-01-30T12:45:00Z"
  },
  "created_at": "2026-01-30T12:15:00Z"
}

Ограничения

• Апелляцию можно открыть только для отменённых платежей (status = CANCELLED или CANCELLED_APPEAL)
• Повторное открытие возможно после отмены апелляции

Результаты апелляции

Статус	Описание
DISPUTE	Апелляция открыта, на рассмотрении
COMPLETED	Апелляция одобрена, средства зачислены
CANCELLED	Апелляция отклонена

Отмена апелляции

Для отмены активной апелляции используйте POST /payments/{id}/dispute/cancel.

Ошибки

Код	HTTP	Описание
PAY_002	400	Неверные параметры запроса
PAY_006	404	Платёж не найден
DIS_001	400	Апелляцию можно открыть только для CANCELLED / CANCELLED_APPEAL
DIS_002	409	Апелляция уже существует