jetimob/asaas-sdk-php-laravel

Laravel SDK for Asaa's API

v1.6.0 2024-10-01 18:32 UTC

This package is not auto-updated.

Last update: 2024-10-29 18:48:12 UTC


README

Asaas Sdk Php Laravel

Essa SDK foi criado com o intuito de se comunicar com a Api da Asaas de forma simples e direta com apenas as funcionalidades necessárias.

Instalação
composer require jetimob/asaas-sdk-php-laravel 

Configuração

Para começar, as configurações do pacote devem ser publicadas através do comando:

php artisan asaas:install

Este comando irá criar o arquivo de configuração asaas.php no diretório /config para que você possa modificar conforme a necessidade do seu projeto.

Api's

  • Customer - ( Clientes )
  • Charging - ( Cobranças )
  • Account - ( Subcontas )
  • Webhook - ( Configuração de Webhooks )

Sempre que for chamar qualquer api do pacote asaas-sdk-php-laravel, utilize o namespace Jetimob\Asaas\Facades\Asaas ou, simplesmente, Asaas. O namespace Asaas é registrado automaticamente pelo Laravel, ou seja, a importação pode ser feita apenas com use Asaas; no topo de um arquivo.

Exemplos

Criação de um cliente (Customer)

use Jetimob\Asaas\Facades\Asaas;
use Jetimob\Asaas\Entity\Customer\Customer; 

$customer = with(new Customer())
            ->setName('John Doe')
            ->setEmail('teste@email.com')
            ->setCpfCnpj('00000000000');

$response = Asaas::customer()->create($customer);

Autenticação

Todas as requisições para a Api da Asaas necessitam de um access_token nos headers da requisição, por padrão o pacote irá recuperar do arquivo asaas.php.

Quando se trata de requisições referentes as subcontas deve ser passado de forma explícita o token ( Retornado como ApiKey após a criação de uma subconta ).

Por exemplo:

$charging = new Charging();

/** 
 * Dessa forma irá criar uma cobrança para a conta principal,
 * que possua a api key configurada no arquivo asaas.php.
 */
Asaas::charging()->create($charging);


/**
 * Dessa forma será criada uma cobrança para essa conta que foi criada agora
 */
$account = new Account();

$response = Asaas::account()->create($account);

$apiKey = $response->getApiKey();

Asaas::charging()->usingToken($apiKey)->create($charging);

Implementaçoẽs