PHPackages                             luquinhasbrito/asaas-api-sdk-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. luquinhasbrito/asaas-api-sdk-laravel

ActiveLibrary[API Development](/categories/api)

luquinhasbrito/asaas-api-sdk-laravel
====================================

SDK Laravel para a API Asaas v3 - cliente HTTP com retry, serviços, Models e Form Requests

1.0.2(3mo ago)0155MITPHPPHP ^8.2

Since Feb 28Pushed 3mo agoCompare

[ Source](https://github.com/lucasbrito-wdt/asaas-api-sdk-laravel)[ Packagist](https://packagist.org/packages/luquinhasbrito/asaas-api-sdk-laravel)[ RSS](/packages/luquinhasbrito-asaas-api-sdk-laravel/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (2)Dependencies (5)Versions (3)Used By (0)

Asaas API SDK Laravel
=====================

[](#asaas-api-sdk-laravel)

SDK Laravel para a [API Asaas v3](https://api.asaas.com/), com cliente HTTP (retry com backoff exponencial), serviços para os principais recursos, models e validação interna (Requests internos), API pública com arrays.

- **Laravel:** 11.x | 12.x
- **PHP:** 8.2+

Instalação
----------

[](#instalação)

```
composer require luquinhasbrito/asaas-api-sdk-laravel
```

Configuração
------------

[](#configuração)

Publique o arquivo de configuração:

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

Configure no `.env`:

```
ASAAS_API_KEY=sua_api_key
ASAAS_ENV=sandbox
# ASAAS_BASE_URL=  # opcional, override da URL base
# ASAAS_TIMEOUT=10000
# ASAAS_RETRY_MAX=1
```

Em aplicações Laravel o SDK é registrado como singleton. Use o helper ou a facade (se publicada):

```
use Asaas\Laravel\AsaasSdk;

$sdk = app(AsaasSdk::class);
// ou
$sdk = asaas();
```

Fora do Laravel, crie a instância a partir do array de config:

```
use Asaas\Laravel\AsaasSdk;

$sdk = AsaasSdk::fromConfig([
    'api_key' => getenv('ASAAS_API_KEY'),
    'environment' => 'sandbox',
]);
```

Uso
---

[](#uso)

### Clientes (Customer)

[](#clientes-customer)

```
$sdk = asaas();

// Listar (parâmetros opcionais)
$list = $sdk->customer->list();
$list = $sdk->customer->list(['offset' => 0, 'limit' => 10]);

// Criar
$customer = $sdk->customer->create([
    'name' => 'João',
    'email' => 'joao@exemplo.com',
    'cpfCnpj' => '12345678909',
]);

// Obter
$c = $sdk->customer->get($customer->id);

// Atualizar
$updated = $sdk->customer->update($customer->id, [
    'name' => 'João Silva',
]);

// Remover
$sdk->customer->delete($customer->id);
```

### Pagamentos (Payment)

[](#pagamentos-payment)

```
$sdk = asaas();

// Listar (parâmetros de query)
$payments = $sdk->payment->list(['customer' => 'cus_xxx']);
$payments = $sdk->payment->list(['customer' => 'cus_xxx', 'offset' => 0, 'limit' => 10]);

// Criar cobrança
$payment = $sdk->payment->create([
    'customer' => 'cus_xxx',
    'value' => 99.90,
    'dueDate' => '2025-03-15',
    'billingType' => 'BOLETO',
    'description' => 'Pedido #123',
]);

// Obter / atualizar / deletar
$p = $sdk->payment->get($payment->id);
$sdk->payment->update($payment->id, ['description' => 'Nova descrição']);
$sdk->payment->delete($payment->id);
```

### Outros serviços

[](#outros-serviços)

O SDK expõe os 32 serviços da API Asaas. Além de `customer` e `payment`, estão disponíveis (entre outros): `subscription`, `webhook`, `transfer`, `invoice`, `accountInfo`, `pix`, etc. Cada um estende `BaseService` e pode ter métodos adicionais implementados conforme a documentação da API.

```
$sdk->subscription->list();
$sdk->webhook->list();
$sdk->accountInfo->list(); // minha conta
```

Autenticação
------------

[](#autenticação)

A autenticação é feita via header `access_token` (compatível com o SDK Java). A chave é lida de `config('asaas.api_key')` ou `ASAAS_API_KEY`.

Retry
-----

[](#retry)

O cliente HTTP aplica retry com backoff para códigos 408, 429 e 5xx, conforme `config/asaas.php` (ou padrões). Métodos GET, POST, PUT, PATCH e DELETE são elegíveis para retry.

Exceções
--------

[](#exceções)

- `Asaas\Laravel\Exceptions\ApiError` – erros gerais (status, mensagem, response).
- `Asaas\Laravel\Exceptions\ErrorResponseDtoException` – erros 400 com detalhes da API (`getErrors()`).

Testes
------

[](#testes)

```
composer install
./vendor/bin/phpunit
```

Referência
----------

[](#referência)

Para espelhamento dos padrões do SDK Java, consulte a análise em [ANALISE\_PROJETO.md](https://github.com/asaasdev/asaas-api-sdk-java) do repositório asaas-api-sdk-java.

Licença
-------

[](#licença)

MIT.

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance78

Regular maintenance activity

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

118d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f7804accedd190804443c7150e8f0185530d3db578825b437e4e59010aae1d6c?d=identicon)[lucasbrito-wdt](/maintainers/lucasbrito-wdt)

---

Top Contributors

[![lucasbrito-wdt](https://avatars.githubusercontent.com/u/30214900?v=4)](https://github.com/lucasbrito-wdt "lucasbrito-wdt (11 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/luquinhasbrito-asaas-api-sdk-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/luquinhasbrito-asaas-api-sdk-laravel/health.svg)](https://phpackages.com/packages/luquinhasbrito-asaas-api-sdk-laravel)
```

###  Alternatives

[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76518.2M120](/packages/laravel-mcp)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)