👍

Importante

Sandbox

No ambiente de sandbox, possuímos o seguinte comportamento:
Utilize o campo phoneNumber para PF
Utilize o campo contactNumber para PJ
Final do telefone terminando em:
1 - Aprovado em ambos os webhooks e criará a conta (Independente dos demais dados informados)
2 - Reprovado no primeiro webhook (Independente dos demais dados informados)
3 - Aprova a primeira etapa do processo e reprova a segunda. (Independente dos demais dados informados)
Diferente de telefone final terminado em 1, 2 e 3 seguirá com o cenário próximo da realidade (Necessário informar dados reais em casos desse).
OBS: O comportamento respeitará a configuração utilizada para o seu caso, fluxo 1 ou fluxo 2.

Informações importantes para o processo em produção nasConsiderações finais

🙍‍♂️

Pessoa Física

Se a proposta for para uma pessoa física. (onboarding-proposal/natural-person) endpoint

URL Sandbox: https://sandbox.openfinance.celcoin.dev/onboarding/v1/onboarding-proposal/natural-person

Exemplo Request:

form-data

{
  "clientCode": "myUniqueCustomCode",
  "documentNumber": "1234567890",
  "phoneNumber": "+5511999999999",
  "email": "[email protected]",
  "motherName": "My mothers name",
  "fullName": "My full name",
  "socialName": "My social name",
  "birthDate": "01-01-1970",
  "address": {
    "postalCode": "99999000",
    "street": "My address",
    "number": "999",
    "addressComplement": "Address references.",
    "neighborhood": "My neighborhood",
    "city": "My city",
    "state": "State"
  },
  "isPoliticallyExposedPerson": false,
  "onboardingType": "BAAS",
  "financialDetails": {
        "declaredIncome": "1DINP02", // Renda declarada
        "occupation": "ONP07", // Profissão
        "netWorth": "NWNP02" // Patrimônio 
  },
  "files": [ //Devem ser informados todos os documentos no request
    {
      "type": "SELFIE",
      "data": "https://cloud.storage/myselfie_with_1h_expiration_minimum.jpeg" //Essa URL deverá ser acessível e atrelada ao download do documento que foi informado no campo "Type". Recomendamos que essa URL tenha um período de expiração de pelo menos 1 hora.
    }
  ]
}

🏛️

Pessoa Jurídica

Se a proposta for para uma pessoa jurídica. (onboarding-proposal/legal-person) endpoint

É importante informar todos os sócios do Quadro Societário da empresa, ou pelo menos os que possuem participação societária maior ou igual a 25%.

URL Sandbox: https://sandbox.openfinance.celcoin.dev/onboarding/v1/onboarding-proposal/legal-person

Exemplo Request:

form-dataJSON

{
  "clientCode": "123456",
  "contactNumber": "+551239215555",
  "documentNumber": "56461227000199",
  "businessEmail": "[email protected]",
  "businessName": "IP Pagamentos",
  "tradingName": "IPay",
  "companyType": "PJ", //tipo da empresa. Informe como PJ casos divergentes de Natureza Juridica Empresário Individual.
  "owner": [
    {
      "ownerType": "REPRESENTANTE",
      "documentNumber": "33333333333",
      "fullName": "Carlos Henrique da Silva",
      "phoneNumber": "+5512981175554",
      "email": "[email protected]",
      "motherName": "Nome Sobrenome",
      "socialName": "Nome",
      "birthDate": "31-12-1984",
      "address": {
        "postalCode": "12211400",
        "street": "Rua da Liberdade",
        "number": "313",
        "addressComplement": "Em frente ao parque.",
        "neighborhood": "Casa Verde",
        "city": "São Paulo",
        "state": "SP"
      },
      "isPoliticallyExposedPerson": false,
      "financialOwnerDetails": {
         "ownerDeclaredIncome": "ODIB02", //Renda declarada em caso de sócio PF
         "ownerDeclaredRevenue": "ODRB02" //Faturamento anual declarado em caso de sócio PJ
       }        
    }
  ],
  "businessAddress": {
    "postalCode": "12211400",
    "street": "Rua da Liberdade",
    "number": "313",
    "addressComplement": "Em frente ao parque.",
    "neighborhood": "Casa Verde",
    "city": "São Paulo",
    "state": "SP"
  },
  "onboardingType": "BAAS",
  "financialCompanyDetails": {
    "declaredCompanyRevenue": "DCRB03", //Faturamento anual declarado da empresa
  },
  "files": [ //Devem ser informados todos os documentos no request
    {
      "type": "RG_FRONT",
      "data": "https://t.ctcdn.com.br/lvns56iaSMyHvyTur4JeYS_NYeY=/i606944.png" //Essa URL deverá ser acessível e atrelada ao download do documento que foi informado no campo "Type". Recomendamos que essa URL tenha um período de expiração de pelo menos 1 hora.
    }
  ]
}

