С помощью API ЮKassa можно возвращать успешные платежи. Комиссии за проведение возврата нет. Комиссия ЮKassa за проведение платежа не возвращается.
Возврат платежа может быть полным или частичным. В первом случае вы возвращаете принятый платеж целиком. Во втором — часть от суммы платежа, например если хотите сделать возврат одного товара, а не всей покупки. Частичный возврат доступен не для всех способов оплаты.
Перед возвратом платежа проверьте, что:
- платеж со способом оплаты sberbankсоздан менее одного года назад, любым другим способом — менее трех лет назад;
- платеж успешно завершен и находится в статусе succeeded;
- способ оплаты поддерживает нужный вам тип возврата (полный, частичный).
Чтобы сделать полный возврат, в запросе на создание возврата передайте уникальный идентификатор (
payment_id
) и сумму (amount
) возвращаемого платежа.Пример запроса на создание возврата
cURL
PHP
Python
curl https://api.yookassa.ru/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 рубля.