Создать возврат
Без `amount` возвращается весь непогашенный остаток счёта. Валюта возврата обязана совпадать с валютой счёта. Выполнит ли возврат провайдер — свойство способа оплаты, подключённого вашему проекту, а не платформы. Если он возвратов не делает, приходит `422 method_unavailable`; тогда возврат оформляют вручную в кабинете провайдера, и счёт переходит в `refunded` вебхуком.
/v1/invoices/{id}/refundsБез amount возвращается весь непогашенный остаток счёта. Валюта возврата обязана совпадать с валютой счёта.
Выполнит ли возврат провайдер — свойство способа оплаты, подключённого вашему проекту, а не платформы. Если он возвратов не делает, приходит 422 method_unavailable; тогда возврат оформляют вручную в кабинете провайдера, и счёт переходит в refunded вебхуком.
Авторизация
apiKey Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.
In: header
Параметры пути
Идентификатор счёта.
uuidЗаголовки
Ключ повтора. Тот же ключ с тем же телом не выполняет операцию заново: возвращается сохранённый ответ и код 200 вместо 201. Живёт 24 часа.
1 <= length <= 255Тело запроса
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Тело создания возврата.
Тело ответа
application/json
application/json
curl -X POST "https://example.com/v1/invoices/9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50/refunds" \ -H "Idempotency-Key: order-4815162342" \ -H "Content-Type: application/json" \ -d '{ "amount": { "amount": "149900", "currency": "RUB" }, "reason": "Покупатель отказался от заказа" }'{ "id": "b2c3d4e5-6f70-4812-9a3b-4c5d6e7f8091", "invoiceId": "9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50", "amount": { "amount": "149900", "currency": "RUB" }, "status": "succeeded", "reason": "Покупатель отказался от заказа", "completedAt": "2026-08-19T12:00:02Z", "createdAt": "2026-08-19T11:59:58Z"}