1. Возвраты
Smerch — API интеграции для мерчантов
  • Быстрый старт
  • Возвраты
  • Песочница, ошибки и go-live
  • Вебхуки (исходящие колбэки)
  • Авторизация и HMAC
  • Балансы и курсы
  • Платежи
  • Выводы (выплаты)
  • Авторизация
    • Проверить, что API отвечает
      GET
  • Балансы
    • Посмотреть балансы
      GET
  • Выводы
    • Создать вывод средств
      POST
    • Посчитать вывод без списания
      GET
    • Получить вывод по UUID
      GET
  • Возвраты
    • Сделать возврат по платежу
      POST
  • Песочница
    • Песочница: симулировать отказ оплаты
      POST
    • Песочница: отказ, затем запоздавшая оплата
      POST
    • Песочница: симулировать успешную оплату
      POST
    • Песочница: симулировать истечение платежа
      POST
  • Платежи
    • Список платежей
      GET
    • Создать платёж
      POST
    • Найти платёж по вашему external_id
      GET
    • Получить платёж по UUID
      GET
  • Вебхуки
    • Посмотреть настройки webhook
      GET
    • Задать URL для колбэков
      PUT
    • Журнал доставок webhook
      GET
    • Сменить secret подписи webhook
      POST
    • Отправить тестовый колбэк
      POST
    • Событие: изменился статус платежа
    • Событие: изменился статус вывода
  • Balances
    • Service method
  • Payments
    • Service method
  • Schemas
    • CreatePayoutRequest
    • CreateRefundRequest
    • CreateTransactionRequest
    • CursorMeta
    • ErrorResponse
    • HealthResponse
    • IntegrationBalancesResponse
    • MerchantBalance
    • MerchantPayoutCallback
    • MerchantTransactionCallback
    • PayoutQuoteResponse
    • PayoutResponse
    • RatesResponse
    • RefundResponse
    • StructuredError
    • TransactionResponse
    • TransactionCursorPage
    • ValidationErrorResponse
  1. Возвраты

Сделать возврат по платежу

POST
/integration/refunds
Нужен заголовок Idempotency-Key. Один ключ = одно намерение вернуть деньги. 201 — создан, 202 — ещё в обработке/на approve.

Request

Authorization
API Key
Add parameter in header
X-Signature
Example:
X-Signature: ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created
application/json
Возврат создан
Bodyapplication/json

🟢202Accepted
🟠401Unauthorized
🟠403Forbidden
🟠409Conflict
🟠422Parameter Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/integration/refunds' \
--header 'Idempotency-Key;' \
--header 'X-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "transaction_uuid": "3a6bcbed-b7dc-4791-84fe-b20f12be4001",
    "amount_minor": 1,
    "reason": "string"
}'
Response Response Example
201 - Example 1
{
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "transaction_uuid": "3a6bcbed-b7dc-4791-84fe-b20f12be4001",
    "amount_minor": 0,
    "currency": "string",
    "status": "string",
    "cumulative_refunded_minor": 0,
    "transaction_amount_minor": 0,
    "reason": "string",
    "succeeded_at": "2019-08-24T14:15:22.123Z",
    "failed_at": "2019-08-24T14:15:22.123Z",
    "created_at": "2019-08-24T14:15:22.123Z",
    "action_request_id": "d06cf6f1-3b6c-41d3-882d-43eec3bed72d",
    "message": "string"
}
Modified at 2026-07-31 12:50:41
Previous
Получить вывод по UUID
Next
Песочница: симулировать отказ оплаты
Built with