Cadastro Simplificado

O conjunto de endpoints a seguir são destinados a lidar com o Cadastro de uma conta simplificada

Solicitar abertura de conta simplificada

Neste passo, você pode solicitar a abertura de uma conta simplificada para integração. Basta fornecer os dados do cliente final. Se os dados estiverem corretos, o cliente receberá um link para autorizar a integração à sua conta Efí.

Criação de conta/aplicação

Se o cliente final já tiver uma conta na Efí, ele terá duas opções:

• Criar uma aplicação na conta atual, onde você terá acesso às credenciais e poderá definir os escopos, com excessão dos escopos pix.send, gn.pix.send.read, gn.qrcodes.pay, gn.qrcodes.read, gn.barcode.read, gn.barcode.pay.write e gn.barcode.pay.read;
• Criar uma conta secundária para o cliente final com as configurações/acessos definidos em sua requisição.

Negação da abertura de conta

Caso o seu cliente recuse o processo de abertura de conta, será necessário esperar 2 dias corridos até iniciar um novo processo.

Modalidade das contas

Se a conta gerada para o cliente for pessoa física, sem CNPJ vinculado, ela será alocada na modalidade Efí Pro. Em casos em que a conta criada tem um CNPJ vinculado, ela será automaticamente classificada como Efí empresas.

POST /v1/conta-simplificada

Requer autorização para o escopo: gn.registration.write

Requisição

Cliente final pessoa física

{
  "clienteFinal": {
    "cpf": "12345678900",
    "nomeCompleto": "Nome Exemplo",
    "dataNascimento": "13/08/2000",
    "nomeMae": "Exemplo de nome da mãe",
    "celular": "31987654321",
    "email": "[email protected]",
    "endereco": {
      "cep": "35400000",
      "estado": "MG",
      "cidade": "Ouro Preto",
      "bairro": "Bairro exemplo",
      "logradouro": "Exemplo do nome da rua",
      "numero": "777",
      "complemento": "apto 101"
    }
  },
  "meioDeNotificacao": [
    "sms",
    "whatsapp"
  ],
  "escoposIntegrados": [
    "cob.write",
    "cob.read",
    "pix.write",
    "pix.read",
    "webhook.write",
    "webhook.read",
    "payloadlocation.write",
    "payloadlocation.read",
    "gn.pix.send.read",
    "gn.pix.evp.write",
    "gn.pix.evp.read",
    "gn.balance.read",
    "gn.settings.write",
    "gn.settings.read"
  ],
  "cupom": "NOVOCUPOM123"
}

Cliente final pessoa jurídica

{
  "clienteFinal": {
    "cpf": "12345678900",
    "nomeCompleto": "Nome Exemplo",
    "dataNascimento": "13/08/2000",
    "nomeMae": "Exemplo de nome da mãe",
    "celular": "31987654321",
    "email": "[email protected]",
    "cnpj": "12345678901000",
    "razaoSocial": "Ongan Comércio LTDA",
    "endereco": {
      "cep": "35400000",
      "estado": "MG",
      "cidade": "Ouro Preto",
      "bairro": "Bairro exemplo",
      "logradouro": "Exemplo do nome da rua",
      "numero": "777",
      "complemento": "apto 101"
    }
  },
  "meioDeNotificacao": [
    "whatsapp"
 ],
  "escoposIntegrados": [
    "cob.write",
    "cob.read",
    "pix.write",
    "pix.read",
    "webhook.write",
    "webhook.read",
    "payloadlocation.write",
    "payloadlocation.read",
    "gn.pix.send.read",
    "gn.pix.evp.write",
    "gn.pix.evp.read",
    "gn.balance.read",
    "gn.settings.write",
    "gn.settings.read"
  ],
  "cupom": "NOVOCUPOM123"
}

Respostas

As respostas abaixo representam Sucesso(200) e Falhas/erros do consumo.

🟢 200

{
  "contaSimplificada": {
    "identificador": "92ccd29b-54c9-49fc-b8e8-717a3b373c5e"
  }
}

🔴 400

CPF inválido
{
  "nome": "cpf_invalido",
  "mensagem": "Este CPF se encontra restrito na Efí."
}

Ou

Nome completo inválido
{
  "nome": "nome_completo_invalido",
  "mensagem": "O nome completo não corresponde ao CPF do cliente final."
}

Ou

Menoridade

{
  "nome": "menoridade",
  "mensagem": "O cliente final é menor de idade."
}

Ou

Data de nascimento inválida
{
  "nome": "data_nascimento_invalida",
  "mensagem": "A data de nascimento não corresponde ao CPF do cliente final."
}

Ou

