elemke/sicoob-pix

Biblioteca integração Pix Sicoob

v2.1.0 2023-08-09 13:35 UTC

Requires

• php: >=7.2.5
• ext-json: *
• guzzlehttp/guzzle: ^7.0
• vlucas/phpdotenv: ^5.3

MIT

• Éder Lemke

README

Esse pacote oferece integração com a API PIX do sistema Sicoob, conforme documentação do Banco Central do Brasil.

Observação

Os endpoints disponibilizados por este pacote seguem a padronização do Banco Central: Link Documentação. Entretanto, o provedor de serviços de pagamento (PSP) pode não implementar todos eles.

Instalação

composer require elemke/sicoob-pix

Configurações Iniciais

Configure as variáveis do pacote no seu arquivo .env (caso ele não exista, crie na pasta raiz do seu projeto)

SICOOBPIX_CLIENT_ID='xxxxx'
SICOOBPIX_CAMINHO_CERT_PUBLICO='./path/file.pem'
SICOOBPIX_SENHA_CERT_PUBLICO='xxx'
SICOOBPIX_CAMINHO_CERT_PRIVADO='./path/file.key'
SICOOBPIX_SENHA_CERT_PRIVADO='xxx'

Caso tenha dúvidas de como obter esses dados, consulte o site do Sicoob Developers através do link: https://developers.sicoob.com.br

Exemplos de Uso

Criar cobrança imediata

$scope = ['cob.read', 'cob.write']; //Veja a lista completa na documentação do Banco Central
$psp = new Psp($scope);

$cobranca = [
    'calendario' => [
        'expiracao' => 3600
    ],
    'devedor' => [
        'cpf' => '12345678911',
        'nome' => 'Fulano'
    ],
    'valor' => [
        'original' => '1.00'
    ],
    'chave' => '[e-mail]',
    'solicitacaoPagador' => 'mensagem pagador'
];

$cob = new Cob($psp);
$cob->criar($cobranca); //Como segundo parâmetro é possível informar o txId, caso contrário será gerado automaticamente pelo PSP

Consultar cobrança imediata

$cob->consultar('xxxx'); // Para consultar cobrança pelo txId

$parametros = ['inicio' => '2021-09-01T01:00:00-03:00', 'fim' => '2021-09-10T01:00:00-03:00']; // Consulte o site do Banco Central para outras opções de filtros
$cob->consultar(null, $parametros);

Alterar/revisar cobrança imediata

$cobranca = [
    'calendario' => [
        'expiracao' => 3600
    ],
    'devedor' => [
        'cpf' => '12345678911',
        'nome' => 'Fulano'
    ],
    'valor' => [
        'original' => '2.00'
    ],
    'chave' => '[e-mail]',
    'solicitacaoPagador' => 'mensagem pagador'
];

$cob->alterar($cobranca, 'xxxx');

Criar webhook

$scope = ['webhook.read', 'webhook.write']; //Veja a lista completa na documentação do Banco Central
$psp = new Psp($scope);
$webhook = new \Elemke\SicoobPix\Webhook($psp);
$webhook->criar('[e-mail]', 'https://www.teste.com');

Consultar webhook

$webhook = new \Elemke\SicoobPix\Webhook($psp);
$webhook->consultar('[e-mail]');

Deletar webhook

$webhook = new \Elemke\SicoobPix\Webhook($psp);
$webhook->deletar('[e-mail]');

Licença

MIT