Neste manual vamos demonstrar como homologar a cobrança através do Sicoob no sistema Quaza.
1º - O provedor dever ter os seguintes dados bancários para pré-configurar a carteira:
Razão Social:
CNPJ:
Nº do contrato (código do cliente/cedente):
Carteira:
Nº da conta e dígito:
Nº da agência e dígito:
Nº do convênio e dígito:
Certificado A1 e senha:
Caso tenha dúvidas sobre como criar ou configurar a carteira, acesse a nossa documentação Explicação da tela Carteira de Cobrança.
2º - Colar na área de trabalho o arquivo do certificado A1>abrir>usuário atual> avançar>senha>marcar a primeira opção "selecionar automaticamente o repositório de certificados conforme o tipo de certificado">avançar>concluir. Após o documento aparecer na pasta, renomear o arquivo com o título "cert" >colocar dentro da pasta certificado que se encontra no disco local, caso esta pasta não exista, deve ser criada;
3º - Converter o arquivo do certificado A1 para .pem e alterar o nome da pasta privada para "certID.pem" onde ID é o número da carteira modelo (Por exemplo, se a configuração de cobrança tiver o ID 6, vai ser cert6.pem). Segue imagem indicando como conferir o id:
4º. Segue passo a passo de como coverter para .pem:
Fazer tudo pelo Prompt de Comando com os seguintes comando abaixo:
Sicoob precisa o certificado sem a chave privada (arquivo público.pem):
openssl pkcs12 -in C:\Certificado\cert.pfx -nokeys -out C:\Certificado\CertificadoPublico.pem
Colocar no sistema Quaza com a chave privada (arquivo certID.pem):
openssl pkcs12 -in C:\Certificado\cert.pfx -out C:\Certificado\certificado.pem -nodes
5º. Enviar o arquivo certID.pem para o suporte da Quaza incluí-lo no servidor.
O suporte irá fazer o seguinte: Acessar WinSCP > novo site > preencher com os dados do provedor que podem ser acessados no Backuper-cliente-ssh > protocolo de arquivo=scp > host=ip > porta > usuário > senha (inspecionar para visualizar)
Colocar o certificado certID.pem na pasta var/www/html/quaza/media/certs ou então conferir o que consta lá no Backuper SSH Projeto (a parta certs tem que ser criada. Ex: clicar com o botão direito do mouse > novo > diretório > nomear a pasta como "certs" > ok > colar)
6º. Acesse o site https://developers.sicoob.com.br/portal/
> clique em cadastro > preencher (no campo conte-nos um pouco... colocar "somos um provedor") em seguida terá que fazer o login com e-mail cadastrado anteriormente (a senha deve ser definida pelo e-mail que será recebido).
7º. Após fazer login, abrirá a tela abaixo:
Acesse o menu Meus Aplicativos e preencha as informações:
Depois, clique em Prosseguir e abrirá a seguinte tela:
No parâmetro "A integração será por uma empresa parceira?", marque como Sim.
Em "Empresa Parceira" selecione a opção Quaza Tecnologia.
Na próxima etapa, selecione a modalidade "Cobrança Bancária V3" e depois clique em Prosseguir:
6 Confirme se os seus dados estão corretos e clique em "Criar aplicativo":
7 Criada a aplicação com sucesso, agora clique em "Ver aplicativos":
8 Em seguida, clique na sua aplicação para exibir os detalhes dela.
9 Copie o código Client ID que foi gerado:
8º. Ativação da aplicação:
Após a conclusão do processo de criação da Credencial de API, o aplicativo estará disponível no menu Meus Aplicativos com o status de Pendente.
Para ativar os aplicativos CNPJ, será necessário que os responsáveis pela conta autorizem no Sicoobnet Empresarial.
Basta acessar o ícone de pesquisa, procure por Transações Pendentes / Detalhamento e, em seguida, por Autorização para Uso de APIs Insira sua senha e autorize.
O aplicativo será atualizado para o status Ativo, e as credenciais estarão prontas para uso.
9º. Na carteira pré-configurada colar a chave principal que foi obtida através do SICOOB, e adicionar a chave secreta que é a senha do certificado A1:
10º. É necessário que o provedor solicite ao seu gerente do SICOOB uma chave PIX aleatória e a autorize, ou o próprio provedor pode fazer a geração, e autorizar no APP. Esta chave não precisa ser adicionada ao sistema.
11º. Etapa final - Testes:
- Testar Gateway na carteira, para confirmar que está comunicando (Retorno Conectado com Sucesso);
- Testar criação de boleto e baixa, criar boleto teste, o provedor deve pagar e depois conferir se baixou o boleto no sistema e se o valor consta na conta.
ATENÇÃO:
Os valores de tarifas (registro e baixa) são estipulados pela plataforma de pagamento (Gateway), e o provedor deve estar ciente das tarifas cobradas. Bem como, ciente de que o valor do boleto (tarifa) quando é pago por pix pode ser diferente do pago por código de barras;
Em caso de dúvidas ou problemas, não hesite em contatar nosso suporte. Estamos aqui para ajudar!
Agradecemos por utilizar nossa documentação!