# How the referral program works

The Referral Program works by connecting your DIDWW account to new business customers who register through your referral
link. When a referred customer qualifies and generates invoice activity, DIDWW creates commission records that can later
become available for withdrawal.

The flow starts when the account owner joins the program and shares the referral link. The referred customer then
registers and verifies their account, eligible invoices create commissions, and approved earnings can be withdrawn when
the withdrawal requirements are met.

```
        ---
config:
  layout: dagre
---
flowchart LR
    classDef decision stroke:#fb923c,fill:#fef3c7,color:#111827,stroke-width:2px
    classDef action stroke:#22c55e,fill:#dcfce7,color:#111827,stroke-width:2px
    classDef outcome stroke:#ef4444,fill:#fee2e2,color:#111827,stroke-width:2px
    classDef input stroke:#38bdf8,fill:#e0f2fe,color:#111827,stroke-width:2px

    subgraph S1[Join the program]
        direction TB
        A[Join Referral Program]:::input
        B[Share referral link]:::action

        A --> B
    end

    subgraph S2[Invite customers]
        direction TB
        C[Referred customer registers a business account and verifies their identity]:::input
        D[Referral created]:::action

        C --> D
    end

    subgraph S3[Earn commissions]
        direction TB
        E[Referred customer generates invoices]:::input
        F[Referral status changes from pending to active]:::action
        I[Commission earned]:::outcome

        E --> F
        F --> I
    end

    subgraph S4[Withdraw commissions]
        direction TB
        G{"Minimum withdrawal threshold reached?"}:::decision
        H[Withdraw commissions]:::action
        J[Withdrawal not yet available]:::outcome

        G -->|YES| H
        G -->|NO| J
    end

    B --> C
    D -->|Referral remains active for 12 months| E
    I -->|Commission remains pending for 90 days| G

    style S1 fill:#ffffff,stroke:#d1d5db,color:#111827,stroke-width:1px
    style S2 fill:#ffffff,stroke:#d1d5db,color:#111827,stroke-width:1px
    style S3 fill:#ffffff,stroke:#d1d5db,color:#111827,stroke-width:1px
    style S4 fill:#ffffff,stroke:#d1d5db,color:#111827,stroke-width:1px
```

## Referral participants

The Referral Program involves two customer roles:

- **Referrer** - The DIDWW customer account that joins the Referral Program and receives a referral link.
- **Referred customer** - The customer account that registers through the referrer's link and qualifies as a referral.

Only the account owner can join the Referral Program or submit withdrawal requests. A business account is required to
join. If an account is personal or not yet verified, the join flow can ask the account owner to complete the required
account updates before enrollment is completed.

Referred customers must register as business accounts to qualify as referrals. Personal accounts can register through a
referral link, but they do not appear in the **My referrals** table or generate commissions. Self-referrals do not
qualify.

## Referral link

After enrollment, DIDWW generates a unique referral link for the referrer. The link contains a referral code that
identifies which account shared the link.

When a new customer opens the registration page through a referral link, DIDWW captures the referral code during
registration. If the new customer completes registration as a qualifying business account, DIDWW creates a referral
relationship between the referrer and the referred customer.

The referral link is the tracking mechanism. The referred customer still completes the normal DIDWW registration and
verification process.

## Referral lifecycle

A referral is the relationship between a referrer and a referred customer. The lifecycle starts when a qualifying
business account registers through the referral link.

Referrals can move through different account status values as the referred customer's activity changes. For example, a
referral can be pending before qualifying invoice activity starts, active while it can generate commissions, expired
after the referral validity period, closed if the referred account is closed, or terminated if the referral relationship
is ended early.

For exact account status values and table fields, see [Account status
values](referral-program-reference.html#referral-program-account-status-values).

## Program terms

Referral Program terms shown in the User Panel are authoritative for your account. The default terms are:

| Term | Description |
| --- | --- |
| Commission rate | Percentage applied to qualifying invoice amounts before VAT. The default commission rate is 10%. |
| Referral validity | Period during which a referred customer can generate commissions for the referrer. The default referral validity period is 12 months from the referred customer's registration date. |
| Commissions pending period | Period before a commission becomes available for withdrawal. The standard pending period is 90 days. |
| Minimum withdrawal amount | Minimum available earnings required before a withdrawal request can be submitted. The default minimum withdrawal amount is 500 USD. |
| Payout method | Referral commissions are paid by bank transfer. |

## Commissions

Referral commissions are created from qualifying invoices generated by referred customers. The commission is calculated
from the invoice amount before VAT, using the commission rate assigned to the referrer.

A commission is created when a referred customer generates a qualifying invoice, and it becomes eligible for withdrawal
once it completes the pending period. If the related invoice is corrected, refunded, voided, or recalculated before that
happens, the commission is adjusted accordingly rather than counted as final.

Referral commission balances are shown as pending earnings and available earnings in the User Panel. Pending earnings
represent commissions that are still within the pending period. Available earnings represent approved commissions that
can be withdrawn when the available balance reaches the minimum withdrawal amount shown in the User Panel.

These balance views are separate from commission status values. Commission statuses describe the state of each
commission entry in the commission ledger, including whether it is still pending, approved, canceled, or already
included in a withdrawal. For exact status descriptions, see [Commission status
values](referral-program-reference.html#referral-program-commission-status-values).

The **Referrals** tab shows referral-oriented balances, including pending earnings and available earnings. The
**Commissions** tab shows the commission ledger, including pending totals and total approved commission earned since
joining the Referral Program. For exact field definitions, see
[Referrals](referral-program-reference.html#referral-program-reference-referrals-tab) and
[Commissions](referral-program-reference.html#referral-program-reference-commissions-tab).

## Withdrawals

Withdrawals are payout requests for available approved referral commissions.

When a withdrawal request is submitted, it is created for the full available approved balance. The amount cannot be
edited in the withdrawal form.

While a withdrawal is being processed, the included commissions are reserved and excluded from available earnings. If
the request does not complete successfully, those commissions are returned to available earnings and can be included in
a future withdrawal.

For the withdrawal procedure, see [Withdraw referral commissions](how-to-guides/withdraw-referral-earnings.html). For
withdrawal fields and status values, see
[Withdrawals](referral-program-reference.html#referral-program-reference-withdrawals-tab).

## Related resources

- [Join the Referral Program](how-to-guides/join-referral-program.html) - Join the program and get your referral link.
- [Withdraw referral commissions](how-to-guides/withdraw-referral-earnings.html) - Request a bank transfer payout for approved commissions.
- [Referral Program reference](referral-program-reference.html) - Review User Panel fields, balances, filters, and status values.

On this page