idealizetecnologia/itaubankline

与 Itau Bankline 集成模块,用于发票开具

2.1.1 2022-12-02 18:05 UTC

This package is auto-updated.

Last update: 2024-08-30 01:08:03 UTC


README

基于 Java 开发的 ItauCripto 类的 PHP 版本,最初由 gabrielrcouto/php-itaucripto 编写。

我们在同一个库中实现了 Itau Bankline 的交易生成和查询的 Webservice 调用。

我们的库最初是为了使用银行汇票而开发的,但没有任何阻碍使用其他支付方式。

如果您想为其他支付方式做出贡献,我们也非常欢迎。

由于 Java 中的 ItauCripto 类被反编译,一些名称变成了通用名称(例如:$paramString1、$paramString2)。

安装

composer require idealizetecnologia/itaubankline

如何使用库中的 Webservice

要为客户生成支付 URL,请使用以下代码

	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 = "Fulano da Silva";
		  $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());
		}

要查询 Itau Bankline 并返回交易状态,请使用以下代码

	$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());
	}

字段

  $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

许可证

MIT 许可证