> ## Documentation Index
> Fetch the complete documentation index at: https://oblodai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Комиссия возврата

**Методы:** `/v1/payout/refund-fee-config/get` · `/v1/payout/refund-fee-config/set`

Per‑project настройка: кто несёт **нашу** комиссию при возврате. Шлюз её никогда не покрывает —
её платит либо клиент (получает net), либо мерчант (клиент получает gross).

**Аутентификация:** обязательна.

<Note>
  Примеры используют хелпер `call()` и переменные `$SECRET`/`$PUBLIC_ID` — их определение см. в
  [Как подписать запрос](/guides/signing-requests). Проще не писать подпись руками, а взять
  [SDK](/sdk/overview).
</Note>

***

## POST /v1/payout/refund-fee-config/get

Тело — `{}`.

```json theme={null}
{ "state": 0, "result": { "fee_on_customer": false, "configured": false } }
```

`configured: false` — override не задан, действует дефолт шлюза.

***

## POST /v1/payout/refund-fee-config/set

<ParamField body="fee_on_customer" type="bool" required>
  `true` — клиент получает **net** (комиссию платит клиент); `false` — мерчант платит комиссию, клиент получает **gross**.
</ParamField>

Ответ:

```json theme={null}
{ "state": 0, "result": { "fee_on_customer": true } }
```

***

## Примеры

<CodeGroup>
  ```bash cURL theme={null}
  BODY='{"fee_on_customer":true}'
  TS=$(date +%s)
  SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payout/refund-fee-config/set' "$BODY" \
    | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
  curl -s https://api.oblodai.com/v1/payout/refund-fee-config/set \
    -X POST -H 'Content-Type: application/json' \
    -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
    -d "$BODY"
  ```

  ```python Python theme={null}
  call("/v1/payout/refund-fee-config/set", {"fee_on_customer": True})
  call("/v1/payout/refund-fee-config/get", {})
  ```

  ```js Node.js theme={null}
  await call("/v1/payout/refund-fee-config/set", { fee_on_customer: true });
  await call("/v1/payout/refund-fee-config/get", {});
  ```
</CodeGroup>

***

## Нюансы

* Это про **нашу** комиссию при **возврате** ([`/v1/payment/refund`](/reference/payment-refund)). Не путайте с
  [`fee-config`](/reference/payout-fee-config), которая про **сетевую** комиссию **выплаты**.
* Шлюз свою комиссию при возврате не покрывает — выбор только между клиентом и мерчантом.

***

## Связанные страницы

<CardGroup cols={2}>
  <Card title="POST /v1/payment/refund" href="/reference/payment-refund" icon="arrow-right" horizontal />

  <Card title="Кто платит сетевую комиссию выплаты" href="/reference/payout-fee-config" icon="arrow-right" horizontal />
</CardGroup>