Atores da operação
Uma cessão de crédito tem mais partes do que aparece no payload da API. Conhecer cada papel ajuda a interpretar erros (por que esse webhook veio?) e a desenhar sua integração de forma defensiva.
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:
%%{init: {"flowchart": {"htmlLabels": false}}}%%
flowchart LR
cotistas["Cotistas"]
fundo["FIDC"]
originador["Originador / cedente"]
tomador["Tomador / sacado"]
cotistas -->|"Investimento"| fundo
fundo -->|"Valor de aquisição (cessão)"| originador
tomador -->|"Pagamento de parcelas"| originador
originador -->|"Repasse via conta vinculada"| fundo
fundo -->|"Distribuição de rendimentos"| cotistas
- 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.