README

🇺🇸 English | 🇪🇸 Español | 🇫🇷 Français

Uma SDK robusta, totalmente componentizada e fortemente tipada para integração de pagamentos com a Asaas API, desenvolvida utilizando o ecossistema e padrões estritos do PHP 8.5 e Symfony 8.

Apoie o projeto:

🌟 Sobre o Projeto

Este projeto pertence a Marcus Vinicius Cardoso (@marcusvy), mas é totalmente livre para que você possa opinar e contribuir! Ele foi feito como uma iniciativa Open Source para enriquecer o ecossistema e fornecer uma alternativa consistente para os desenvolvedores do mundo PHP, interagindo com as excelentes ferramentas e serviços prestados pela Asaas Gestão Financeira.

A SDK ofícial do Asaas atualmente é provida em Java. Este pacote é um port integral arquitetado nativamente para a comunidade PHP. Utilizando de tipagem estrita, classes de Value Objects (DTOs), validação com Symfony Validator, e requisições otimizadas do HttpClient, o comportamento reproduz nativamente a solidez e excelência que se encontra na SDK oficial do Java para a elegância do PHP moderno.

🔗 Links Importantes

• Documentação Oficial Asaas
• Criação e Gestão de Chaves de API Asaas
• Ambiente de Sandbox Asaas

📥 Instalação

Você pode facilmente instalar essa biblioteca usando composer executando:

composer require marcusvy/asaas-api-sdk-php

🚀 Como Usar

A utilização da SDK foi desenhada com simplicidade e fluidez em mente. Basta instanciar o AsaasClient, passando seu token de acesso.

use Marcus\Asaas\Asaas;
use Marcus\Asaas\Model\ListCustomersParameters;

require_once 'vendor/autoload.php';

// Crie a instância principal definindo o ambiente e seu Token 
// O segundo parâmetro `true` define o uso da Sandbox (testes)
$asaas = new Asaas('seu_token_api_aqui', true);

// Explorar os serviços é fácil devido a arquitetura de módulos
$customerService = $asaas->customerService();

// Parâmetros são mapeados via instâncias de classes e tipados
$params = new ListCustomersParameters();
$params->setName('Marcus');

$response = $customerService->listCustomers($params);

// Os dados retornados já vêm no formato de DTOs e não arrays puros!
foreach ($response->getData() as $customer) {
    echo $customer->getName() . PHP_EOL;
}

👨‍💻 Sobre o Autor

Marcus Vinicius Cardoso Desenvolvedor apaixonado por soluções limpas, escaláveis e focadas na excelência de arquitetura de software.

• Email: marcusvy@gmail.com
• GitLab: gitlab.com/marcusvy
• Buy Me a Coffee: buymeacoffee.com/marcusvyz

❤️ Apoie a Manutenção

Sendo um projeto Open Source independente e distribuído livremente (Licença MIT), sua doação incentiva ativamente que novas atualizações sigam de forma rápida acompanhando o painel do Asaas. Você pode fortalecer a comunidade!

Para apoios, doações ou enviar um café simbólico: Chave PIX: marcusvy@gmail.com

"Uma excelente integração gera noites de sono tranquilas para os desenvolvedores e para o controle financeiro de negócios."