Integração Santander

Instruções de integração para emissão de boletos/chaves PIX de pagamento único.

Última atualização Há 23 dias


Início

Coletando as informações necessárias

O primeiro passo para iniciar a homologação da conta Santander no CobCloud é entrar em contato com o gerente da conta e informar que será realizada a homologação para emissão de boletos por meio de uma plataforma de terceiros.

Caso também deseje utilizar emissão de PIX integrado, informe ao gerente que a homologação deverá incluir a funcionalidade de PIX, sendo essa etapa opcional.

No CobCloud, acesse o módulo Cadastros > Tabelas Financeiro > Contas Bancárias e clique em “Cadastrar” para iniciar o cadastro da conta bancária que será homologada.

Na aba ‘Dados da conta’, preencha os campos:

  • Descrição. (Esta informação é usada para identificar a conta no CRM.)

  • Selecione o Banco.

  • Agência e dígito.

  • Conta e dígito.

  • Tipo de conta.

  • Chave PIX. (caso deseje habilitar a emissão de chave PIX de pagamento único)

  • Proprietário. (Este campo define o local de pagamento ao puxar retorno bancário ou lançamentos manuais que entrarem nesta conta.)

Na aba ‘Boleto Bancário’ marque a opção ‘Ativar emissão de boleto bancário’ e preencha:

  • Favorecido.

  • CNPJ.

  • Endereço. (endereço, bairro, cidade, UF e CEP)

  • Código do beneficiário e dígito.

  • Carteira e Convênio.

  • Percentual (% juros mês e % Multa) de juros e multa em caso de pagamento de boletos atrasados. (caso no banco o boleto esteja configurado para cancelar após vencido, ignore esta opção.)


Informações que o cliente precisa disponibilizar ao suporte técnico do CobCloud:

  • Client_ID.

  • Secret_ID.

  • Certificado digital e CNPJ (enviar no atendimento@cobcloud.com.br).

  • Enviar o PFX com senha ou o PEM completo.

  • Se for usar Pix, precisa da Chave Dinâmica.


    Como criar chave Dinâmica:
    Santander Empresas ou Internet Banking. Acesse Pix > Minhas chaves > Cadastrar chave > Escolha Chave Aleatória e confirme com o dispositivo de segurança. Essa chave é segura, protegendo dados empresariais.

    Para conseguir client_id e secret_id é necessário criar uma conta como admin no https://developer.santander.com.br/ , dentro do portal terão duas opções:

    - Mandar um convite para nós como desenvolvedor.
    - Ajudar cliente via Anydesk.

    Preferencialmente usem a opção de nos enviar um convite, assim conseguimos realizar ajustes e/ou atualização de certificados por aqui.

    Criando a aplicação:

    É necessário buscar a empresa para conseguir criar a aplicação.

     

    Assim que encontrar e continuar, vai aparecer uma tela de produto. Nela, selecione as opções EMISSÃO DE BOLETOS e PIX - GERAÇÃO DE QR CODE



    Regras para envio de certificado digital:

    • Precisa ser nos formatos: .PEM, .CER ou .CRT;

    • É aceito certificado do tipo A1;

    • Os arquivos devem possuir a cadeia completa, contendo: root, intermediário e folha;

    • O tamanho deve ser de 2048 bits;

    • Deve ter a validade mínima de 30 dias;

    • O certificado deve possuir o atributo "Key Usage" habilitado para "Digital signature" ou "Key agreement", e o "Enhanced Key Usage" contendo a extensão "TLS Web Client Authentication (1.3.6.1.5.5.7.3.2)".

    Depois de enviar o certificado é finalizada a criação do app.
    Pode demorar um tempo para ser autorizado, de preferência informar e solicitar ao gerente de contas que seja feita a autorização.