Pular para o conteúdo principal

Início

Superfície ainda não disponível

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

ConceitoSignificado
pending_amountLançamentos creditados que ainda não atingiram a data de liberação do seu cronograma de repasse.
available_amountValor líquido já liberado, que entrará no próximo repasse.

Endpoints

EndpointDescrição
GET /finance/v1/balanceSaldo da sua posição de comissão.
GET /finance/v1/statementExtrato das suas movimentações.
GET /finance/v1/transfersRepasses realizados para a sua conta.
informação

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.