POST /v1/transfer/to-personal

Перевести средства с бизнес‑кошелька мерчанта на личный кошелёк владельца аккаунта.

Зачем это. Метод забирает прибыль владельца из общего котла магазинов и переводит её на его личный кошелёк. Сам вывод с личного кошелька наружу — отдельная операция, доступная только в кабинете под 2FA (на API‑ключе её нет).

URL: https://api.oblodai.com/v1/transfer/to-personal · Аутентификация: обязательна · Идемпотентность: заголовок Idempotency-Key и/или order_id.

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

​

Заголовки

Idempotency-Key

Любое уникальное значение (≤255 символов), одинаковое во всех повторах одного перевода. Повтор вернёт тот же ответ и заголовок Idempotent-Replayed: true. → Идемпотентность

---

​

Параметры запроса

amount · string · обязательно

Сумма перевода в currency.

currency · string · обязательно

Код валюты.

order_id · string

Ключ идемпотентности. Повтор — no‑op. Настоятельно передавайте всегда (см. ниже).

---

​

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

cURL

BODY='{"amount":"50","currency":"USDT","order_id":"transfer-1"}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/transfer/to-personal' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/transfer/to-personal \
  -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/transfer/to-personal", {"amount": "50", "currency": "USDT", "order_id": "transfer-1"})

await call("/v1/transfer/to-personal", { amount: "50", currency: "USDT", order_id: "transfer-1" });

---

​

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

{
  "state": 0,
  "result": { "currency": "USDT", "amount": "50", "direction": "to_personal", "personal_balance": "150" }
}

---

​

Коды ошибок

Код	Значение
400 transfer.no_personal_wallet	У мерчанта нет привязанного владельца.
400 transfer.unknown_currency	Неизвестная валюта.
400 transfer.bad_amount	Некорректная сумма.
400 personal.amount_invalid	Сумма перевода некорректна (≤0 или неверный формат).
400 personal.insufficient	Недостаточно средств на балансе для перевода.
400 request.bad_json	Тело не парсится.

---

​

Нюансы

• Всегда передавайте order_id. Формально поле необязательное, но без него повтор запроса при сетевом таймауте создаст второй перевод. С order_id повтор гарантированно no‑op.
• Перевод вводит средства В личный кошелёк. Обратная операция и вывод из личного кошелька доступны только в кабинете под 2FA — на API‑ключе их намеренно нет.
• Личный кошелёк общий для всех магазинов владельца.

---

​

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

POST /v1/balance

Безопасность в проде