Plateshka
APIВозвраты

Возвраты по счёту

Массив всех возвратов счёта, без пагинации.

GET/v1/invoices/{id}/refunds

Массив всех возвратов счёта, без пагинации.

Авторизация

apiKey
АвторизацияBearer <token>

Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.

In: header

Параметры пути

id*string

Идентификатор счёта.

Formatuuid

Тело ответа

application/json

application/json

curl -X GET "https://example.com/v1/invoices/9f1d4c02-3b7a-4c1e-8a55-6a1c2d3e4f50/refunds"
[  {    "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"  }]

Получить счёт

Назад

Создать возврат

Без `amount` возвращается весь непогашенный остаток счёта. Валюта возврата обязана совпадать с валютой счёта. Выполнит ли возврат провайдер — свойство способа оплаты, подключённого вашему проекту, а не платформы. Если он возвратов не делает, приходит `422 method_unavailable`; тогда возврат оформляют вручную в кабинете провайдера, и счёт переходит в `refunded` вебхуком.