Возврат создаётся по существующему платежу в статусе paid. Для создания достаточно передать только payment_id.

​
Статусы возврата

СтатусТипЗначение
pendingпромежуточныйВозврат создан, ожидает обработки.
succeededфинальныйВозврат успешно выполнен.
failedфинальныйВозврат не удался.

​
Объект возврата

Объект возврата refund содержит актуальную информацию о возврате платежа.
​
id
string
Идентификатор возврата.
​
payment_id
string
Идентификатор исходного платежа.
​
status
string
Статус возврата: pending, succeeded или failed.
​
amount
string
Сумма возврата в формате "D.DD".
​
currency
string
по умолчанию:"RUB"
Валюта возврата.
​
created_at
datetime
Время создания возврата (ISO 8601, UTC).
Пример объекта
{
  "id": "01jbxa1c2d3e4f5g6h7j8k9m0n",
  "payment_id": "01jbx9q8h7m2k3n4p5r6s7t8v9",
  "status": "succeeded",
  "amount": "50.00",
  "currency": "RUB",
  "created_at": "2026-05-29T14:10:00Z"
}

​
Создание возврата

POST /v1/refunds Запрос совершает полный возврат платежа по его идентификатору. Можно вернуть только платёж в статусе paid, и только на всю сумму платежа. Параметры тела
​
payment_id
string
обязательно
Идентификатор платежа, по которому делается возврат.
curl https://api.parserpay.io/v1/refunds \
  -X POST \
  -H "Authorization: Bearer <project_id>:<api_key>" \
  -H "Content-Type: application/json" \
  -d '{
        "payment_id": "01jbx9q8h7m2k3n4p5r6s7t8v9"
      }'

​
Информация о возврате

GET /v1/refunds/ Запрос позволяет получить информацию о текущем состоянии возврата по его идентификатору. В ответ придёт объект возврата в актуальном статусе. Параметры пути
​
refund_id
string
обязательно
Идентификатор возврата.
curl https://api.parserpay.io/v1/refunds/01jbxa1c2d3e4f5g6h7j8k9m0n \
  -H "Authorization: Bearer <project_id>:<api_key>"