PHPackages                             fabriciogferreira/abacatepay-php-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. [API Development](/categories/api)
4. /
5. fabriciogferreira/abacatepay-php-sdk

ActiveLibrary[API Development](/categories/api)

fabriciogferreira/abacatepay-php-sdk
====================================

An unofficial PHP SDK for integrating AbacatePay payment solutions into your applications.

v1.0.0(today)00MITPHPPHP ^8.0

Since Jul 29Pushed todayCompare

[ Source](https://github.com/fabriciogferreira/abacatepay-php-sdk)[ Packagist](https://packagist.org/packages/fabriciogferreira/abacatepay-php-sdk)[ Docs](https://github.com/fabriciogferreira/abacatepay-php-sdk)[ RSS](/packages/fabriciogferreira-abacatepay-php-sdk/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

AbacatePay SDK for PHP
======================

[](#abacatepay-sdk-for-php)

Community-maintained unofficial PHP SDK for integrating AbacatePay payment solutions.

[![PHP Version](https://camo.githubusercontent.com/2d7a58d6202395e2b84e34e90c02dbedd618cd04d0a4fac8f9d353f9b86ce298/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302b2d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![License: MIT](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/0d45b381273d2c02adfe54df2bca714f5cb54e9805d73da833eb9f69b66e655e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666162726963696f6766657272656972612f616261636174657061792d7068702d73646b)](https://packagist.org/packages/fabriciogferreira/abacatepay-php-sdk)[![Packagist Downloads](https://camo.githubusercontent.com/8d1c7968f50b739fc0869db27978223ec150038b16ff5282df35c6489936dc42/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666162726963696f6766657272656972612f616261636174657061792d7068702d73646b)](https://packagist.org/packages/fabriciogferreira/abacatepay-php-sdk)

> ⚠️ This is an unofficial community-maintained SDK and is not affiliated with AbacatePay.

Menu
----

[](#menu)

- [Installation](#-installation)
- [Configuration](#-configuration)
- [Examples](#-usage-examples)
- [Error Handling](#-error-handling)
- [Contributing](#-contributing)

📋 Requirements
--------------

[](#-requirements)

- PHP 8.0 or higher
- Guzzle 7.0 or higher
- Composer
- Valid AbacatePay account and API credentials
- SSL enabled for production environments

💻 Installation
--------------

[](#-installation)

Install the SDK via Composer:

```
composer require fabriciogferreira/abacatepay-php-sdk
```

🔧 Configuration
---------------

[](#-configuration)

First, initialize the SDK with your API token:

```
use AbacatePay\v2\Clients\AbacatePayClient;

$abacatePayClient = new AbacatePayClient('YOUR_ABACATE_PAY_TOKEN');
```

> ⚠️ Never commit your API tokens to version control. Use environment variables instead.

📘 Usage Examples
----------------

[](#-usage-examples)

### Customer

[](#customer)

#### Initialization

[](#initialization)

```
use AbacatePay\v2\Clients\AbacatePayClient;
use AbacatePay\v2\RequestData\Customer\CustomerCreateRequestData;

$abacatePayClient = new AbacatePayClient('YOUR_ABACATE_PAY_TOKEN');
```

#### Create

[](#create)

```
$customerCreateRequestData = CustomerCreateRequestData::make('fabriciof481@gmail.com')
  ->name('Fabrício')
  ->metadata([
    'herói favorito' => 'flash',
    'idade' => 24
  ]);

$customerCreateResponseBody = $abacatePayClient->customers()
  ->create($customerCreateRequestData);
```

Returns an instance of:

```
AbacatePay\v2\ResponseBody\Customer\CustomerCreateResponseBody
```

🌟 Features
----------

[](#-features)

### Customers

[](#customers)

- ✅ Create customers
- ✅ Retrieve customers
- ✅ Delete customers

### Subscriptions

[](#subscriptions)

- ✅ Create subscriptions
- ✅ Cancel subscriptions

More features will be added in future releases.

Supported Versions
------------------

[](#supported-versions)

VersionStatus2.xActive development1.xMaintenance onlyChangelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history.

Versioning
----------

[](#versioning)

This project follows Semantic Versioning (SemVer):

- MAJOR: Breaking changes
- MINOR: New backward-compatible features
- PATCH: Bug fixes

⚡ Best Practices
----------------

[](#-best-practices)

- Use environment variables for API tokens
- Enable error reporting in development
- Always validate customer input
- Handle exceptions appropriately

🔍 Error Handling
----------------

[](#-error-handling)

```
use AbacatePay\v2\Exceptions\AbacatePayNetworkException;
use AbacatePay\v2\Exceptions\AbacatePayValidationException;
use AbacatePay\v2\Exceptions\AbacatePayInvalidRequestException;
use AbacatePay\v2\Exceptions\AbacatePayAuthorizationException;
use AbacatePay\v2\Exceptions\AbacatePayAuthenticationException;
use AbacatePay\v2\Exceptions\AbacatePayRateLimitException;
use AbacatePay\v2\Exceptions\AbacatePayNotFoundException;
use AbacatePay\v2\Exceptions\AbacatePayApiException;

try {
  $customerCreateResponseBody = $abacatePayClient->customers()
      ->create($customerCreateRequestData);
} catch (AbacatePayNetworkException $e) {
  // Handle network error (0)
} catch (AbacatePayValidationException $e) {
  // Handle validation error (422)
} catch (AbacatePayInvalidRequestException $e) {
  // Handle invalid request error(400)
} catch (AbacatePayAuthorizationException $e) {
  // Handle authorization (403)
} catch (AbacatePayAuthenticationException $e) {
  // Handle authentication error (401)
} catch (AbacatePayRateLimitException $e) {
  // Handle rate limit error (429)
} catch (AbacatePayNotFoundException $e) {
  // Handle not found error (404)
} catch (AbacatePayApiException $e) {
  // Handle unexpected API errors (500)
}
```

📚 Documentation
---------------

[](#-documentation)

For AbacatePay API documentation and integration guides:

[AbacatePay Documentation](https://docs.abacatepay.com/pages/start/welcome)

🤝 Contributing
--------------

[](#-contributing)

We welcome contributions! Please follow the steps below.

1. Fork the repository
2. Create a feature branch (`feature/my-feature`)
3. Make your changes
4. Add or update tests
5. Run `composer check`
6. Open a Pull Request on [GitHub](https://github.com/fabriciogferreira/abacatepay-php-sdk/pulls)

🛠️ Development
--------------

[](#️-development)

### Installing packages

[](#installing-packages)

```
composer install

```

### Running Tests

[](#running-tests)

```
composer test      # Run tests
composer analyse   # Run PHPStan analysis
composer lint      # Check code style
composer fix       # Fix code style
composer check     # Run all checks
```

🔒 Security
----------

[](#-security)

For security issues, please see our Security Policy.

❤️ Support the Project
----------------------

[](#️-support-the-project)

This SDK is developed and maintained independently.

If it has been useful to you and you'd like to support its maintenance, you can contribute via PIX:

`fabriciof481@gmail.com`

Thank you for your support!

📄 License
---------

[](#-license)

This project is licensed under the [MIT License](LICENSE).

💬 Support
---------

[](#-support)

- For SDK issues, open an issue
- For API questions, contact

\--

Made with ❤️ by the community.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 52.2% of commits — single point of failure

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/88504219?v=4)[Fabricio Ferreira](/maintainers/fabriciogferreira)[@fabriciogferreira](https://github.com/fabriciogferreira)

---

Top Contributors

[![fabriciogferreira](https://avatars.githubusercontent.com/u/88504219?v=4)](https://github.com/fabriciogferreira "fabriciogferreira (24 commits)")[![jjr-dev](https://avatars.githubusercontent.com/u/71138607?v=4)](https://github.com/jjr-dev "jjr-dev (14 commits)")[![matheuscarddoso](https://avatars.githubusercontent.com/u/92444207?v=4)](https://github.com/matheuscarddoso "matheuscarddoso (7 commits)")[![rafaelqueiroz](https://avatars.githubusercontent.com/u/275919?v=4)](https://github.com/rafaelqueiroz "rafaelqueiroz (1 commits)")

---

Tags

phpapisdkpaymentpayment gatewaypixabacatepay

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fabriciogferreira-abacatepay-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/fabriciogferreira-abacatepay-php-sdk/health.svg)](https://phpackages.com/packages/fabriciogferreira-abacatepay-php-sdk)
```

###  Alternatives

[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

293.1k](/packages/eslazarev-wildberries-sdk)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.6M13](/packages/checkout-checkout-sdk-php)[resend/resend-php

Resend PHP library.

607.2M46](/packages/resend-resend-php)[postfinancecheckout/sdk

PostFinance Checkout SDK for PHP

22241.1k24](/packages/postfinancecheckout-sdk)[wallee/sdk

wallee SDK for PHP

12392.3k19](/packages/wallee-sdk)[fingerprint/fingerprint-pro-server-api-sdk

Fingerprint Server API allows you to get, search, and update Events in a server environment. It can be used for data exports, decision-making, and data analysis scenarios. Server API is intended for server-side usage, it's not intended to be used from the client side, whether it's a browser or a mobile device.

33274.4k1](/packages/fingerprint-fingerprint-pro-server-api-sdk)

PHPackages © 2026

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