//Exemplo de empresa com sócio PJ, necessário informar o Sócio Administrador da outra empresa.
{
    "clientCode": "a7e9ea3f-69e4-4599-92b4-6cb8a79c3512",
    "contactNumber": "+5511985028123",
    "documentNumber": "42222915000191",
    "businessEmail": "[email protected]}",
    "businessName": "Celcoin",
    "tradingName": "Celcoin Instituição de Pagamento",
    "companyType": "PJ",
    "owner": [
        {
            "ownerType": "SOCIO",//PF
            "documentNumber": "72352781027",
            "fullName": "Nome Socio Primeira Empresa",
            "phoneNumber": "+5511912345128",
            "email": "[email protected]",
            "motherName": "Mother Name Teste",
            "socialName": "Nome",
            "birthDate": "22-06-1972",
            "address": {
                "postalCode": "06455030",
                "street": "Rua do Teste",
                "number": "123",
                "addressComplement": "",
                "neighborhood": "Alphaville Industrial",
                "city": "Barueri",
                "state": "SP"
            },
          "isPoliticallyExposedPerson": false,
          "financialOwnerDetails": {
            "ownerDeclaredIncome": "ODIB02",// Renda declarada em caso de sócio PF
          }        
        },
        {
            "ownerType": "SOCIO",//PJ
            "documentNumber": "02555276000122",
            "fullName": "Razão Social da empresa",
            "phoneNumber": "+5511912345128",
            "email": "[email protected]",
            "motherName": "nao se aplica",
            "socialName": "nao se aplica",
            "birthDate": "22-06-2005",//data de abertura da empresa
            "address": {
                "postalCode": "06455030",
                "street": "Alameda Xingu",
                "number": "123",
                "addressComplement": "",
                "neighborhood": "Alphaville Industrial",
                "city": "Barueri",
                "state": "SP"
            },
          "isPoliticallyExposedPerson": false,
          "financialOwnerDetails": {
            "ownerDeclaredRevenue": "ODRB02",//Faturamento anual declarado em caso de sócio PJ
          } 
        }
    ],
    "businessAddress": {
        "postalCode": "06454000",
        "street": "Alameda Rio Negro",
        "number": "503",
        "addressComplement": "sala 2020",
        "neighborhood": "Alphaville Centro Industrial",
        "city": "Barueri",
        "state": "SP"
    },
  "onboardingType": "BAAS",
  "financialCompanyDetails": {
     "declaredCompanyRevenue": "DCRB03", //Faturamento anual declarado da empresa
  },
  "files": [ //Devem ser informados todos os documentos no request
    {
      "type": "RG_FRONT",
      "data": "https://t.ctcdn.com.br/lvns56iaSMyHvyTur4JeYS_NYeY=/i606944.png" //Essa URL deverá ser acessível e atrelada ao download do documento que foi informado no campo "Type". Recomendamos que essa URL tenha um período de expiração de pelo menos 1 hora.
    }
  ]
}

No atributo “ownerType” deverá ser informado uma das opções: “SOCIO” OU “REPRESENTANTE”. Para casos onde existe mais de um sócio, utilize a opção "SOCIO" para o primeiro Sócio e a opção “DEMAIS_SOCIOS” para os demais. Caso seja informado REPRESENTANTE será obrigatório a inclusão da Procuração de Poderes.
No atributo CompanyType deverá ser informado o tipo de empresa MEI ou PJ. Em caso de dúvidas, é imprescindível questionar ao cliente, pois impactará na jornada de KYC.

Para casos com empresas com sócio PJ, informe o sócio administrador da segunda empresa no request. Exemplo na guia 2 do Request. Para enviar os 2 contratos sociais das empresas, envie o primeiro com file Type CONTRATO_SOCIAL e o outro com o type OUTROS.

Para casos diferentes de MEI o tipo de empresa, informe como tipo PJ.

📘

Informações financeiras

