1. Возвраты
Smerch — API интеграции для мерчантов
  • Авторизация
    • Проверка доступности API
      GET
  • Балансы
    • Список балансов мерчанта по API-ключу
      GET
  • Выводы
    • Создать выплату мерчанта
      POST
    • Котировка выплаты (комиссии / FX)
      GET
    • Получить выплату по UUID
      GET
  • Курсы
    • Курсы FX для аутентифицированного мерчанта
      GET
  • Возвраты
    • Создать возврат через HMAC (обязателен Idempotency-Key)
      POST
  • Песочница
    • Симулировать failed-колбэк провайдера (только non-production / тестовые ключи)
      POST
    • Симулировать out-of-order колбэки fail→paid (только non-production / тестовые ключи)
      POST
    • Симулировать paid-колбэк провайдера (только non-production / тестовые ключи)
      POST
    • Симулировать timeout/expired колбэк провайдера (только non-production / тестовые ключи)
      POST
  • Платежи
    • Список транзакций мерчанта (cursor pagination, опциональный поиск)
      GET
    • Создать платёжную транзакцию мерчанта
      POST
    • Получить транзакцию по external_id мерчанта
      GET
    • Получить транзакцию по UUID
      GET
    • Получить host-to-host реквизиты оплаты по транзакции
      GET
  • Вебхуки
    • Получить конфигурацию webhook мерчанта
      GET
    • Обновить конфигурацию webhook мерчанта
      PUT
    • Список доставок webhook
      GET
    • Ротация секрета подписи webhook (окно overlap сохраняется)
      POST
    • Отправить тестовую доставку webhook
      POST
    • Исходящий колбэк статуса транзакции на URL мерчанта
    • Исходящий колбэк статуса выплаты на URL мерчанта
  • Schemas
    • CreatePayoutRequest
    • CreateRefundRequest
    • CreateTransactionRequest
    • CursorMeta
    • ErrorResponse
    • H2hTransactionResponse
    • HealthResponse
    • IntegrationBalancesResponse
    • MerchantBalance
    • MerchantPayoutCallback
    • MerchantTransactionCallback
    • PayoutQuoteResponse
    • PayoutResponse
    • RatesResponse
    • RefundResponse
    • StructuredError
    • TransactionCursorPage
    • TransactionResponse
    • ValidationErrorResponse
  1. Возвраты

Создать возврат через HMAC (обязателен Idempotency-Key)

POST
/integration/refunds

Request

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

Body Params application/jsonRequired

Examples

Responses

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

🟢202
🟠401Unauthorized
🟠403Forbidden
🟠409Conflict
🟠422ValidationError
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-22 06:20:15
Previous
Курсы FX для аутентифицированного мерчанта
Next
Симулировать failed-колбэк провайдера (только non-production / тестовые ключи)
Built with