O processo de KYC é obrigatório para todas as operações de crédito da plataforma e tem como objetivo validar a identidade e a elegibilidade do tomador antes do desembolso.
A plataforma oferece dois modelos de KYC:
| Modelo | Descrição |
|---|---|
| Embarcado | O KYC é executado automaticamente pela Celcoin no momento da criação da CCB. Nenhuma ação adicional é necessária. |
| Externo | O parceiro executa o KYC no próprio ambiente e encaminha uma hash de evidência para a plataforma antes da criação da CCB. |
Modelo 1 — KYC Embarcado
O KYC embarcado está integrado à esteira de crédito da Celcoin. Ao criar uma operação de crédito (CCB), o processo de verificação é iniciado automaticamente para o tomador vinculado.
O status do KYC é refletido na esteira via webhook pelo evento APPLICATION_STATUS_UPDATED:
KYC_PROCESSING— verificação em andamentoCANCELEDcomstatus_description: "KYC_REJECTED"— tomador reprovado
Nenhuma chamada adicional é necessária para este modelo.
Antecipação da consulta
É possível antecipar o KYC de um tomador antes da criação da CCB. Isso permite identificar eventuais reprovações mais cedo no fluxo, evitando que a operação seja criada para um tomador inelegível.
POST /banking/originator/persons/background-checkBody
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
taxpayer_id | string | Sim | CPF do tomador |
name | string | Sim | Nome completo do tomador |
Exemplo
curl --request POST \
'https://platform.flowfinance.com.br/banking/originator/persons/background-check' \
--header 'Authorization: Bearer <seu_token>' \
--header 'Content-Type: application/json' \
--data '{
"taxpayer_id": "64721458908",
"name": "Felipe Tavares"
}'Modelo 2 — KYC Externo
Neste modelo, o parceiro é responsável por executar o KYC no próprio ambiente utilizando o provedor de sua preferência. Após a execução, ele deve encaminhar para a plataforma uma hash de evidência que comprove a realização do processo.
A hash de evidência deve ser enviada antes da criação da CCB. Caso contrário, a operação ficará travada na esteira Agreement_redenring
A hash é gerada livremente pelo parceiro — não há um formato específico exigido pela plataforma. O importante é que ela identifique unicamente a evidência de KYC executada.
POST /banking/originator/persons/background-check/externalBody
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
taxpayer_id | string | Sim | CPF do tomador |
name | string | Sim | Nome completo do tomador |
kyc_validation_hash | string | Sim | Hash gerada pelo parceiro como evidência da execução do KYC |
Exemplo
curl --request POST \
'https://platform.flowfinance.com.br/banking/originator/persons/background-check/external' \
--header 'Authorization: Bearer <seu_token>' \
--header 'Content-Type: application/json' \
--data '{
"taxpayer_id": "51042629870",
"name": "Roberto Sobral",
"kyc_validation_hash": "hash-gerada-pelo-parceiro"
}'Comparativo entre os modelos
| KYC Embarcado | KYC Externo | |
|---|---|---|
| Quem executa | Celcoin | Parceiro |
| Quando ocorre | Automaticamente na criação da CCB | Antes da criação da CCB |
| Ação necessária | Nenhuma (ou antecipação opcional) | Envio da hash de evidência obrigatório |
| Impacto se não executado | Não se aplica | Operação trava na esteira |