Para informações sobre o correto preenchimento dos campos do objeto "financialDetails" acesse nossa documentação complementar: Informações Financeiras.

⚠️

A URL informada no campo files.data deverá ser acessível e atrelada ao download instantâneo do documento que foi informado no campo "Type".

Recomendamos que essa URL tenha um período de expiração de pelo menos 1 hora.

❗️

Envio de documentos

Não envie o documento pessoal com mais de uma página, caso mande dessa maneira, será reprovado.

Recomendamos que a URL que contém os documentos tenha um período de expiração de pelo menos 1 hora.

Para casos em que a empresa possui sócios que são pessoas jurídicas (empresas sócias), é obrigatório enviar o contrato social dessas empresas sócias.
Você pode:

• Anexar o contrato social da empresa sócia separadamente, utilizando o tipo de arquivo “OUTROS”.
• Agrupar todos os documentos em um único PDF no envio do contrato social.

Aceitamos os formatos: PDF, PNG, JPEG

🚧

Requisição individual por proposta

Atualmente não é possível criar diversas contas em uma única requisição, em casos desses é necessário enviar em diferentes requisições.

Quantidade de propostas por documentos
Temos uma validação onde é permitido criar 1 proposta por documento a cada 24 horas. Logo não é possível criar várias propostas para o mesmo documento enquanto a anterior não estiver finalizada e não tenha passado as 24 horas.

Não temos um limitante de aberturas de propostas, apenas se atente todas as regras e orientações descritas nessa documentação.

📘

Resultado das propostas

Em produção, o resultado das análises, tanto da PF quanto da PJ, pode levar até 48horas úteis para ser concluída.

❗️

Envio categorizado corretamente

Importante realizar o envio correto do tipo de empresa PJ, caso seja realizado um envio incorreto. Exemplo: deveria ser enviado MEI porém foi enviado PJ, isso pode fazer com que ocorra uma reprovação e também será cobrado o valor do tipo enviado.

Para casos divergentes de Natureza Jurídica "Empresário Individual" enviar como tipo de empresa PJ.

☑️

Validações realizadas

Background Check
• Consulta de CPF/CNPJ na Receita Federal;
• Ações judiciais da Empresa/Pessoa (Processos criminais, trabalhistas, etc);
• Lista de sanções (Nacional: COAF, CEAF, CNEP, MTE, PPE, TSE, CEIS, CEPIM, TCU, Conselho nacional de Justiça. Internacional: EU, FBI, GOV UK, INTERPOL, OFAC, UNSC.);
• Exposição e perfil na mídia;
• Lista PEP;

Documentoscopia
• OCR do documento enviado (Validação dos dados enviados x encontrados na receita x dados do documento enviado);
• Pericia Documental/Documentoscopia;
• Facematch (Validação entre Selfie x Foto documento físico);
• Análise do contrato social e procuração de poderes (Validação da autenticidade do documento e QSA);

👍

Importante

Documentação

Documentos e formatos aceitos:

PF:

• RG: foto do documento físico (frente e verso);
• CIN: PDF da versão digital oficial;
• CNH: documento físico ou CNH Digital com QR Code;
• RNE/RNM: documento válido para estrangeiros.

PJ:

• Contrato Social (em casos de clientes MEI, o Certificado da Condição do Microempreendedor Individual (CCMEI))
• Documentos PF citados acima do sócio/representante legal.

Importante:

Não é aceito RG Digital.

Não são aceitos prints de tela de celular, capturas de tela ou fotos tiradas de telas de computadores, tablets ou outros dispositivos eletrônicos.

São aceitos apenas documentos de identificação emitidos há, no máximo, 15 anos, contados da data de emissão.

Não são aceitas xerox autenticadas dos documentos de identificação.

Todos os documentos devem estar legíveis, íntegros, sem cortes e em boas condições de visualização, permitindo a validação de sua autenticidade.

Não aceitamos documentos com tamanho maior que 10MB

Webhooks

Em caso de não receber o webhook é possível realizar uma chamada para receber o reenvio, para mais informações acesse a documentação de reenvio clicando aqui.

Motivos de Reprovação

O campo RejectedReason nos Webhooks quando a proposta é reprovada, informará o motivo da reprovação.

