Atores da operação

1. Quem está envolvido

Ator	Papel	Aparece na API?
Integrador	Você. Chama a API e consome webhooks. Pode ser originador, bancarizador ou plataforma de crédito	Sim, é o cliente da API
Originador (cedente)	Empresa que origina o lastro e o cede para o fundo	Identificado pelo `partner_id` implícito no token JWT
Bancarizador	Instituição financeira que emite a CCB juridicamente (quando aplicável). Pode ser o mesmo que originador ou separado	Campo `banker_cnpj` em operações com CCB
Tomador / sacado / devedor	Pessoa física ou jurídica que paga o lastro. Chamado de tomador em CCB e contrato pré-pago; sacado em duplicata; devedor de forma genérica. É a mesma figura em todos os casos	Campo `borrower` no payload de cessão
IORQ (gestora)	Gere a carteira do fundo, decide aquisições, monitora qualidade, opera a API	Operadora — não aparece no payload, está implícita
Administradora (ADM)	Custodia ativos, gera termos de cessão, reporta à CVM, processa desembolsos	Não aparece. Você é avisado das ações da ADM via webhook
Custodiante	Verifica lastros e guarda documentos físicos	Não aparece. Geralmente é a própria ADM
Cotistas	Investidores do fundo	Invisíveis na API. Influenciam indiretamente os critérios de elegibilidade

2. Quem paga quem

Em uma operação que segue o caminho normal:

Cotistas → fundo — investimento inicial e adicional
Fundo → originador — pagamento do valor de aquisição na cessão
Tomador → originador → fundo — pagamento de parcelas (originador recebe e repassa ao fundo via conta vinculada)
Fundo → cotistas — distribuição de rendimentos

Em operações pós-cessão, o fluxo de dinheiro é diferente. Detalhes em Operações pós-cessão.

3. Quem pode ser o integrador

A API não fixa qual papel chama os endpoints. Em diferentes arranjos comerciais, o integrador pode ser:

Arranjo	Integrador	Por quê
Originador direto	O próprio originador	Caso clássico — originador tem TI própria e cede direto
Plataforma de crédito	Plataforma que serve múltiplos sub-originadores	Plataforma agrega volume e abstrai a integração para os parceiros menores
Bancarizador	Banker quando ele detém a relação direta com o fundo	Arranjos em que o originador não tem CNPJ qualificado para ceder direto

Em todos os casos, as credenciais OAuth identificam uma aplicação cliente vinculada a um partner_id. O partner_id determina quais fundos a aplicação acessa e quais regulamentos aplicar.

4. Próximos passos

Continuar — Ciclo de vida do direito creditório

Estados e transições de uma operação dentro do fundo.

Continuar — Critérios de elegibilidade

O que a IORQ valida antes de aceitar uma cessão.