dilneiss/itaubankline

Modulo de integracao com o Itau Bankline para emissao de boletos

Maintainers

👁 dilneiss

Package info

github.com/dilneiss/itaubankline

pkg:composer/dilneiss/itaubankline

Statistics

Installs: 7 491

Dependents: 6

Suggesters: 0

Stars: 8

Open Issues: 1

2.0.2 2016-12-20 13:32 UTC

Requires

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 96604885f4fed2f0193c813a05d884f26c2a77b6

  • Dilnei Soethe Spancerski <dilnei.soethe.woop@gmail.com>

phpcomposerBankitaúbanklinecripto

This package is auto-updated.

Last update: 2026-06-07 13:31:46 UTC


README

Versão em PHP com a classe ItauCripto, originalmente escrita em Java baseado em gabrielrcouto/php-itaucripto.

Implementamos na mesma biblioteca as chamadas Webservice para geração de transação no Itau Bankline e também consultas.

Nossa biblioteca foi desenvolvida inicialmente para utilizar apenas o Boleto bancário, mas nada impede de usar as outras formas de pagamento.

Caso queira contribuir com as outras formas de pagamento, será muito bem vindo também.

Como a classe ItauCripto em Java foi descompilada, alguns nomes se tornaram nomes genéricos (ex: $paramString1, $paramString2).

Instalação

composer require dilneiss/itaubankline

Como usar o Webservice utilizando a própria Biblioteca

Para gerar uma url para o cliente efetuar o pagamento, utilize o seguinte código

	try {
			
		 //Coloque o código da empresa em MAIÚSCULO
		 $codEmp = "J1234567890123456789012345";
		 //Coloque a chave de criptografia em MAIÚSCULO
		 $chave = "ABCD123456ABCD12";
		 
		 //Preencha as variáveis abaixo com os dados do cliente e da cobrança
		 //Abaixo é só um exemplo!
		 $pedido = "1234";
		 $valor = "150,00";
		 $observacao = 1;
		 $nomeSacado = "Dilnei Soethe Spancerski";
		 $codigoInscricao = "";
		 $numeroInscricao = "";
		 $enderecoSacado = "";
		 $bairroSacado = "";
		 $cepSacado = "";
		 $cidadeSacado = "";
		 $estadoSacado = "";
		 $dataVencimento = "";
		 $urlRetorna = "";
		 $obsAd1 = "Observações linha 1";
		 $obsAd2 = "Observações linha 2";
		 $obsAd3 = "Observações linha 3";
		 
		 $itauCripto = new ItauCripto();
		 
		 $dados_criptografados = $itauCripto->geraDados($codEmp,$pedido,$valor,$observacao,$chave,$nomeSacado,$codigoInscricao,
		 													$numeroInscricao,$enderecoSacado,$bairroSacado,$cepSacado,$cidadeSacado,$estadoSacado,
													 $dataVencimento,$urlRetorna,$obsAd1,$obsAd2,$obsAd3);
													 
		 $itauService = new ItauBanklineService();
		 
		 $urlBoleto = $itauService->generateUrlBoletoItauBankline($dados_criptografados); //Utilize essa url para ir direto ao boleto bancário
		 
		 $urlItauBankline = $itauService->generateUrlBoletoItauBankline($dados_criptografados); //Utilize essa url para ir a tela do Itau Bankline e o cliente escolher a forma de pagamento
		 
		 //Aqui faça seu redirecionamento para a url gerada conforme desejado
			
		} catch (Exception $e) {
			exit($e->getMessage());
		}

Para efetuar uma consulta no Itau Bankline e retornar o status da transação, utilize o seguinte código

	$metodoResultado = 1; //0 Para exibir a consulta em html legível e 1 para exibir a consulta em xml
	
	$itauCripto = new ItauCripto();
	$dadosCriptografados = $itauCripto->geraConsulta($codEmp , $pedido , $metodoResultado , $chave);
		
	try {
	
		$itauService = new ItauBanklineService();
		
		$transacao = $itauService->consultaTransacao($dadosCriptografados);
		
		var_dump($transacao);
		
	} catch (Exception $e) {
		exit($e->getMessage());
	}

Campos

 $pedido // Identificação do pedido - máximo de 8 dígitos (12345678) - Obrigatório 
 $valor // Valor do pedido - máximo de 8 dígitos + vírgula + 2 dígitos - 99999999,99 - Obrigatório 
 $observacao // Observações - máximo de 40 caracteres 
 $nomeSacado // Nome do sacado - máximo de 30 caracteres 
 $codigoInscricao // Código de Inscrição: 01->CPF, 02->CNPJ 
 $numeroInscricao // Número de Inscrição: CPF ou CNPJ - até 14 caracteres 
 $enderecoSacado // Endereco do Sacado - máximo de 40 caracteres 
 $bairroSacado // Bairro do Sacado - máximo de 15 caracteres 
 $cepSacado // Cep do Sacado - máximo de 8 dígitos 
 $cidadeSacado // Cidade do sacado - máximo 15 caracteres 
 $estadoSacado // Estado do Sacado - 2 caracteres 
 $dataVencimento // Vencimento do título - 8 dígitos - ddmmaaaa 
 $urlRetorna // URL do retorno - máximo de 60 caracteres 
 $obsAdicional1 // ObsAdicional1 - máximo de 60 caracteres 
 $obsAdicional2 // ObsAdicional2 - máximo de 60 caracteres 
 $obsAdicional3 // ObsAdicional3 - máximo de 60 caracteres

Author

@dilneiss88

Licença

MIT License