QFAST API Documentation
  1. Disbursement
  • Authentication
  • Onboarding
    • Overview
    • Reference
      • Area Reference
    • API
      • Onboarding Personal
      • Get Onboarding Status
      • Submit Loan
      • Get Loan
    • Webhook
      • Onboarding Webhooks
  • Disbursement
    • Overview
    • Webhook
      • Disbursement Webhooks
  • Repayment
    • Overview
    • Webhook
      • Repayment Webhooks
  • Schemas
    • Loan Schema
    • Onboarding Schema
  1. Disbursement

Overview

Disbursement Flow#

Disbursement transfers the loan principal (minus admin fees) from the lender's escrow wallet to the borrower's DOKU wallet. Processing is asynchronous — QFAST notifies your system via webhook when the transfer completes or fails.

1. Overview#

After a loan reaches active status, the lender initiates disbursement through the QFAST dashboard. QFAST then processes the transfer internally and sends a webhook with the result.

2. Prerequisites#

Loan must exist and be in active status.
Lender's DOKU escrow wallet must have sufficient balance.
The borrower must have a valid DOKU wallet configured.

3. Disbursement Amount#

The amount transferred to the borrower's DOKU wallet is:
disburse_amount = principal_amount - admin_fee_amount
The reserve_amount is held by QFAST and is not transferred to the borrower.

4. Status Lifecycle#

StatusDescription
pendingDisbursement created, awaiting processing.
processingTransfer is in progress.
completedFunds successfully transferred to borrower's wallet.
failedTransfer failed. See webhook payload for reason.

5. Next Steps#

Disbursement Webhooks
Previous
Onboarding Webhooks
Next
Disbursement Webhooks
Built with