Search by

ailos / sdk

ViniciusDeSenna

Este SDK foi desenvolvido para facilitar a integração com os serviços da Cooperativa Ailos, oferecendo uma interface simples, segura e eficiente para desenvolvedores PHP.

v2.0.2 2026-10-25 22:45 UTC

This package is auto-updated.

Last update: 2026-10-27 23:59:46 UTC


README

Este SDK foi desenvolvido para facilitar a integração com os serviços das cooperativas Ailos, oferecendo uma interface simples, segura e eficiente para desenvolvedores PHP.

screwdriver-wrench-solid-full 1 (1)

Stars Forks Release Release Date Last Commit Commit Activity Issues Pull Requests Contributors Top Language Repository Size Code Size License

Instalação

composer require ailos/sdk

Requisitos

  • PHP ^8.5
  • PHP extensão ext-apcu
  • PHP extensão ext-curl
  • PHP extensão ext-dom
  • PHP extensão ext-libxml

Cobrança

As primeiras funcionalidades que podem ser testadas utilizando a biblioteca são as funcionalidades da API de cobrança da Ailos. Essa API é responsável por controlar a emissão de boletos.

Configuração

Para iniciar a biblioteca e começar a utilizar os serviços, basta configurar e chamar:

$config = new CobrancaConfig(
    consumerKey: '...',
    consumerSecret: '...',
    urlCallback: 'https://meusite.com/callback',
    developerKey: '...',
    codigoCooperativa: '0101',
    codigoConta: '12345',
    senha: '...',
    ambiente: Ambiente::Producao,
);

$ailos = new Ailos()->cobranca($config);

Além das configurações padrões de credenciais e ambiente, a CobrancaConfig permite injetar suas próprias implementações para duas responsabilidades internas da biblioteca:

IStorage: responsável por armazenar as credenciais (tokens, etc). Por padrão, a biblioteca utiliza uma implementação baseada em APCu, mas você pode fornecer sua própria implementação, por exemplo, para persistir os dados em um banco de dados ou em um cache como Redis.

IHttp: responsável por realizar as chamadas HTTP à API da cooperativa. Por padrão, a biblioteca utiliza uma implementação baseada em cURL, mas você pode substituí-la pela biblioteca HTTP de sua preferência (Guzzle, Symfony HttpClient, etc).

Para utilizar suas próprias implementações, basta que elas implementem as interfaces IStorage e IHttp e sejam passadas ao construtor de CobrancaConfig:

$config = new CobrancaConfig(
    storage: new RedisStorage(...),
    http: new GuzzleHttp(...),
);