README

Este pacote fornece uma integração com a API do Asaas para Laravel, permitindo o gerenciamento de clientes, cobranças, assinaturas e Pix.

Instalação

Requisitos

PHP 8.2 ou superior
Laravel 9 ou superior
GuzzleHTTP 7.4 ou superior

Passos

Instale o pacote via Composer:

composer require cristyanhenrich/asaas-sdk

Publique as configurações:

php artisan vendor:publish --tag=asaas-config

Configure as variáveis de ambiente no arquivo .env:

ASAAS_PRODUCTION=true
ASAAS_API_KEY=your_api_key_here

Uso

Configuração Inicial

Certifique-se de configurar corretamente as variáveis no arquivo .env. O pacote automaticamente detecta se deve usar o ambiente de produção ou sandbox com base no valor de ASAAS_PRODUCTION.

Exemplo de Uso

Clientes

Listar clientes:

use Asaas;

$clientes = Asaas::listCustomers(['name' => 'Cristyan Henrich']);

Criar um cliente:

$cliente = Asaas::createCustomer([
    'name' => 'Cristyan Henrich',
    'cpfCnpj' => '12345678900',
    'email' => 'cristyanhenrich16@gmail.com',
]);

Cobranças

Criar uma cobrança:

$cobranca = Asaas::createCharge([
    'customer' => 'customer_id',
    'billingType' => 'BOLETO',
    'value' => 150.00,
    'dueDate' => '2025-01-31',
]);

Assinaturas

Criar uma assinatura:

$assinatura = Asaas::createSubscription([
    'customer' => 'customer_id',
    'billingType' => 'CREDIT_CARD',
    'value' => 200.00,
    'nextDueDate' => '2025-02-01',
]);

Pix

Listar chaves Pix:
```
$pixKeys = Asaas::listKeys();
```

Estrutura de Configuração

Após publicar o arquivo de configuração, você pode encontrá-lo em config/asaas.php. Aqui estão as principais opções:

return [
    'production' => env('ASAAS_PRODUCTION', false),
    'api_url_production' => env('ASAAS_API_PRODUCTION', 'https://api.asaas.com/'),
    'api_url_sandbox' => env('ASAAS_API_SANDBOX', 'https://sandbox.asaas.com/api/v3/'),
    'api_key' => env('ASAAS_API_KEY', ''),
];

Registro Automático

Este pacote utiliza o ServiceProvider do Laravel para registrar serviços e aliases automaticamente.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou enviar um pull request.

Licença

Este pacote é licenciado sob a MIT License.

cristyanhenrich / asaas-sdk

Maintainers

Details