Перейти к основному содержимому

POST /api/sandbox/loans/flow

POST 
/api/sandbox/loans/flow

Продвигает один шаг cabinet-compatible loan issuance flow. Это основной endpoint для интеграций, которые хотят повторить путь пользователя из Fundora borrower dashboard.

Actions выполняются строго по порядку:

  1. start_collateral_transfer - создать draft заявки, рассчитать параметры займа и получить sandbox wallets.
  2. confirm_btc - подтвердить тестовое BTC-зачисление залога через tx_hash и confirmations.
  3. run_kyt - сымитировать KYT check.
  4. complete_payout - завершить payout simulation и превратить заявку в активный займ.

Шаг нельзя выполнить слишком рано. API возвращает 409 FLOW_CONFLICT, если state не разрешает requested action. Для восстановления вызовите GET /api/sandbox/state и продолжайте с текущего шага.

Response wallets находятся в sandboxFlow.loanApplications[].wallets. Это deterministic test addresses: collateralDeposit для залога, loanPayout для выдачи и collateralReturn для будущего возврата залога. В production transactions будут отслеживаться по on-chain credits, но Sandbox не требует external chain polling: подтверждение симулируется POST action confirm_btc.

POST-запросы должны включать Idempotency-Key, чтобы retry не создал второй draft и не продублировал state transition.

Пример:

curl https://partner.fundora.capital/api/sandbox/loans/flow \
  -H "Authorization: Bearer sk_sandbox_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0d66a118-e544-4a82-94de-35c9f28a0f38" \
  -d '{"action":"start_collateral_transfer","collateral_btc":0.1,"loan_amount":3000,"loan_currency":"USDT","external_client_id":"client-42"}'

Запрос​

Ответы​

Обновленный Sandbox loan state