> ## 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/payment/discount/list` · `/v1/payment/discount/set`

Скидка или наценка плательщику на чекауте в зависимости от выбранной монеты. Положительный процент —
**скидка** за оплату этой монетой; отрицательный — **наценка**.

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

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

***

## POST /v1/payment/discount/list

Показать текущие правила — пустое тело `{}` без параметров.

```json theme={null}
{
  "state": 0,
  "result": [
    { "currency": "USDT", "network": "tron", "discount_percent": 3 }
  ]
}
```

Каждый элемент: `currency`, `network`, `discount_percent`.

***

## POST /v1/payment/discount/set

<ParamField body="currency" type="string">
  Валюта. Пусто = глобальный дефолт для всех монет.
</ParamField>

<ParamField body="network" type="string">
  Сеть. Пусто = любая сеть данной валюты.
</ParamField>

<ParamField body="discount_percent" type="int64" required>
  Процент, −99…99. Плюс — скидка, минус — наценка.
</ParamField>

### Пример запроса

<CodeGroup>
  ```bash cURL theme={null}
  BODY='{"currency":"USDT","network":"tron","discount_percent":3}'
  TS=$(date +%s)
  SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payment/discount/set' "$BODY" \
    | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
  curl -s https://api.oblodai.com/v1/payment/discount/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/payment/discount/set", {"currency": "USDT", "network": "tron", "discount_percent": 3})
  ```

  ```js Node.js theme={null}
  await call("/v1/payment/discount/set", { currency: "USDT", network: "tron", discount_percent: 3 });
  ```
</CodeGroup>

### Пример ответа

Эхо сохранённого правила:

```json theme={null}
{ "state": 0, "result": { "currency": "USDT", "network": "tron", "discount_percent": 3 } }
```

### Коды ошибок

| Код                             | Значение                                 |
| ------------------------------- | ---------------------------------------- |
| `400 discount.unknown_currency` | Неизвестная валюта.                      |
| `400 discount.out_of_range`     | `discount_percent` вне диапазона −99…99. |

***

## Нюансы

* **100 % скидка запрещена** — дала бы нулевую цену.
* Запись по конкретной монете **перекрывает** глобальный дефолт.
* Скидка/наценка применяется к цене **до фиксации курса**.

***

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

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

  <Card title="Допуск недоплаты" href="/reference/payment-accuracy" icon="arrow-right" horizontal />
</CardGroup>