idealizetecnologia / itaubankline
与 Itau Bankline 集成模块,用于发票开具
2.1.1
2022-12-02 18:05 UTC
Requires
- php: >=8.0
- nategood/httpful: ^0.3.2
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