Overview
The finance endpoints described in this section are not published on the external gateway yet. This section describes the target contract and may change before release — confirm availability with the Integration team (api@qitech.com.br) before building against it.
The Financial surface gives visibility over your remuneration as a distributor: the balance of your commission position, the statement of movements and the payouts executed by QI Tech to your account.
How your commission is accrued
Accrual happens on a cash basis, per policy installment: each time a premium installment is effectively settled by the insured person, your commission over that installment is credited to your position. Nothing is credited before the money comes in.
- Credit — on each settled installment, your slice (computed with the commission rate frozen at the sale) becomes a payable entry in your position.
- Clawback — the cancellation of a policy with a premium refund produces a negative entry, offsetting the corresponding commission. Negative entries never produce a charge against your account: they are netted against your next credits.
- Payout — on a cadence configured for your account (daily, weekly or monthly, with an optional minimum amount), QI Tech aggregates the available net position and executes the transfer to your account.
Pending × available balance
| Concept | Meaning |
|---|---|
pending_amount | Credited entries that have not yet reached the release date of your payout schedule. |
available_amount | Net amount already released, which will enter the next payout. |
Endpoints
| Endpoint | Description |
|---|---|
GET /finance/v1/balance | Balance of your commission position. |
GET /finance/v1/statement | Statement of your movements. |
GET /finance/v1/transfers | Payouts executed to your account. |
The financial endpoints are read-only: there is no money-movement endpoint on this surface. Payouts are executed automatically by QI Tech according to your account's configuration.