RejectedReason	Descrição
Inconsistência nos dados de biometria facial.	Faz uma verificação anti-spoofing na selfie enviada. O que aciona essa regra é ser detectado o spoofing.
Não identificamos um documento válido nas imagens enviadas.	Verifica se nas imagens enviadas existe um documento.
As imagens enviadas não estão legíveis.	Verifica se as imagens enviadas são legíveis.
Documento informado como tipo CNH porém não foi identificado como CNH.	Verifica se o documento enviado é uma CNH.
Não possui CPF identificado no documento ou informado manualmente.	Verifica se foi encontrado CPF no documento ou informado manualmente.
Foto de selfie não enviada.	Verifica o envio de selfie.
Cliente reprovado por Facematch, divergência entre Selfie x Foto documento enviado.	Verifica a similaridade entre documento e selfie.
Não foi possível consultar o CPF na Receita Federal.	Verifica se foi possível consultar o CPF na Receita Federal.
CPF irregular.	Verifica a regularidade do CPF.
O nome na execução (parâmetro/OCR) não condiz com o cadastro da Receita Federal.	Verifica se o nome encontrado na execução (parâmetro/OCR) é o mesmo da base de dados oficial.
A pessoa está em situação de óbito.	Verifica se o portador do CPF se encontra em situação de óbito.
Documento reprovado na perícia documental.	Verifica se a documentoscopia está disponível.
Documento reprovado na perícia documental.	Verifica se o documento foi aprovado na perícia documental.
Dados informados divergentes dos encontrados no documento.	Verifica a divergência entre informações coletadas e informadas manualmente.
Restrição identificada em análise de histórico de processos.	Verifica se o CPF/CNPJ está vinculado a processos.
Restrição identificada em análise de histórico de processos.	Verifica se o CPF/CNPJ está vinculado a processos como réu.
Restrição identificada em análise de histórico de processos.	Verifica se o CPF/CNPJ está vinculado a processos criminais.
Perfil não aderente à política de riscos regulatórios	Verifica se o portador do CPF possui exposição na mídia.
Portador do documento é menor de idade.	Verifica se o portador do CPF é maior de idade (18 anos).
Não foram encontrados dados do CPF informado.	Verifica se a fonte dados básicos está retornando valores.
Perfil não aderente à política de riscos regulatórios	Verifica se o portador do CPF ou CNPJ possui exposição política.
Não foi possível consultar o CPF na Receita Federal.	Verifica se foi possível consultar o CPF na Receita Federal.
Cliente reprovado por Facematch, idade estimada do portador do documento x Selfie capturada.	Verifica se a idade do portador do CPF corresponde com a idade estimada identificada na selfie.
Perfil não aderente à política de riscos regulatórios	Verifica se não foram encontradas sanções em listas restritivas.
Data de emissão do documento inválida.	Verifica se a data de emissão do documento é válida.
Número de CPF inválido, ilegível ou não informado.	Verifica se o número de CPF é válido.
CNPJ informado inválido.	Verifica se o número de CNPJ é válido.
Número de CNPJ inautêntico.	Verifica se o número de CNPJ é autêntico.
Número de RG inválido ou ilegível.	Verifica se o número do RG é válido.
CPF do portador informado divergente do QSA da empresa.	Verifica se o portador do CPF é representante legal da empresa.
Dados divergentes. Verifique se os documentos e os dados enviados são do mesmo CPF.	Verifica a divergência entre os dados do documento e informados manualmente.
Não recebemos uma documentação válida.	Verifica se possui documentação.
Os dados informados nos parâmetros diferem dos dados lidos no OCR.	Verifica se os dados informados nos parâmetros são iguais aos lidos pelo OCR.
Documento reprovado na perícia documental.	Verifica se o documento foi dado como autêntico na biometria e/ou documentoscopia. O que invalida a regra é reprovarmos o documento por ser inautêntico.
Foram encontradas divergências entre os dados da empresa e dos sócios informados.	Verifica se os dados PF condizem com os dados do quadro societário da empresa.
CPF do portador informado divergente do QSA da empresa.	Verifica se o QSA informado em attributes é igual ao obtido a partir da consulta ao Serasa.
O CPF não está regular na Receita Federal.	Verifica a regularidade do CPF.
A pessoa está em situação de óbito.	Verifica se o portador do CPF se encontra em situação de óbito.
O documento enviado é um passaporte.	Verifica se o documento enviado não é um passaporte.
CPF consta como pendente de regularização junto à Receita Federal.	Verifica se o CPF está com situação pendente de regularização.
CPF consta como nulo junto à Receita Federal.	Verifica se o CPF consta como nulo junto à Receita Federal.
CPF não encontrado na base de dados da Receita Federal.	Verifica se encontra o CPF na Receita Federal.
Data de validade da CNH inválida ou ilegível.	Verifica se a data de validade da CNH não está expirada.
CNPJ inativo ou baixado.	Verifica se o CNPJ está ativo na Receita Federal.
Número da CNH inválido.	Verifica se o número do registro da CNH é válido.
Órgão emissor do RG inválido ou ilegível.	Verifica se o órgão emissor do RG é válido.
UF do órgão emissor inválida ou ilegível.	Verifica se a UF do órgão emissor do documento é válida.
Dados divergentes ou inexistentes. Verifique se os documentos e os dados enviados são do mesmo CPF.	Verifica inexistência ou divergência entre os dados do documento e informados manualmente.
Documentação enviada inválida.	Verifica se possui documentação válida.
Empresa recém constituída	Verifica se o tempo de vida da empresa é maior que o mínimo exigido.
Inconformidade identificada nos sócios.	Verifica se possui PEPs ou sanções nos sócios de uma empresa.
Empresa recém constituída	Verifica se o tempo de vida de uma empresa de SC é maior que 6 meses.
Selfie enviada com baixa qualidade.	Verifica se foi retornado algum erro relacionado ao processamento da selfie.
Titular falecido.	Verifica se o CPF é de titular falecido.
CPF consta como cancelado junto à Receita Federal.	Verifica se o CPF consta como cancelado junto à Receita Federal.
CPF consta como suspenso junto à Receita Federal.	Verifica se o CPF consta como suspenso junto à Receita Federal.
Portador do documento está fora do intervalo de idade permitido.	Verifica se o portador do CPF possui idade dentro dos intervalos configurados.
A empresa consultada não possui sócios.	Verifica o quadro societário divulgado pela Receita Federal
Nome informado no parâmetro divergente dos dados encontrados em fontes oficiais.	Verifica a similaridade entre a união do primeiro e último nome enviado nos parâmetros em comparação com a união do primeiro nome e cada sobrenome da fonte.
Não identificamos a face da pessoa em bases de informações oficiais.	Verifica se foi possível validar a face da pessoa com base em informações oficiais.
Documento é uma carteira de trabalho.	Verifica se o documento não é uma carteira de trabalho.
Não identificamos a face da pessoa em bases de dados oficiais.	Verifica se foi possível encontrar a face da pessoa em bases de dados oficiais.
Pessoa não alfabetizada.	Verifica se a pessoa é alfabetizada.
Idade inferior a 16 anos.	Verifica se o portador do CPF possui idade superior a 16 anos.
O RG enviado não possui cpf.	Verifica se o RG possui um cpf.
Documento não aceito pela política de compliance.	Identifica se o documento não é do tipo outros.
O passaporte está fora da validade.	Verifica se o passaporte apresentado está dentro da validade.
O RG foi emitido a mais de 25 anos.	Verifica se o RG foi emitido a menos de 25 anos.
Identificamos ao menos um CNAE que não aceitamos.	A empresa possui ao menos um CNAE válido.
Transação não autorizada.	Motivo de rejeição para casos que forem testes mockados.
O documento foi emitido a mais de 10 anos.	Faz uma verificação se o documento enviado foi emitido há mais de 10 anos.
Natureza Legal divergente da informada.	Faz uma verificação se de fato a empresa informada é MEI/PJ.
Proposta reprovada por decurso de prazo, em razão da não apresentação da documentação necessária no período estipulado.	Proposta reprovada por decurso de prazo, em razão da não apresentação da documentação necessária no período estipulado.
Documento enviado não corresponde a um passaporte.	Verifica se o documento enviado é um passaporte.

Os motivos de reprovação não são fixos e podem surgir novos motivos ou alteração na descrição dos mesmos.

ClientCode e ProposalId

ClientCode é um identificador único por transação criado por você.
ProposalId é um identificador único que geramos após a criação da proposta, esse identificador será utilizado para realizar consultas.Recomendamos você guardar esses campos.

Consultar Propostas no Painel do Cliente

É possível consultar os status das Propostas no Painel do Cliente através da opção Consultar Onboarding.

Boas Práticas

Evite a criação de "polling" com períodos curtos nos Endpoints de consulta, o fluxo de onboarding é todo via webhook orientando sempre as alterações de status e em qual etapa do processo a proposta se encontra.

🚧

Fluxo sujeito a alinhamento interno com time Celcoin