Документация/Платежи/Создать возврат

Создать возврат

POST/api/v1/payments/{id}/refunds

Полный или частичный возврат. Меньшая сумма переводит платёж в partially_refunded.

HMACIdempotency-Key requiredcreateRefund

Path-параметры

ПолеТипОписание
idrequuid

Параметры тела

ПолеТипОписание
amount_minorint64

Пример

Запрос

POST /api/v1/payments/{id}/refunds
Idempotency-Key: order-20260817-001

{}

Ответ 200

{
  "payment_id": "0198c5f2-7b3e-7a41-9c2d-3f8a1b6e4d02",
  "status": "created",
  "final": false,
  "created_at": "2026-08-17T12:45:22Z",
  "updated_at": "2026-08-17T12:45:22Z"
}

Собрать запрос

Собрать запрос
curl -X POST \
  https://api.calibripay.com/api/v1/payments/{id}/refunds \
  -H "X-Access-Key: $CALIBRIPAY_ACCESS_KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE" \
  -H "Idempotency-Key: order-20260817-001" \
  -d '{id}/refunds Idempotency-Key: order-20260817-001 {}'

$TS, $NONCE и $SIGNATURE вычисляются на вашем backend по канонической строке. secret_key никогда не должен попадать в браузер, в командную строку из истории и в тикеты.

Связанные операции

POST/api/v1/payment-sessionsСоздать платёжную сессиюGET/api/v1/payment-sessions/{id}Статус платёжной сессииPOST/api/v1/payments/directПрямой платёж (H2H)GET/api/v1/payments/{id}Статус платежа
← НазадСписок возвратовДальше →Создать подписку
Была ли страница полезной?