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

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

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

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

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

---

​

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

Тело — {}.

{ "state": 0, "result": { "fee_on_customer": false, "configured": false } }

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

---

​

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

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

true — клиент получает net (комиссию платит клиент); false — мерчант платит комиссию, клиент получает gross.

Ответ:

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

---

​

Примеры

cURL

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"

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

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

---

​

Нюансы

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

---

​

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

POST /v1/payment/refund

Кто платит сетевую комиссию выплаты