Nome da mãe inválido
{
  "nome": "nome_mae_invalido",
  "mensagem": "O nome da mãe não corresponde ao CPF do cliente final."
}

Ou

Celular inválido
{
  "nome": "celular_invalido",
  "mensagem": "O celular é inválido."
}

Ou

Celular não similar
{
  "nome": "celular_nao_similar",
  "mensagem": "O Celular informado não corresponde ao Celular cadastrado na Conta Efí."
}

Ou

Email inválido
{
  "nome": "email_invalido",
  "mensagem": "O email é inválido."
}

Ou

CEP inválido
{
  "nome": "cep_invalido",
  "mensagem": "O CEP é inválido."
}

Ou

CNPJ inválido
{
  "nome": "cnpj_invalido",
  "mensagem": "O CNPJ é inválido."
}

Ou

Razão social inválida
{
  "nome": "razao_social_invalida",
  "mensagem": "A razão social não corresponde ao CNPJ do cliente final."
}

Ou

Nome completo inválido
{
  "nome": "nomeCompleto_invalido",
  "mensagem": "ClienteFinal deve ter a propriedade obrigatória nomeCompleto."
}

Ou

CPF inativo
{
  "nome": "cpf_inativo",
  "mensagem": "O CPF está em situação cadastral inativa."
}

Ou

CNPJ inativo
{
  "nome": "cnpj_inativo",
  "mensagem": "O CNPJ está em situação cadastral inativa."
}

🔴 401

Este erro ocorre nas seguintes situações:

* Certificado ou credenciais não existem;
* Certificado ou credenciais estão desativados;
* Certificado e credenciais não estão vinculados a mesma conta Efí
* Integrador não tem permissão para o escopo de serviço necessário para consumir este endpoint.

🔴 403

{
  "nome": "escopo_invalido",
  "mensagem": "Não é possível solicitar escopos não configurados na aplicação do integrador."
}

🔴 405

{
"nome": "cpf_protegido_no_protege_+",
"mensagem": "O CPF do cliente final está protegido no Protege +."
}

{
"nome": "cnpj_protegido_no_protege_+",
"mensagem": "O CNPJ do cliente final está protegido no Protege +."
}

{
"nome": "cpf_cnpj_protegido_no_protege_+",
"mensagem": "O CPF e o CNPJ do cliente final estão protegidos no Protege +."
}

{
"nome": "indisponibilidade_protege_+",
"mensagem": "Não foi possível concluir a consulta ao sistema do Banco Central devido à instabilidade temporária ou lentidão. Tente novamente mais tarde."
}

🔴 409

Celular cadastrado
{
  "nome": "celular_cadastrado",
  "mensagem": "O celular é utilizado por outro cliente."
}

Ou

Email cadastrado

{
  "nome": "email_cadastrado",
  "mensagem": "O email é utilizado por outro cliente."
}

Ou

Solicitação duplicada
{
  "nome": "solicitacao_duplicada",
  "mensagem": "Já existe uma solicitação de abertura de conta aberta para este cliente final."
}

🔴 412

Precondition Failed. Este erro ocorre nas seguintes situações:

* Integrador deve ter pelo menos um Webhook cadastrado.
{
  "nome": "webhook_nao_cadastrado",
  "mensagem": "Sua conta não possui webhook cadastrado na API de Cadastro."
}

🔴 500

Erro na aplicação

{
  "nome": "erro_aplicacao",
  "mensagem": "Ocorreu um erro na aplicação."
}

Ou

{
  "nome": "cpf_restrito",
  "mensagem": "Este CPF se encontra restrito na Efí."
}

Ou

{
  "nome": "cpf_nao_permitido",
  "mensagem": "Este CPF se encontra bloqueado pela Efí."
}

Ou

{
  "nome": "cnpj_nao_permitido",
  "mensagem": "Este CNPJ se encontra bloqueado pela Efí."
}

Recuperar credenciais de uma conta simplificada

Recupera as credenciais Client_Id e Client_Secret para integrar à uma conta simplificada.

GET /v1/conta-simplificada/:idContaSimplificada/credenciais

Requer autorização para o escopo: gn.registration.read

Respostas

As respostas abaixo representam Sucesso(200) e Falhas/erros do consumo.

🟢 200

{
"clientId": "92ccd29b-54c9-49fc-b8e8-717a3b373c5e",
"clientSecret": "b2e9dcca-c46d-4b9b-89d2-c625949bea40",
"conta": {
  "numero": "10000",
  "digito": "1",
  "payeeCode": "6edo0034843gfr5trtPtgt343"
},
"escopos": [
  "cob.write",
  "webhook.read"
],
"ativo": true
}

🔴 401

Este erro ocorre nas seguintes situações:

