Сделать возврат по платежу (API v2)

POST

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

То же, что возврат в v1, но на /api/v2 с ошибками в формате Problem Details. Idempotency-Key обязателен.

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

🟢201

application/json

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

Bodyapplication/json

🟢202

🟠401Problem

🟠403Problem

🟠409Problem

🟠422Problem

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.smerch.io/api/v2/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:31:06

Проверить, что API v2 отвечает

Получить список рекуррентных мандатов