argws/asaas-sdk-php

SDK PHP NÃO OFICIAL para a API do Asaas. Baseada na SDK Java e gerada a partir da documentação/OpenAPI.

v0.2.62 2026-02-27 15:20 UTC

Requires

• php: ^8.1
• ext-json: *
• guzzlehttp/guzzle: ^7.8
• psr/log: ^3.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.56
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.5

MIT

README

NÃO OFICIAL — Não afiliada ao Asaas.
Baseada na SDK Java oficial e na documentação pública/OpenAPI.
Asaas é marca de seus respectivos proprietários.

SDK PHP comunitária para a API do Asaas, com foco em paridade com a SDK Java e geração a partir da documentação oficial.

Instalação

composer require argws/asaas-sdk-php

Requisitos:

• PHP 8.1+
• ext-json

Configuração rápida (sem .env)

<?php

use Asaas\Sdk\AsaasSdk;
use Asaas\Sdk\Config\AsaasConfig;
use Asaas\Sdk\Http\Environment;

$config = new AsaasConfig(
    apiKey: 'SUA_API_KEY',
    environment: Environment::Sandbox, // ou Environment::Production
    appName: 'MinhaApp/1.0',
    timeout: 30.0,
    connectTimeout: 10.0
);

$asaas = new AsaasSdk($config);

Status/Healthcheck (resumo)

Você pode verificar status da API com uma chamada leve (ex.: listPayments com limit=1). Veja o guia completo em docs/14-status-healthcheck-resiliencia.md.

Índice da documentação

• Introdução
• Instalação
• Configuração
• Quickstart
• Sandbox vs Production
• Serviços e endpoints
• Exceções e erros
• Paginação, filtros e ordenação
• Webhooks
• Upload/Download de arquivos
• Multi-tenant
• Exemplos Laravel
• Exemplos CodeEngine
• Geração OpenAPI e paridade
• Status/Healthcheck/Resiliência
• Perfex CRM (exemplos)
• Playground (referência)
• Referência de endpoints (gerada do código)

Aviso legal

Este projeto não é oficial e não é afiliado ao Asaas.
Asaas é marca registrada de seus respectivos proprietários.

Playground

https://playground-asaas-sdk.argws.com.br