adila-sh / pay

v0.3.1 2026-10-12 15:26 UTC

Requires

• php: ^8.1
• ext-json: *
• php-http/discovery: ^1.0
• php-http/multipart-stream-builder: ^1.0
• psr/http-client: ^1.0
• psr/http-client-implementation: ^1.0
• psr/http-factory: ^1.0
• psr/http-factory-implementation: ^1.0
• psr/http-message: ^1.1 || ^2.0

Suggests

• guzzlehttp/guzzle: Cliente HTTP PSR-18 com suporte a timeout (já incluído no Laravel).
• illuminate/support: Integração Laravel: service provider, facade AdilaPay e config/adila-pay.php.

MIT

• payments
• sdk
• laravel
• pix
• adila
• adila-pay

Published on Packagist.org on 2026-10-12 15:26 UTC

README

Cliente PHP gerado a partir do contrato financeiro Adila Pay. Suporta PHP 8.1+ com qualquer cliente HTTP PSR-18 e se integra ao Laravel sem configuração extra.

Instalação

composer require adila-sh/pay

Fora do Laravel, instale também um cliente PSR-18, como guzzlehttp/guzzle. O timeout por requisição exige Guzzle ou Symfony HttpClient.

Uso no servidor

use AdilaPay\AdilaPayClient;
use AdilaPay\Customers\Requests\CreateCustomersRequest;
use AdilaPay\Customers\Requests\ListCustomersRequest;

$client = new AdilaPayClient(getenv('ADILA_PAY_API_KEY'), [
    'timeout' => 30,
    'maxRetries' => 2,
]);

$customers = $client->customers->list(new ListCustomersRequest([
    'organizationId' => getenv('ADILA_PAY_ORGANIZATION_ID'),
    'limit' => 10,
]));

$customer = $client->customers->create(new CreateCustomersRequest([
    'organizationId' => getenv('ADILA_PAY_ORGANIZATION_ID'),
    'idempotencyKey' => 'cliente-integracao-001',
    'name' => 'Cliente de exemplo',
]));

A URL padrão é https://api-pay.adila.co; use a opção baseUrl para outra instalação. Sem $apiKey, o cliente lê ADILA_PAY_API_KEY do ambiente.

Laravel

O pacote registra sozinho o AdilaPayServiceProvider e o facade AdilaPay. Configure o .env:

ADILA_PAY_API_KEY=...
ADILA_PAY_ORGANIZATION_ID=...

Use o facade ou injete AdilaPayClient, que é um singleton no container:

use AdilaPay\AdilaPayClient;
use AdilaPay\Customers\Requests\ListCustomersRequest;
use AdilaPay\Laravel\Facades\AdilaPay;

$customers = AdilaPay::customers()->list(new ListCustomersRequest([
    'organizationId' => config('adila-pay.organization_id'),
]));

class CheckoutController
{
    public function __construct(private AdilaPayClient $adilaPay) {}
}

Para alterar base_url, timeout ou max_retries, publique a configuração:

php artisan vendor:publish --tag=adila-pay-config

Erros, listas e idempotência

Respostas HTTP de erro lançam AdilaPay\Exceptions\AdilaPayApiException, com getCode() igual ao status e getBody() com o corpo. Falhas de rede e timeouts lançam AdilaPay\Exceptions\AdilaPayException.

São 43 operações financeiras, incluindo links de pagamento, códigos promocionais e configuração de repasses. Criação de conta, onboarding e cadastro humano ficam fora do cliente de integração. As requisições são tipadas; respostas Stripe continuam abertas como arrays. Nas listas, use $list->data, $list->hasMore e startingAfter. Mutações exigem chave de idempotência de 8 a 255 caracteres. Reutilize a mesma chave e corpo somente para repetir a mesma operação lógica.

Consulte a documentação para recursos e limites de ambiente. Este pacote inclui openapi.json e provenance.json para identificar o contrato utilizado na geração. O código é gerado em adila-sh/payment-sdks; alterações feitas diretamente neste repositório são sobrescritas na próxima versão.