1. Callbacks
Platega.io API
  • Авторизация
  • Модули CMS
  • SDK
  • Платежи
    • Приём карт по H2H
    • Рекуррентные СБП-подписки
      • Пробный доступ и изменение суммы подписки
      • Подписки по H2H
      • Создать подписку
      • Получить подписку
      • Список подписок
      • Отменить подписку
      • Проверка возможности обновить подписку
      • Обновление подписки
    • Создание платежной ссылки без заданного метода
      POST
    • Создание платежной ссылки с заданным методом
      POST
    • Получение QR-кода для H2H-транзакции
      GET
    • Проверка статуса оплаты платежа
      GET
    • Выгрузка транзакций в CSV
      POST
    • Выгрузка транзакций в Excel
      POST
    • Выгрузка транзакций в Json
      POST
  • Балансы
    • Получение балансов
      GET
  • Возвраты
    • Проверка возможности отмены транзакции
      GET
    • Отмена транзакции
      POST
    • Частичная отмена транзакции
      POST
  • Выводы
    • Создаёт вывод на рублёвую карту через Payout API
    • Создаёт вывод на криптокошелек через Payout API
    • Получение сохранённых карт
      GET
    • Получение сохраненных криптокошельков
      GET
  • Callbacks
    • Колбэки — общая информация
    • CONFIRMED
    • CANCELED
    • CHARGEBACKED
    • PARTIALLY_REFUNDED
    • DISPUTED
  • Schemas
    • Schemas
      • PaymentStatus
      • PaymentMethodInt
      • CreateTransactionRequest
      • CreateTransactionResponse
      • TransactionStatusResponse
      • SubscriptionStatus
      • CallbackSubscriptionStatus
      • SubscriptionInterval
    • Статус платежа в колбэке
    • Результат операции возврата
    • Общие поля колбэка
    • Поля колбэка по возврату
    • CallbackPayload
    • Поля колбэка по подписке
  1. Callbacks

PARTIALLY_REFUNDED

Webhook
POST
PARTIALLY_REFUNDED
По платежу прошёл частичный возврат. Платёж остаётся зачисленным на остаток суммы.

Переходы#

Приходит при переходе CONFIRMED → PARTIALLY_REFUNDED и повторяется на каждом следующем частичном возврате по тому же платежу — статус при этом не меняется.
Дальше платёж может получить ещё один PARTIALLY_REFUNDED либо уйти в CHARGEBACKED, если остаток вернули целиком.

Виды этого колбэка#

1.
Успешный частичный возврат — refundStatus: "Succeeded".
2.
Отклонённый частичный возврат — refundStatus: "Declined". Деньги не двигались, refundedAmount и refundableAmount остаются прежними.
Сколько уже возвращено и сколько ещё можно вернуть, смотрите в refundedAmount и refundableAmount, а не складывайте суммы сами: при нескольких возвратах и повторных доставках сложение даст неверный итог.

Пример#

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1500.25,
  "currency": "RUB",
  "status": "PARTIALLY_REFUNDED",
  "paymentMethod": 2,
  "payload": "order-8089",
  "refundId": "9f1c2b7e-4d3a-4b5c-8e7f-1a2b3c4d5e6f",
  "refundAmount": 500,
  "refundedAmount": 500,
  "refundableAmount": 1000.25,
  "refundStatus": "Succeeded"
}

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
Принято. Тело ответа не разбирается.
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://your-api-server.com' \
--header 'X-MerchantId;' \
--header 'X-Secret;' \
--header 'Content-Type: application/json' \
--data '{
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "amount": 1500.25,
    "currency": "RUB",
    "status": "PARTIALLY_REFUNDED",
    "paymentMethod": 2,
    "payload": "order-8089",
    "refundId": "9f1c2b7e-4d3a-4b5c-8e7f-1a2b3c4d5e6f",
    "refundAmount": 500,
    "refundedAmount": 500,
    "refundableAmount": 1000.25,
    "refundStatus": "Succeeded"
}'
Modified at 2026-10-27 18:53:53
Previous
CHARGEBACKED
Next
DISPUTED
Built with