Это старая версия API. Переходите на [API ЮKassa](/developers).

Получение выборки из истории выполнения операций [возврата](/docs/payment-solution/payments/payment-management/financial/return-payment) успешных переводов.

**Адрес для вызова операции** ``` https://shop.yookassa.ru/webservice/mws/api/listReturns ``` **Параметры запроса**

Параметр	Тип	Описание
requestDT	dateTime	Дата и время запроса по часам магазина. Обязательный параметр.
shopId	long	Идентификатор магазина, который ЮKassa выдала при подключении.
invoiceId		Уникальный номер транзакции в ЮKassa.
from	dateTime	Время выборки «от» в формате (см. [Типы данных](/docs/payment-solution/payments/supplementary/reference/data-types)) Обязательно передавать дробную часть секунд, от 1 до 6 символов. Например:
till	dateTime	Время выборки «до» в формате (см. [Типы данных](/docs/payment-solution/payments/supplementary/reference/data-types)) Обязательно передавать дробную часть секунд, от 1 до 6 символов. Например:
status	int	Статус операции. Необязательный параметр.
partial	boolean	Необязательный параметр. Возможные значения: * — будут выведены операции, где возвращается только часть суммы перевода; * — будут выведены операции, где возвращается полная сумма перевода; * параметр отсутствует — будут выведены все операции. Значение по умолчанию: отсутствует.
outputFormat	normalizedString	Формат представления результата, допустимые значения — или . Значение по умолчанию: .
csvDelimiter	string, 1 символ	Разделитель значений для формата CSV. Не может быть равен символу «"» (кавычка). Необязательный параметр: если отсутствует в запросе, используется разделитель «;» (точка с запятой, без кавычек).

Параметры запроса и применяются к полю (время регистрации запроса на возврат по часам ЮKassa). В параметрах запроса обязательно должно быть хотя бы одно из условий: * номер транзакции () и идентификатор магазина (); * диапазон времени регистрации запроса на возврат по часам ЮKassa ( и ) и идентификатор магазина ().

Формат ответа определяется входными параметрами запроса и . В случае ошибки ее код и описание возвращаются в заказанном формате представления результата.

Параметр	Тип	Описание
returnId	long	Уникальный идентификатор операции возврата в ЮKassa.
invoiceId	long	Номер транзакции перевода.
shopId	long	Идентификатор магазина, который выдала ЮKassa.
amount	CurrencyAmount	Сумма возврата.
currency	CurrencyCode	Код валюты.
cause	string, до 255 символов	Описание причины возврата.
status	int	Код состояния запроса.
error	int	Код ошибки.
createdDT	dateTime	Время регистрации запроса на возврат.
processedDT	dateTime	Фактическое время возврата средств плательщику. Поле присутствует только в случае успешного возврата.
sender	string	Отправитель приказа на возврат. Параметр содержит поле CN X509 сертификата, которым был подписан запрос на возврат ().
articleAmount	CurrencyAmount	Сумма возврата в валюте товара.
articleCurrency	CurrencyCode	Код валюты товара.
orderNumber	string, до 64 символов	Уникальный для данного номер заказа в магазине.

**Пример успешного ответа в формате XML** ``` ``` **Пример успешного ответа в формате CSV** ``` status=0;error=0;processedDT=2011-07-02T20:38:01.000Z 123;0;0;2000000123;6689;10.00;643;2011-07-02T20:38:01.000Z;2011-07-02T20:38:01.000Z;"покупатель отказался принять товар";shopName;10.00;643;12345 124;3;506; 2000000125;6689;12.00;643;2011-07-02T20:38:01.000Z;; "покупатель отказался принять товар";shopName;12.00;643;12346 ``` В случае отсутствующего параметра в формате CSV передается пустое поле. **Пример сообщения об ошибке в формате XML** ``` ``` **Пример сообщения об ошибке в формате CSV** ``` status=3;error=113;processedDT=2011-07-02T20:38:01.000Z ```

Коды состояний запроса Коды ошибок Коды состояний уведомления о переводе Типы данных