Caso não utilize o KYC da Celcoin

Introdução

Utilize esta API para enviar o relatório do processo de KYC realizado com seu fornecedor na abertura de conta pela solução de BaaS da Celcoin.

Aos usuários que realizam o KYC com a Celcoin, vejam mais no tópico "Utilização do KYC Celcoin".

Pré requisitos para implementação:

• Possuir uma chave API da Celcoin, essa chave API é enviada após contratar o serviço conosco. link.

• Ter familiaridade com APIs Rest usando o protocolo OAuth 2.0.

• Ter o produto/solução contratada, caso queira usar a funcionalidade em ambiente produtivo, por favor entre em contato com a nossa equipe comercial através do e-mail [email protected]. Para dúvidas técnicas, basta entrar em contato com o suporte através do link.

Fluxo de integração

Enviar documentos

📘

Todas as documentações solicitadas obrigatoriamente seguem o disposto na CIRCULAR n° 3.978 e Resolução BCB n° 119.

Tabela de arquivos disponíveis para inserção no campo filetype

Modelos de request:

Nestes casos o envio do relatório deverá ocorrer da seguinte forma:

Relatório de uma pessoa física:

curl --location --request POST 'https://sandbox.openfinance.celcoin.dev/celcoinkyc/document/v1/fileupload' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer {{access_token}}' \
-F'documentnumber=12345678900'//numero do CPF
-F'filetype=KYC_EXTERNO'//tipo de documento
-F'front=@/path/kyc_externo.pdf'//arquivo pdf do relatório KYC

Relatório de uma pessoa jurídica:

curl --location --request POST 'https://sandbox.openfinance.celcoin.dev/celcoinkyc/document/v1/fileupload' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer {{access_token}}' \
-F'documentnumber=12345678000100'//numero do CNPJ
-F'filetype=KYC_EXTERNO'//tipo de documento
-F'front=@/path/kyc_externo.pdf'//arquivo pdf do relatório KYC

⚠️

Conteúdo obrigatório no relatório enviado

Neste caso, será necessário utilizar esse endpoint apenas para o envio do relatório contendo o resultado de análise do parceiro de KYC referente a cada titular de novas contas criadas na Celcoin.

No relatório deverá conter informações que comprovem a aprovação da conta no processo de KYC realizado, sendo elas obtidas através das seguintes pesquisas:

• Receita Federal
• Lista OFAC
• PEP
• Sanção
• Ações judiciais
• Notícias (exposição e perfil mídia)
• Segmento de atuação (se for uma empresa)
• Tempo de abertura da empresa (se for uma empresa)

Envie o documento no formato pdf e no campo filetype informe o nome como 'KYC_EXTERNO', dessa forma conseguiremos identificar essa documentação aqui em nosso banco de dados.

✅

Envie o arquivo de documento sempre como Multipart/Form

Multipart envia arquivos/dados para o servidor no formato de array de bytes. Dados de várias partes/formulários são aplicados a um formulário, portanto, você pode enviar tudo em um formulário, incluindo dados "regulares" também.

⚠ Nunca envie os arquivos em base64 ⚠

🚧

Requisição individual por documento

Se for enviar mais de um documento por pessoa física ou jurídica, envie esses em diferentes requisições.

No caso de empresas que têm mais que um sócio, por exemplo, caso opte por enviar o documento de todos os sócios, será necessário o envio individual do documento de cada sócio.

❗️

Os envios devem ser realizados após a solicitação de criação de conta

Importante apenas chamar este serviço de inclusão de documentos após já ter realizado a solicitação de criação de conta. Após o recebimento do webhook de criação de conta (onboarding-create).

OBS: Recomendável que seja realizado no mínimo 20 segundos após a solicitação de criação de conta.

Modelo de response:

{
"status": 200,
"message":"Arquivo enviado com sucesso"
}

Quando não houver um registro de background check, ou seja, uma solicitação de criação de conta (conforme observação no quadro acima), o response virá da seguinte forma:

{
    "errorCode": 404,
    "errorMessage": "BackgroundCheck nao encontrado!"
}

Estrutura do response:

Considerações finais

📘

O resultado das análises, pode levar até 10 minutos para ser concluída.

👍

Importante

Os retornos das análises do KYC serão direcionados no Webhook disponível na documentação do BaaS. Para mais detalhes sobre os templates, utilize o link recomendado abaixo.

Sandbox

No ambiente de sandbox, possuímos o seguinte comportamento:
Caso crie uma conta com final de documento número par, receberá um webhook de approved.
Caso crie uma conta com final de documento ímpar, receberá um webhook de rejected.