rogo/sicoob-php-sdk

Library to facilitate integration with the Sicoob bank API with PHP

1.0 2023-11-16 21:22 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.8

Requires (Dev)

• phpunit/phpunit: ^10

MIT

• Logics Softwares

README

Biblioteca para facilitar a integração com a API do banco Sicoob utilizando PHP.

Funcionalidades

• Integração com a API de Cobrança Bancária

Documentação

Documentação

Instalando o SDK

Caso ainda não possua o Composer instalado, siga as instruções em getcomposer.org.

Se já possui um arquivo composer.json, basta executar diretamente em seu terminal:

composer require rogo/sicoob-php-sdk

Exemplos de uso

Incluir Boleto:

<?php
require 'vendor/autoload.php';

// Criando instância de Authenticator que fará o controle de autenticação
$authenticator = new Authenticator(
    '9b5e603e428cc477a2841e2683c92d21', //clientId
    'certificate', //path_to_certificate
    'certificate_key', //path_to_certificate_key
    true //isSandbox
)

// Criando instância de CobrancaBancaria para utilizar todos os métodos do módulo de cobrança bancária
new CobrancaBancaria(
    $authenticator
    25546454 //numeroContrato
);

// Criando instância de Pagador
$pagador = new Pagador();
$pagador
    ->setNumeroCpfCnpj('12345678910')
    ->setNome('Joao Da Silva')
    ->setEndereco('Rua 9, QD 1 LT 1')
    ->setBairro('Centro')
    ->setCidade('Morrinhos')
    ->setCep('75650000')
    ->setUf('GO')
    ->setEmail(['[e-mail]']);

// Criando instância de Boleto
$boleto = new Boleto();
$boleto
    ->setNumeroContaCorrente(0)
    ->setEspecieDocumento(EspecieDocumento::FATURA)
    ->setSeuNumero('123457')
    ->setIdentificacaoEmissaoBoleto(IdentificacaoEmissaoBoleto::BANCO_EMITE)
    ->setIdentificacaoDistribuicaoBoleto(IdentificacaoDistribuicaoBoleto::BANCO_DISTRIBUI)
    ->setValor(100.00)
    ->setDataVencimento((new DateTime('2021-12-10'))->setTime(0, 0)->format('Y-m-d\TH:i:sP'))
    ->setDataEmissao((new DateTime('now'))->setTime(0, 0)->format('Y-m-d\TH:i:sP'))
    ->setPagador($pagador);

// Incluindo boleto
$response = $this->cobrancaBancaria->incluirBoleto($boleto);

// Acessando informações do boleto
$nossoNumero = $response->getNossoNumero();

Rodando os testes

Para rodar os testes, rode o seguinte comando

  composer install
  ./vendor/bin/phpunit src/tests

Licença

MIT