Получение статуса возврата

GET /refunds/:id/status

Получение текущего статуса возврата по его идентификатору.

Параметры пути

Параметр	Тип	Обязательный	Описание
id	string	Да	UUID возврата

Заголовки

Заголовок	Обязательный	Описание
merchant-id	Да	Идентификатор мерчанта
x-signature	Да	HMAC-SHA256 подпись запроса

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

curl -X GET https://api.arcanumpay.ru/api/v1/refunds/c3d4e5f6-a7b8-9012-cdef-123456789012/status \
  -H "merchant-id: 12345" \
  -H "x-signature: a1b2c3d4e5f6..."

Ответ

Поле	Тип	Описание
refundId	string	UUID возврата
depositId	string	UUID исходного депозита
status	number	Статус: 1 (Processing), 2 (Approved), 3 (Declined)
amount	string	Сумма возврата
currency	string	Валюта
merchantRefundId	string	Идентификатор мерчанта (если был указан)
merchantFee	string	Комиссия (для финальных статусов)
createdAt	string	Дата создания (ISO 8601)
finishedAt	string	Дата завершения (ISO 8601), null если не завершен

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

{
  "data": {
    "refundId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "depositId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": 2,
    "amount": "50.00",
    "currency": "RUB",
    "merchantRefundId": "merch-refund-001",
    "merchantFee": "0.75",
    "createdAt": "2026-05-28T15:00:00.000Z",
    "finishedAt": "2026-05-28T15:05:00.000Z"
  }
}

Ошибки

HTTP-код	Ошибка	Описание
403	Forbidden	Возврат не принадлежит данному мерчанту