* Certificado ou credenciais não existem;
* Certificado ou credenciais estão desativados;
* Certificado e credenciais não estão vinculados a mesma conta Efí
* Integrador não tem permissão para o escopo de serviço necessário para consumir este endpoint.

🔴 404

{
  "nome": "conta_nao_encontrada",
  "mensagem": "Conta simplificada não encontrada."
}

🔴 412

{
  "nome": "conta_nao_aprovada_ou_recusada",
  "mensagem": "O cliente final não aprovou ou recusou a conta simplificada."
}

OU

{
  "nome": "conta_em_processamento",
  "mensagem": "A Efí está processando a conta simplificada."
}

🔴 500

{
  "nome": "erro_aplicacao",
  "mensagem": "Ocorreu um erro na aplicação."
}

Criar certificado de uma conta simplificada

Cria o certificado para integrar à uma conta simplificada.

Conversão da String Base64 para .p12

O output retornado por este endpoint está codificado em base64. O integrador deverá converter a string para um buffer e, em seguida, salvar o conteúdo em um arquivo no formato .p12.

POST /v1/conta-simplificada/:idContaSimplificada/certificado

Requer autorização para o escopo: gn.registration.read

Respostas

As respostas abaixo representam Sucesso(201) e Falhas/erros do consumo.

🟢 201

"MIIKYQIBAzCCCicGCSqGSIb3DQEHAaCCChgEggoUMIIKEDCCBMcGCSqGSIb3DQEHAaCCBLgEggS0MIIEsDCCBKwGCyqGSIb3DQEMCgEDoIIEdDCCBHAGCiqGSIb3DQEJFgGgggRgBIIEXDCCBFgwggJAoAMCAQICEJ4WQNAm+z3pWRYsltA2KeAwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNVBAYTAkJSMRUwEwYDVQQIDAxNaW5hcyBHZXJhaXMxLDAqBgNVBAoMI0VmaSBTLkEuIC0gSW5zdGl0dWljYW8gZGUgUGFnYW1lbnRvMRcwFQYDVQQLDA5JbmZyYWVzdHJ1dHVyYTEgMB4GA1UEAwwXYXBpcy50ZXN0ZWVmaXBheS5jb20uYnIxIzAhBgkqhkiG9w0BCQEWFGluZnJhQHNlamFlZmkuY29tLmJyMB4XDTIzMDkxMjEzNTE1N1oXDTI2MDkxMjEzNTE1N1owHTEOMAwGA1UEAxMFMzA4MjYxCzAJBgNVBAYTAkJSMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvFqf7tNldp0nTEZyxDRTpINayIbD7SIsVuwKgJTFkgzKzSo/CcFGHlamRGWxxpqKoiFZ/dToxD5YQyKpLW+AHSwCMIpRlqyipsr67dXEiVimulpvvmCRpJcnC8MQLWvBOIuomh4Ig3185BxBLwIR79TV1hO7SzeDUvWBZBXbFnadEkXhHuFQV0lwsrFaY2/4K/c3bFkYiWVf3DHYuNeu7fZWXm1kAI6Bx5Tks5oBlVQl2za7X0LnTtoFgZI6/xS0MGbSosW7wk11uqJFSepmo/0HmAZCPlOX4zLz4y1Fs8uKRJpK2kFvP6IN23I5dDSP7yIbCiTayA..."

🔴 401

Este erro ocorre nas seguintes situações:

* Certificado ou credenciais não existem;
* Certificado ou credenciais estão desativados;
* Certificado e credenciais não estão vinculados a mesma conta Efí
* Integrador não tem permissão para o escopo de serviço necessário para consumir este endpoint.

🔴 403

{
  "nome": "quantidade_limite_de_certificados",
  "mensagem": "A conta atingiu a quantidade máxima de certificados."
}

🔴 404

{
  "nome": "conta_nao_encontrada",
  "mensagem": "Conta simplificada não encontrada."
}

🔴 412

{
  "nome": "conta_nao_aprovada_ou_recusada",
  "mensagem": "O cliente final não aprovou ou recusou a conta simplificada."
}

OU

{
  "nome": "conta_em_processamento",
  "mensagem": "A Efí está processando a conta simplificada."
}

🔴 500

Erro na aplicação
{
  "nome": "erro_aplicacao",
  "mensagem": "Ocorreu um erro na aplicação."
}

Exemplo de conversão Base64 para .p12

O exemplo de código abaixo mostra como converter a string Base64 retornada pelo endpoint em um arquivo .p12.

Node

const fs = require('fs');

var b64string = "";
var buf = Buffer.from(b64string, 'base64');

fs.writeFile('arquivo.p12', buf, (err) => {
  if (err) throw err;
console.log('O arquivo foi criado!');
})