Configuração do PIX Itaú – Celcoin

Para iniciar a configuração é necessário primeiro obter junto ao banco Itaú:

client_id
client_secret
certificado dinâmico (arquivos .csr e .key)
chave PIX

A geração do certificado dinâmico exige conhecimentos técnicos como: execução do aplicativo "openssl" em linha de comando e chamadas de API via ferramentas como o "POSTMAN".

Recomendamos contar com o apoio do banco e de um pessoal técnico para executar os passos que o banco orientar.

De posse dessas informações é necessário gerar o arquivo .pfx ( novamente com o apoio de pessoal técnico).

Para facilitar os cadastros necessários no CobranSaas compilamos uma lista de conteúdos para serem copiados e colados. Esperamos evitar erros de digitação e acelerar o processo de cadastro:

grant_type
client_credentials
client_id
client_secret
Content-Type
application/x-www-form-urlencoded
access_token
expires_in
Bearer
https://sts.itau.com.br/api/oauth/token

Os passos que devem ser realizados nas telas de cadastro do CobranSaaS são:

Cadastro de uma INTEGRAÇÃO do tipo OAUTH
Cadastro de uma INTEGRAÇÃO do tipo API (associar a OAUTH)
Cadastro de um MEIO DE PAGAMENTO (associar a integração API)
Alterar um PLANO (associar o MEIO DE PAGAMENTO

Segue o detalhamento destes passos:

1. Cadastrar uma INTEGRAÇÃO do tipo OAUTH.

Esta integração serve para passar as credenciais (cliente_id, client_secret e certificado) para o banco e validar o acesso. Ao final a API do banco retorna o token que será usado na próxima integração que é a integração de cadastro do PIX.

Nesta primeira parte é válido ressaltar que o arquivo .pfx ( marcado em azul ) deve ser adicionado clicando no ícone ( marcado em amarelo). E a senha do arquivo .pfx deve ser incluída clicando no cadeado (marcado em vermelho). O campo nome pode ser preenchido como preferir e os demais campos devem ser preenchidos exatamente como estão na imagem:

Nesta segunda parte chamada de Lista do Formulário precisamos dos três campos abaixo.

As informações de Valor dos campos client_id e client_secret são fornecidas pelo banco Itau.

A última parte da tela deve ser preenchida como segue:

2. Cadastrar a INTEGRAÇÃO do tipo API

Essa integração é a que efetivamente registra um PIX junto ao banco. Ela usa a integração anterior para obter o "token". Além disso é necessário fazer o upload do certificado novamente pois o banco exige que o mesmo seja passado nesta integração também.

Utilidades (copia e cola):