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

POST

https://api.smerch.io/api/v1/integration/refunds

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

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

API Key

Add parameter in header

X-Signature

Example:

X-Signature: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Возврат создан

Bodyapplication/json

🟢202Accepted

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.smerch.io/api/v1/integration/refunds' \
--header 'Idempotency-Key;' \
--header 'X-Api-Key: <api-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 Example

201 - Example 1

{
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "subscription_uuid": "1d315b44-b5ed-49fd-a63a-f8129c5d76c8",
    "transaction_uuid": "3a6bcbed-b7dc-4791-84fe-b20f12be4001",
    "amount_minor": 0,
    "currency": "string",
    "status": "requested",
    "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-10-20 12:29:50

Получить вывод по UUID

Посмотреть настройки webhook