Skip to content

Запросить вывод средств реферала

Request

Выводит средства с виртуального счёта реферального бенефициара текущего пользователя на сохранённые реквизиты. ИНН и реквизиты в теле запроса не принимаются. Перед созданием операции проверяются доступный остаток, реквизиты и актуальный статус по ИНН: для ИП/ООО — действующий бизнес без ликвидации, для самозанятого — действующий НПД. Подтверждённый неактивный статус даёт 409 BUSINESS_INACTIVE; недоступность проверки — 503. При принятии запроса сумма атомарно переносится из available_rub в blocked_rub. Вывод проводится через create_deal: payer — стандартный виртуальный счёт этого бенефициара, единственный recipient типа payment_contract — сохранённый внешний расчётный счёт. После проверки сделки вызывается execute_deal; результат подтверждается по get_deal и статусу выплаты recipient, а не по ответу create_deal. Повтор с тем же Idempotency-Key и тем же телом возвращает ту же операцию без нового вывода.

Security
bearerAuth or jwtCookie
Headers
Idempotency-Keystring, (uuid)required

UUID-ключ одной операции вывода. Повтор с тем же ключом и другим телом возвращает 409 IDEMPOTENCY_KEY_REUSED.

Bodyapplication/jsonrequired
amount_rubinteger, (int64), >= 1required

Сумма вывода в целых рублях.

curl -i -X POST \
  https://felmee.com/api/referral-system/withdrawals \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -d '{
    "amount_rub": 1
  }'

Responses

Запрос на вывод принят; окончательный результат следует получить по withdrawal_id

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(WithdrawalAcceptedData)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "Withdrawal accepted", "codeError": null, "error_code": null, "data": { "withdrawal_id": "9c42f2d4-7e6a-4e52-8e81-60d486decb42", "amount_rub": 2000, "status": "PROCESSING", "created_at": "2026-11-05T12:00:00Z" } }