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

Возврат успешного перевода на счет плательщика. Вернуть перевод можно только в течение трех лет с момента регистрации заказа в ЮKassa ( в [уведомлении о проверке заказа](/docs/payment-solution/payments/notifications/http/check-order)). Для перевода со способом оплаты (SberPay) сделать возврат можно только в течение одного года с момента регистрации заказа. Возврат в течение суток (до 23:59 МСК), в которые был совершен перевод, считается отменой этого перевода. В этом случае ЮKassa не удерживает комиссию за проведение операции и данные о переводе не попадают в [Реестр принятых переводов](/docs/payment-solution/payments/supplementary/registers/payments) и акты об оказании услуг. Для некоторых [способов оплаты](/docs/payment-solution/payments/supplementary/reference/payment-types) возвраты с помощью невозможны.

**Адрес для вызова операции** ``` https://shop.yookassa.ru/webservice/mws/api/returnPayment ``` Формат запросов на возврат успешного перевода () отличается от остальных методов. Запросы данного типа необходимо отправлять в виде зашифрованного криптопакета. Формирование запроса к ЮKassa состоит из следующих шагов: **Шаг 1.** Формирование документа-распоряжения на исполнение операции Документ формируется согласно стандарту [XML 1.0 (Fifth Edition)](http://www.w3.org/TR/xml). Документ должен быть сформирован в кодировке [UTF‑8](http://www.ietf.org/rfc/rfc2279.txt). **Шаг 2.** Формирование криптопакета Сформированный документ помещается в криптоконтейнер формата [PKCS#7](http://www.ietf.org/rfc/rfc5652.txt). Криптоконтейнер должен содержать АСП (цифровую подпись, аналог собственноручной подписи). Криптоконтейнер не должен содержать цепочки сертификации. Компрессия данных не используется. Шифрование не используется. Криптопакет должен быть закодирован в формате PEM (OpenSSL). Сертификат, который используется при изготовлении криптопакета, должен соответствовать стандарту [X.509 Version 3](http://www.ietf.org/rfc/rfc2459.txt). **Шаг 3.** Формирование и передача запроса к ЮKassa Магазин формирует POST-запрос по протоколу HTTP/1.1 ([RFC 2616](http://www.ietf.org/rfc/rfc2616.txt), [RFC 2618](http://www.ietf.org/rfc/rfc2618.txt)). Криптопакет может быть передан одним из двух способов: 1. криптопакет помещается в тело POST-запроса, MIME тип: ; 2. криптопакет передается как вложение в сообщение типа . MIME тип: . У POST-запроса должна только одна часть — вложение, криптопакет вкладывается как файл. Такой запрос можно отправить из стандартной HTML формы загрузки файла на сервер (см. [RFC 2388](http://www.ietf.org/rfc/rfc2388.txt)). Для авторизации запросов ЮKassa проверяет АСП криптопакета. **Параметры запроса**

Параметр	Тип	Описание
clientOrderId	ClientTransactionNumber	Уникальный идентификатор операции возврата. Обеспечивает защиту от ошибочных повторов операций. Рекомендуемые значения: целое, положительное, линейно нарастающее десятичное число. Если запрос отправлен с уже обработанным номером операции () и остальные параметры запроса, кроме (дата и время запроса по часам магазина), совпадают с предыдущей попыткой, то ЮKassa вернет результат обработки ранее отправленного запроса. Если запрос отправлен с уже обработанным номером операции (), а остальные параметры имеют отличные от первой попытки значения, то ЮKassa отвергнет такой запрос и вернет в ответе , .
requestDT	dateTime	Время формирования запроса на выполнение операции в системе магазина.
invoiceId	long	Номер транзакции возвращаемого перевода. Вернуть перевод можно в течение трех лет с момента регистрации заказа ( в [уведомлении о проверке заказа](/docs/payment-solution/payments/notifications/http/check-order)).
shopId	long	Идентификатор магазина, который выдала ЮKassa.
amount	CurrencyAmount	Сумма, которую необходимо вернуть на счет плательщика.
currency	CurrencyCode	Код валюты возвращаемого перевода.
cause	string, до 255 символов	Описание причины возврата.
receipt	string	Данные для формирования чека. Необязательный параметр: передается, только если магазин настроил работу со своей онлайн-кассой через ЮKassa.

**Пример HTTP запроса** ``` POST /webservice/mws/api/returnPayment HTTP/1.1 Content-Type: application/pkcs7-mime Content-Length: 906 -----BEGIN PKCS7----- MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAaCA JIAEgbE8P3htbCB2ZXJzaW9uPSIxLjAiIGVuY29kaW5nPSJVVEYtOCI/Pg0KPG1h a2VEZXBvc2l0aW9uUmVzcG9uc2UgY2xpZW50T3JkZXJJZD0iMTI5MTExNjIzNDUy OCIgc3RhdHVzPSIwIiBlcnJvcj0iMCIgcHJvY2Vzc2VkRFQ9IjIwMTAtMTEtMzBU MTE6MjM6NTQuNjI0WiIgYmFsYW5jZT0iNTQxNDYuNzMiIC8+DQoAAAAAAAAxggF8 MIIBeAIBATB3MGoxCzAJBgNVBAYTAlJVMQ8wDQYDVQQIEwZSdXNzaWExFjAUBgNV BAcTDVN0LlBldGVyc2J1cmcxITAfBgNVBAoTGEludGVybmV0IFdpZGdpdHMgUHR5 IEx0ZDEPMA0GA1UEAxMGc2VydmVyAgkAy2xbdQckXjIwCQYFKw4DAhoFAKBdMBgG CSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTEwMTEzMDEx MjM1NVowIwYJKoZIhvcNAQkEMRYEFEYNh8glwqIXGR/n6oYrApa8DaO5MA0GCSqG SIb3DQEBAQUABIGAHlgGsYK30RXWBvuQao0V73KIPQEx2hH/9GY6Iag/xlmZ3rBB kFpszF/O2fB+t84pCHfV15ErZQEkAqIotkEYEgA3hAddEW5+RWUzp+3npHpW5OY7 h3niP5Pj+r0P8EDgHe2j0Zb3dzj2mbwOshZD+FP1IcR8AmiTV3u35C6KAEsAAAAA AAA= -----END PKCS7----- ``` **Пример запроса** ``` ```

Эти параметры нужны (и обязательно передаются), если вы настроили взаимодействие со своей онлайн-кассой через ЮKassa. См. [Описание процесса оплаты с отправкой данных для чека](/docs/payment-solution/payments/payment-process/details/receipt) Параметры для чека **нужно передавать** только в случаях, когда состав чека меняется: * при частичном возврате; * если платеж, который нужно вернуть, проводился без отправки параметров для чека. В этом случае в запросе появляется параметр , в котором передаются параметры для чека (по товарам, за которые возвращаются деньги). Параметры для чека **не нужно передавать** при полных возвратах (если при платеже уже отправлялись фискальные данные).

Параметр	Тип	Описание
customerContact	string, 64 символа	Параметр устарел. Его всё еще можно использовать, но рекомендуется передавать данные в параметре . Телефон или эл. почта покупателя. Ограничения: * номер телефона в формате или адрес электронной почты (проверяется соответствие); * следует передавать что-то одно: только адрес почты или только телефон; * не следует передавать несколько адресов или телефонов. Обязательный, если не передан
taxSystem	int	Система налогообложения магазина (СНО). Параметр необходим, только если у вас несколько систем налогообложения. В остальных случаях не передается. Возможные значения — число от 1 до 6: * — общая СН; * — упрощенная СН (доходы); * — упрощенная СН (доходы минус расходы); * — единый налог на вмененный доход; * — единый сельскохозяйственный налог; * — патентная СН. Важно: товары с разным значением необходимо передавать в разных чеках. Необязательный
customer	Объект	Информация о пользователе. Обязательный, если не передан
customer.fullName	string, не более 256 символов	Для юрлица — название организации, для ИП и физического лица — ФИО. Если у физлица отсутствует ИНН, в этом же параметре передаются паспортные данные. Необязательный Онлайн-кассы, которые поддерживают этот параметр: Orange Data, АТОЛ Онлайн.
customer.inn	string	ИНН пользователя (10 или 12 цифр). Если у физического лица отсутствует ИНН, необходимо передать паспортные данные в параметре . Необязательный Онлайн-кассы, которые поддерживают этот параметр: Orange Data, АТОЛ Онлайн.
customer.email	string	Электронная почта пользователя для отправки чека. Обязательный, если не передан или .
customer.phone	string	Телефон пользователя для отправки чека. Указывается в формате [ITU-T E.164](https://ru.wikipedia.org/wiki/E.164), например Обязательный, если не передан или .
items	Объект	Все товары в заказе. Обязательный
item.quantity	Десятичное число. Максимально возможное значение и максимальное количество знаков после точки зависят от модели вашей онлайн-кассы	Количество товара. Описывает количество товаров в заказе или количество весового товара. Обязательный
item.price	Объект	Цена товара. Обязательный
item.price.amount	CurrencyAmount (десятичное число с точностью до 2 символов после точки)	Цена за единицу товара. Обязательный
item.price.currency	CurrencyCode	Код валюты: (рубль РФ). Необязательный
item.tax	int	Ставка НДС. Возможные значения — число от 1 до 6: * — без НДС; * — ставка НДС 0%; * — ставка 10%; * — ставка 20%; * — расчетная ставка 10/110; * — расчетная ставка 20/120. Обязательный
item.text	string, 128 символов	Название товара. Обязательный
item.paymentSubjectType	string, 128 символов	Признак предмета расчета — категория этого товара для налоговой. Возможные значения: * — товар; * — подакцизный товар; * — работа; * — услуга; * — ставка в азартной игре; * — выигрыш в азартной игре; * — лотерейный билет; * — выигрыш в лотерею; * — результаты интеллектуальной деятельности; * — платеж; * — агентское вознаграждение; * — имущественные права; * — внереализационный доход; * — страховой сбор; * — торговый сбор; * — курортный сбор; * — несколько вариантов; * — другое. Необязательный
item.paymentMethodType	string, 128 символов	Признак способа расчета — категория способа оплаты для налоговой. Возможные значения: * — полная предоплата; * — частичная предоплата; * — аванс; * полный расчет; * — частичный расчет и кредит; * — кредит; * — выплата по кредиту. Необязательный
item.productCode	string	Код товара — уникальный номер, который присваивается экземпляру товара при [маркировке](http://docs.cntd.ru/document/902192509). Формат: число в шестнадцатеричном представлении с пробелами. Максимальная длина — 32 байта. Пример: . Обязательный параметр, если товар нужно [маркировать](http://docs.cntd.ru/document/557297080). Онлайн-кассы, которые поддерживают этот параметр: Orange Data, АТОЛ Онлайн.
item.countryOfOriginCode	string	Код страны происхождения товара по общероссийскому классификатору стран мира ([ОК (МК (ИСО 3166) 004-97) 025-2001](http://docs.cntd.ru/document/842501280)). Пример: . Необязательный Онлайн-кассы, которые поддерживают этот параметр: Orange Data.
item.customsDeclarationNumber	string, от 1 до 32 символов	Номер таможенной декларации. Необязательный Онлайн-кассы, которые поддерживают этот параметр: Orange Data.
item.excise	string, десятичное число с точностью до 2 символов после точки	Сумма акциза товара с учетом копеек. Необязательный Онлайн-кассы, которые поддерживают этот параметр: Orange Data.

**Пример запроса с параметрами для чека** ``` ```

* Чтобы платеж прошел, необходимо передать контактные данные пользователя для отправки чека — синтаксически корректный номер телефона или адрес электронной почты. Эти данные нужно передать в объекте или в параметре . * Чек покупателю доставляет ОФД (условия доставки зависят от вашего ОФД). Чеки приходят на мобильные номера российских операторов (они начинаются с ). На иностранный мобильный номер чек может не дойти. Параметр устарел. Его всё еще можно использовать, но рекомендуется передавать данные в объекте .

* В поле указывается цена за единицу товара, в поле — количество. Если в указана цена за один товар, следует передавать количество штук (, например, два одинаковых пирога). Если в указана цена за кг, следует передавать вес товара (, например, пирог весом 1 кг 253 г). * Общая сумма в чеке должна совпадать с суммой возврата. То есть если умножить на , должно получиться значение, равное . Если эти значения не совпадают, чек не сформируется. * Общая сумма в чеке после всех расчетов округляется до двух знаков после точки. Иногда точную сумму получить невозможно — только на копейку меньше или на копейку больше. В этом случае следует передавать вариант с суммой на копейку больше. Пример: ``` item.quantity = "0.573", item.price.amount = "17.00", amount = "9.75" 0.573*17=9.741, после округления — 9.74 0.574*17=9.758, после округления — 9.76 В этом случае следует передавать item.quantity = "0.574" ```

В ответ приходят параметры, общие для всех типов запросов на исполнение [финансовых операций](/docs/payment-solution/payments/payment-management/financial/format). Если в запросе был передан идентификатор перевода, которому больше трех лет, возврат не пройдет, в ответ вернется ошибка (). **Пример ответа** ``` ```

Реестры возвращенных переводов Правила обработки запросов Коды ошибок Типы данных