PHPackages                             fsdrasfragoso/asaas-sdk - 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. [Payment Processing](/categories/payments)
4. /
5. fsdrasfragoso/asaas-sdk

ActiveLibrary[Payment Processing](/categories/payments)

fsdrasfragoso/asaas-sdk
=======================

SDK para a API Asaas. Este SDK permite a integração com funcionalidades como pagamentos, subscrições, notificações, entre outras.

00PHP

Since May 2Pushed 2y ago1 watchersCompare

[ Source](https://github.com/fsdrasfragoso/asaas-sdk)[ Packagist](https://packagist.org/packages/fsdrasfragoso/asaas-sdk)[ RSS](/packages/fsdrasfragoso-asaas-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

SDK para PHP do Asaas
=====================

[](#sdk-para-php-do-asaas)

Este SDK permite integrar facilmente a API do Asaas em projetos PHP para automatizar processos de cobrança, recebimento e pagamento.

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

[](#instalação)

Para instalar o SDK, siga estes passos:

1. Certifique-se de ter o Composer instalado em seu ambiente de desenvolvimento.
2. Crie um novo projeto ou vá para um projeto existente onde deseja integrar o SDK.
3. Abra o terminal e navegue até o diretório do seu projeto.
4. Execute o seguinte comando para instalar o SDK via Composer:

```
composer require fsdrasfragoso/asaas-sdk
```

Utilização
----------

[](#utilização)

Após instalar o SDK, você pode utilizá-lo em seu projeto da seguinte maneira:

```
require_once 'vendor/autoload.php';

use Asaas\Api\Customers\CustomerService;
use Asaas\Customers\CustomerManager;
use Asaas\Api\Payments\PaymentService;
use Asaas\Payments\PaymentManager;

$apiKey = 'sua-chave-de-api';

$customerService = new CustomerService($apiKey);
$customerManager = new CustomerManager($customerService);

$customerData = [
    'name' => 'João Silva',
    'cpfCnpj' => '000.000.000-00',
    'email' => 'joao.silva@email.com',
    'phone' => '4730280400',
    'mobilePhone' => '47991234444',
    'address' => 'Rua Exemplo, 123',
    'postalCode' => '89223000'
];

$customer = $customerManager->createCustomer($customerData);

echo "Cliente criado com sucesso. ID: " . $customer->id;
$paymentService = new PaymentService($apiKey);
$paymentManager = new PaymentManager($paymentService);

$paymentData = [
    'customer' => $customer->id,
    'billingType' => 'BOLETO',
    'value' => 100.00,
    'dueDate' => '2024-05-05',
    'description' => 'Descrição da cobrança'
];

$payment = $paymentManager->create($paymentData);

echo "Cobrança criada com sucesso. ID: " . $payment->id;
```

Criando um Cliente com um Objeto Customer
-----------------------------------------

[](#criando-um-cliente-com-um-objeto-customer)

```
// Configuração do SDK já realizada anteriormente

// Criação do objeto Customer sem parâmetros iniciais no construtor
$customer = new Customer();
$customer->setName("Carlos Silva");
$customer->setCpfCnpj("111.222.333-44");
$customer->setEmail("carlos.silva@example.com");
$customer->setPhone("2133445566");
$customer->setMobilePhone("21988776655");
$customer->setAddress("Rua das Laranjeiras, 200");
$customer->setAddressNumber("20");
$customer->setComplement("Casa");
$customer->setProvince("Zona Sul");
$customer->setPostalCode("22000-000");
$customer->setExternalReference("54321");
$customer->setNotificationDisabled(true);
$customer->setAdditionalEmails("carlos.negocios@example.com");
$customer->setMunicipalInscription("654321789");
$customer->setStateInscription("321654987");
$customer->setObservations("Cliente atacadista");
$customer->setGroupName("Atacado");
$customer->setCompany("Carlos Frutas LTDA");

// Usando o CustomerManager para criar o cliente no Asaas
$result = $customerManager->createCustomer($customer);

if ($result) {
    echo "Cliente criado com sucesso. ID: " . $result->id;
} else {
    echo "Erro ao criar cliente.";
}
```

Documentação
------------

[](#documentação)

Para mais informações sobre os métodos disponíveis e os parâmetros necessários, consulte a [documentação oficial do Asaas](https://docs.asaas.com/docs/guia-de-cobrancas).

Estrutura do SDK
----------------

[](#estrutura-do-sdk)

Aqui está a estrutura de diretórios e arquivos do SDK:

- `src/`
    - `Api/`
        - `Payments/`
            - `PaymentService.php`: Implementa a lógica de integração com a API de pagamentos do Asaas.
    - `Payments/`
        - `PaymentManager.php`: Gerencia as operações relacionadas a cobranças.
        - `PaymentInterface.php`: Define a interface para a classe PaymentManager.
        - `Payment.php`: Representa uma cobrança do Asaas.

Contribuindo
------------

[](#contribuindo)

Se encontrar algum problema ou quiser contribuir com melhorias, fique à vontade para abrir uma [issue](https://github.com/fsdrasfragoso/asaas-sdk-php/issues) ou enviar um [pull request](https://github.com/fsdrasfragoso/asaas-sdk-php/pulls) no repositório do GitHub.

###  Health Score

11

—

LowBetter than 0% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/c04d1daa8802ea42c207c93b9bb336c1dfe758b7830a88f2ef2d91bf5377f859?d=identicon)[fsdrasfragoso](/maintainers/fsdrasfragoso)

### Embed Badge

![Health badge](/badges/fsdrasfragoso-asaas-sdk/health.svg)

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

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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