Este SDK permite integrar facilmente a API do Asaas em projetos PHP para automatizar processos de cobrança, recebimento e pagamento.
Para instalar o SDK, siga estes passos:
-
Certifique-se de ter o Composer instalado em seu ambiente de desenvolvimento.
-
Crie um novo projeto ou vá para um projeto existente onde deseja integrar o SDK.
-
Abra o terminal e navegue até o diretório do seu projeto.
-
Execute o seguinte comando para instalar o SDK via Composer:
composer require fsdrasfragoso/asaas-sdk
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;
// 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.";
}
Para mais informações sobre os métodos disponíveis e os parâmetros necessários, consulte a documentação oficial do Asaas.
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.
Se encontrar algum problema ou quiser contribuir com melhorias, fique à vontade para abrir uma issue ou enviar um pull request no repositório do GitHub.