Início
Os endpoints financeiros descritos nesta seção ainda não estão publicados no gateway externo. Esta seção descreve o contrato-alvo e pode mudar antes da liberação — confirme a disponibilidade com o time de Integração (api@qitech.com.br) antes de implementar contra ela.
A superfície Financeiro dá visibilidade sobre a sua remuneração como distribuidor: o saldo da sua posição de comissão, o extrato de movimentações e os repasses realizados pela QI Tech para a sua conta.
Como a sua comissão é apurada
A apuração é feita em regime de caixa, por parcela de apólice: a cada parcela de prêmio efetivamente liquidada pelo segurado, a sua comissão sobre aquela parcela é creditada na sua posição. Nada é creditado antes de o dinheiro entrar.
- Crédito — a cada parcela liquidada, a sua fatia (calculada com a taxa de comissão congelada na venda) vira um lançamento a pagar na sua posição.
- Estorno (clawback) — o cancelamento de uma apólice com devolução de prêmio gera um lançamento negativo, que compensa a comissão correspondente. Lançamentos negativos nunca geram cobrança contra a sua conta: eles são abatidos dos seus próximos créditos.
- Repasse — em uma cadência configurada para a sua conta (diária, semanal ou mensal, com valor mínimo opcional), a QI Tech agrega a posição líquida disponível e executa a transferência para a sua conta.
Saldo pendente × disponível
| Conceito | Significado |
|---|---|
pending_amount | Lançamentos creditados que ainda não atingiram a data de liberação do seu cronograma de repasse. |
available_amount | Valor líquido já liberado, que entrará no próximo repasse. |
Endpoints
| Endpoint | Descrição |
|---|---|
GET /finance/v1/balance | Saldo da sua posição de comissão. |
GET /finance/v1/statement | Extrato das suas movimentações. |
GET /finance/v1/transfers | Repasses realizados para a sua conta. |
Os endpoints financeiros são somente de leitura: não existe endpoint de movimentação de dinheiro nesta superfície. Os repasses são executados automaticamente pela QI Tech conforme a configuração da sua conta.