POST /api/sandbox/loans/{id}/repayment-flow
POST/api/sandbox/loans/:id/repayment-flow
Продвигает один шаг cabinet-compatible repayment flow. Используйте его, чтобы сымитировать полное, частичное или процентное погашение с test payment wallet, KYT, settlement и collateral return.
Actions выполняются строго по порядку:
start_payment- создать repayment operation и получить sandbox wallets.confirm_usdt- подтвердить тестовое зачисление платежа черезtx_hashиconfirmations.run_kyt- сымитировать KYT check для платежа.complete_settlement- погасить проценты или основной долг.complete_collateral_return- вернуть залог после полного погашения.
Шаг нельзя выполнить слишком рано. API возвращает 409 FLOW_CONFLICT, если state не разрешает requested action. Для восстановления вызовите GET /api/sandbox/state.
Response wallets находятся в sandboxFlow.repaymentOperations[].wallets: repayment для платежа и collateralReturn для возврата залога после полного погашения. Sandbox не требует external chain polling: подтверждение симулируется POST action confirm_usdt.
POST-запросы должны включать Idempotency-Key, чтобы retry не создал вторую repayment operation и не продублировал state transition.
Пример:
curl https://partner.fundora.capital/api/sandbox/loans/LOAN_ID/repayment-flow \
-H "Authorization: Bearer sk_sandbox_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: b6dc3b48-8a3b-4c19-9c7c-365809712665" \
-d '{"action":"start_payment","repayment_kind":"full_principal","full_repayment":true}'
Запрос
Ответы
- 200
- 400
- 401
- 404
- 409
- 429
Обновленный Sandbox loan state
Invalid request: невалидный body, отсутствует Idempotency-Key для POST, неизвестный action или невалидная сумма
Sandbox API key отсутствует или недействителен
Займ не найден
Flow не может продолжиться из текущего state, balance/limit недостаточен или Idempotency-Key конфликтует
Превышен Sandbox API rate limit