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

DISPUTED

Webhook
POST
DISPUTED
Платёж поставлен на проверку. Деньги по нему зарезервированы до решения: вывести их нельзя, но и списания со счёта ещё не было.
Сумма резерва возвращается эндпоинтом GET /balance/all в поле disputeFrozenBalance баланса USDT.

Переходы#

Приходит при переходе CONFIRMED → DISPUTED. Только по входящим платежам.
Чем заканчивается проверка:
DISPUTED → CONFIRMED — снята, резерв освобождён, придёт повторный CONFIRMED;
DISPUTED → CHARGEBACKED — завершилась возвратом.
Пока платёж на проверке, возвраты по нему недоступны. Повторная постановка на проверку после снятия возможна, то есть DISPUTED по одному платежу может прийти больше одного раза.

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

Вид один: новых полей по сравнению с обычным платежом в теле нет, отличается только status. Причину проверки и сумму удержания колбэк не передаёт.

Пример#

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": 1500.25,
  "currency": "RUB",
  "status": "DISPUTED",
  "paymentMethod": 2,
  "payload": "order-8089"
}

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 --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": "DISPUTED",
    "paymentMethod": 2,
    "payload": "order-8089"
}'
Modified at 2026-10-27 18:53:59
Previous
PARTIALLY_REFUNDED
Next
PaymentStatus
Built with