Para a utilização das soluções de sub da Celcoin através do BaaS é necessário realizar o credenciamento das contas do seu ecossistema. Essa etapa é necessária para garantirmos que as empresas que utilizaram os serviços estão de acordo com todas as exigências regulatórias necessárias para oferecer produtos de Sub.

Nesse artigo você irá aprender sobre:

• Limitações e exceções
• Configurar um webhook para receber as informações do credenciamento da conta do BaaS na Sub
• Credenciar uma conta do BaaS para utilizar soluções da sub

Pré requisitos para implementação:

• Possuir uma chave api da Celcoin, para mais informações acessar esse 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.

Limitações e exceções:

Essa etapa apenas credencia as contas do BaaS a utilizar os produtos da Sub

Você deve se integrar a cada produto de acordo com o modelo de negócios

Configurando webhook

Para conseguir receber da Celcoin o resultado do pedido de credenciamento para utilização dos produtos da sub é necessário realizar a configuração de um webhook.

O webhook é uma forma de receber informações de forma assíncrona, geralmente são disparados gatilhos no formato JSON quando um evento acontece, na prática para a API de credenciamento será usado para receber informações, se sua conta do BaaS foi aprovada ou não para utilização da sub Celcoin.

A Celcoin possui um gerenciador de webhook, para configurar o produto de Emissão de Nota Fiscal, basta seguir os passos do artigo Cadastrar e Gerenciar Webhooks

Abaixo será exibido o modelo de retorno do webhook

Modelos de Retorno Webhooks

Conta BaaS Aprovada para utilização da Sub Celcoin

{
    "softDescriptor": "Tech Solutions",
    "cnae": "3250706",
    "documentNumber": "49798453000102",
    "account": 
"424085",
    "status": "ACCREDITED"
}

Conta BaaS Negada para utilização da Sub Celcoin

{
    "softDescriptor": "Tech Solutions",
    "cnae": "3250706",
    "documentNumber": "49798453000102",
    "account": 
"424085",
    "status": "FAILED",
    "error": {
        "code": "CBE-CDC-001",
        "message": "CNAE inválido"
    }
}

Solicitar Credenciamento de uma Conta BaaS na Sub Celcoin

Para solicitar o credenciamento das contas BaaS na Sub Celcoin é necessário realizar uma chamada na api Credenciar Sub utilizando o método POST, onde precisa ser preenchido algumas informações necessárias para realizarmos as validações. Os dados necessários estão no quadro "Parâmetros do Body"

Modelo de requisição:

curl --location --request POST 'https://sandbox.openfinance.celcoin.dev/baas/v1/cash/424085/accreditation' \
--header 'accept: application/json' \
--header 'Authorization: Bearer acess_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "softDescriptor": "Tech Solutions",
    "cnae": "3250706",
    "documentNumber": "49798453000102"
}
'

Parâmetros do Body:

Modelo de retorno:

{
    "status": "PENDING",
    "account": "424085",
    "message": "Credenciamento solicitado com sucesso"
  }

Note que essa api é síncrona, sendo assim, a Celcoin irá retornar para você o resultado final da solicitação de cadastro da empresa.

Tabela descritiva dos campos retornados

📘

Você receberá o resultado da solicitação de credenciamento da sua conta BaaS no webhook cadastrado na etapa anterior.