Возвраты
С помощью API ЮKassa можно возвращать успешные платежи. Комиссии за проведение возврата нет. Комиссия ЮKassa за проведение платежа не возвращается.
 
Особенности
Возврат платежа может быть полным или частичным. В первом случае вы возвращаете принятый платеж целиком. Во втором — часть от суммы платежа, например если хотите сделать возврат одного товара, а не всей покупки. Частичный возврат доступен не для всех способов оплаты.
Перед возвратом платежа проверьте, что:
  • платеж создан менее трех лет назад;
  • платеж успешно завершен и находится в статусе
    succeeded
    ;
  • способ оплаты поддерживает нужный вам тип возврата (полный, частичный).
 
Полный возврат
Чтобы сделать полный возврат, в запросе на создание возврата передайте уникальный идентификатор (
payment_id
) и сумму (
amount
) возвращаемого платежа.
Пример запроса на создание возврата
cURL
PHP
Python
curl https://payment.yandex.net/api/v3/refunds \
  -X POST \
  -u <Идентификатор магазина>:<Секретный ключ> \
  -H 'Idempotence-Key: <Ключ идемпотентности>' \
  -H 'Content-Type: application/json' \
  -d '{
        "amount": {
          "value": "2.00",
          "currency": "RUB"
        },
        "payment_id": "21740069-000f-50be-b000-0486ffbf45b0"
      }'
Пример тела ответа
JSON
  {
    "id": "216749f7-0016-50be-b000-078d43a63ae4",
    "status": "succeeded",
    "amount": {
      "value": "2.00",
      "currency": "RUB"
    },
    "created_at": "2017-10-04T19:27:51.407Z",
    "payment_id": "21740069-000f-50be-b000-0486ffbf45b0"
  }
 
Частичный возврат
Частичный возврат создается аналогично полному, только в параметре
amount
нужно передать ту часть от суммы принятого платежа, которую вы хотите вернуть. Вы можете сделать сколько угодно частичных возвратов, если:
  • сумма всех частичных возвратов не превышает размер платежа;
  • сумма возврата больше 1 рубля;
  • сумма остатка больше 1 рубля.
 
Что почитать еще
Реестры возвратовПроведение платежейОплата по 54-ФЗСпособы оплаты