Автовозврат

Методы: /v1/payment/autorefund/get · /v1/payment/autorefund/set

Авто‑возврат средств плательщику при платежах вне допуска: возврат излишка при переплате и возврат суммы при истёкшей недоплате.

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

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

---

​

POST /v1/payment/autorefund/get

Тело — {}.

{ "state": 0, "result": { "overpay": true, "underpay": true, "configured": false } }

Оба флага по умолчанию включены. configured: false означает, что явной записи нет и возвращён дефолт.

---

​

POST /v1/payment/autorefund/set

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

Возвращать излишек при переплате (paid_over).

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

Возвращать средства при истёкшей недоплате (wrong_amount).

​

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

cURL

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

await call("/v1/payment/autorefund/set", { overpay: true, underpay: true });

---

​

Нюансы

• Возврат идёт на адрес плательщика. По умолчанию из суммы удерживаются и наша комиссия, и сетевой газ (авто-возвраты по умолчанию «за счёт клиента»). То есть плательщик получает сумма − наша комиссия − газ. Кто несёт комиссию возврата — настраивается на уровне проекта через refund-fee-config; можно переключить на «за счёт мерчанта». (Важно: у ручного /v1/payment/refund дефолт обратный — за счёт мерчанта.)
• Поддержаны сети EVM, Tron, TON, Solana. Для Bitcoin/UTXO возврат ручной.
• Взаимодействие с допуском: сначала работает accuracy (недоплата в пределах допуска считается оплатой), а автовозврат обрабатывает то, что в допуск не попало.

---

​

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

Недоплата, переплата и автовозврат

Допуск недоплаты

POST /v1/payment/refund