Сетевая комиссия выплаты

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

Per‑project настройка: перекладывать ли сетевую комиссию выплаты на получателя.

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

Примеры используют хелпер call() и переменные $SECRET/$PUBLIC_ID — их определение см. в Как подписать запрос. Проще не писать подпись руками, а взять SDK.

---

​

POST /v1/payout/fee-config/get

Тело — пустой объект {} без параметров.

{ "state": 0, "result": { "fee_on_recipient": true, "configured": true } }

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

---

​

POST /v1/payout/fee-config/set

fee_on_recipient · bool · обязательно

true — сетевую комиссию платит получатель (получает меньше); false — комиссию несёт мерчант.

Ответ:

{ "state": 0, "result": { "fee_on_recipient": true } }

---

​

Примеры

cURL

BODY='{"fee_on_recipient":true}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/payout/fee-config/set' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/payout/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"

call("/v1/payout/fee-config/set", {"fee_on_recipient": True})
call("/v1/payout/fee-config/get", {})

await call("/v1/payout/fee-config/set", { fee_on_recipient: true });
await call("/v1/payout/fee-config/get", {});

---

​

Нюансы

• Это про сетевую комиссию выплаты. За то, кто несёт нашу комиссию при возврате, отвечает отдельная настройка — refund-fee-config.
• Влияет на распределение сумм в POST /v1/payout/calculate и на фактическую выплату.

---

​

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

POST /v1/payout/calculate

POST /v1/payout

Кто платит комиссию возврата