Вернуть платёж

posthttps://httpbin.org/anything/payments/{payment_id}/refund

Полный или частичный возврат. Частичный — если указана сумма amount.

Авторизация

  • bearerAuthBearer-токен в заголовке Authorization (JWT)

Параметры пути

  • payment_idstringобязательно

Заголовки

  • Idempotency-Keystring<uuid>обязательно

    Уникальный ключ для защиты от повторных возвратов

Тело запроса

application/json
  • amountinteger

    Сумма возврата в тиынах. Если не указана — полный возврат.

  • reasonstring

    макс. длина: 255

Ответы

application/json

Возврат выполнен

  • idstring

    пример: "pay_9f2k3"

  • cardobject | nullread-only
    • brandstring

      один из: "visa", "mastercard", "mir", "unionpay"

    • masked_panstring

      пример: "440043******1234"

  • amountinteger

    Сумма в минимальных единицах валюты (тиыны, копейки)

    пример: 150000

  • statusstring

    один из: "pending", "paid", "failed", "expired", "refunded"

  • paid_atstring<date-time> | null
  • currencystring

    пример: "KZT"

  • order_idstring
  • created_atstring<date-time>
  • checkout_urlstring<uri>

    Ссылка на страницу оплаты

    пример: "https://pay.example.kz/9f2k3"

post
curl -X POST 'https://httpbin.org/anything/payments/%7Bpayment_id%7D/refund' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
  "amount": 0,
  "reason": "string"
}'
Пример ответа
json
{
  "id": "pay_9f2k3",
  "amount": 150000,
  "status": "pending",
  "paid_at": "2026-01-15T10:30:00Z",
  "currency": "KZT",
  "order_id": "string",
  "created_at": "2026-01-15T10:30:00Z",
  "checkout_url": "https://pay.example.kz/9f2k3"
}
Была ли страница полезна?