PHPackages                             rebilly/client-php - 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. rebilly/client-php

ActiveLibrary[API Development](/categories/api)

rebilly/client-php
==================

Rebilly PHP Client

3.1.9(3w ago)19424.2k—5.2%18[2 PRs](https://github.com/Rebilly/rebilly-php/pulls)MITPHPPHP ^8.0CI failing

Since Jun 14Pushed 1w ago18 watchersCompare

[ Source](https://github.com/Rebilly/rebilly-php)[ Packagist](https://packagist.org/packages/rebilly/client-php)[ Docs](http://rebilly.com/)[ RSS](/packages/rebilly-client-php/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (15)Versions (72)Used By (0)

Rebilly SDK for PHP
===================

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

[![Latest Version on Packagist](https://camo.githubusercontent.com/3ed930d534a5406b66e0fbc2c77b3dc6a2dc3af8a91f83d9d26c748b2d26879f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726562696c6c792f636c69656e742d7068702e737667)](https://packagist.org/packages/rebilly/client-php)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/610299dce7dbcb50a0954fbc4a95a776bae9ec7af645140367b8a7864c0ed737/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726562696c6c792f636c69656e742d7068702e737667)](https://packagist.org/packages/rebilly/client-php)

The **Rebilly SDK for PHP** makes it easy for developers to access [Rebilly REST APIs](https://www.rebilly.com/catalog/all) in their PHP code.

Requirements
------------

[](#requirements)

- PHP 8.0+.
- CURL (verify peer requires a root certificate authority -- if you have not configured php curl to use one, and your system libs aren't linked to one, you may need to do a [manual configuration](http://stackoverflow.com/questions/17478283/paypal-access-ssl-certificate-unable-to-get-local-issuer-certificate/19149687#19149687) to use the appropriate certificate authority)

Installation
------------

[](#installation)

Warning

This package does not follow semantic versioning, so minor version updates can cause backward compatibility breaks. Updates to the package should be tested before switching versions.

Using [Composer](http://getcomposer.org/) is the recommended way to install the Rebilly SDK for PHP. To get started, you need run the Composer commands (assume you're in the project's root directory).

- Install the latest stable version of the SDK:

```
composer require rebilly/client-php
```

*You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at [getcomposer.org](http://getcomposer.org/).*

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

[](#supported-versions)

The previous version of the SDK can be outdated and won't provide all (or the correct) specifications to communicate with the REST APIs. Only the latest version is constantly supported.

VersionSupportedDocumentation[2.x](https://github.com/Rebilly/rebilly-php/tree/v2.x)⚠️ (security fixes only)✅ [See tab PHP-SDK-2.0](https://www.rebilly.com/catalog/all)3.x✅ (current)✅ [See tab PHP](https://www.rebilly.com/catalog/all)Quick Examples
--------------

[](#quick-examples)

Create a Rebilly Client

```
use Rebilly\Sdk\Client;
use Rebilly\Sdk\Service;

// Instantiate Rebilly client.
$client = new Client([
    'baseUrl' => Client::SANDBOX_HOST,
    'organizationId' => '{organizationId}',
    'apiKey' => '{secretKey}',
]);
$service = new Service(client: $client);
```

Create a Customer

```
use Rebilly\Sdk\Exception\DataValidationException;
use Rebilly\Sdk\Model\ContactObject;
use Rebilly\Sdk\Model\Customer;

$customer = Customer::from([])
    ->setWebsiteId('{websiteId}')
    ->setPrimaryAddress(
        ContactObject::from([])
            ->setFirstName('John')
            ->setLastName('Doe'),
    );

try {
  $customer = $service->customers()->create($form);
} catch (DataValidationException $e) {
  var_dump($e->getValidationErrors());
}
```

For more see [examples directory](./examples/).

Documentation
-------------

[](#documentation)

Read [Rebilly REST APIs documentation](https://www.rebilly.com/catalog/all) for more details.

Migration from SDK v2.x to v3.x
-------------------------------

[](#migration-from-sdk-v2x-to-v3x)

This new major version brings several new helper classes to communicate with Rebilly REST APIs and some incompatibilities that should be tested before switching SDK versions.

- Now, a `Service` class can be explicitly instantiated to make the API calls instead of using only the `Client`, as it encapsulates the API calls.
- To simplify the migration from the previous version, the `Client` object can be used to make calls to any API directly. For example, instead of instantiating a service class, one can use:

    ```
    $client->customers()->create($form);
    ```
- The namespace changed from `Rebilly\Entities` to `Rebilly\Sdk\Model`. Now, the `src` is `Rebilly\Sdk`.
- The classes are now generated by an automated process that is triggered every time a new version of the [API definitions](https://github.com/Rebilly/api-definitions) is released. It means more frequency on the SDK updates, keeping it synced with the REST APIs.

###  Health Score

67

—

FairBetter than 99% of packages

Maintenance97

Actively maintained with recent releases

Popularity47

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 70.6% 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

Every ~73 days

Recently: every ~52 days

Total

61

Last Release

24d ago

Major Versions

1.0.x-dev → v2.0.1-alpha2015-08-13

2.19.0 → 3.0.0-alpha2022-09-16

v2.x-dev → 3.0.02023-10-05

PHP version history (7 changes)1.0.0PHP >=5.2

1.0.5PHP >=5.3

v2.0.1-alphaPHP >=5.4

2.2.0PHP >=5.5

2.4.0PHP >=7.1

3.0.0-alphaPHP ^8.1

3.0.0PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1161871?v=4)[Adam Altman](/maintainers/adamaltman)[@adamaltman](https://github.com/adamaltman)

---

Top Contributors

[![rebilly-machine-user](https://avatars.githubusercontent.com/u/29335184?v=4)](https://github.com/rebilly-machine-user "rebilly-machine-user (156 commits)")[![justnero](https://avatars.githubusercontent.com/u/11618962?v=4)](https://github.com/justnero "justnero (36 commits)")[![ninjasimon](https://avatars.githubusercontent.com/u/7696653?v=4)](https://github.com/ninjasimon "ninjasimon (9 commits)")[![lucasxciv](https://avatars.githubusercontent.com/u/5672800?v=4)](https://github.com/lucasxciv "lucasxciv (5 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![elgouttefangeas](https://avatars.githubusercontent.com/u/185560359?v=4)](https://github.com/elgouttefangeas "elgouttefangeas (4 commits)")[![ashkarpetin](https://avatars.githubusercontent.com/u/400534?v=4)](https://github.com/ashkarpetin "ashkarpetin (3 commits)")[![owsiakl](https://avatars.githubusercontent.com/u/9623965?v=4)](https://github.com/owsiakl "owsiakl (2 commits)")[![colinbird](https://avatars.githubusercontent.com/u/3696815?v=4)](https://github.com/colinbird "colinbird (1 commits)")

---

Tags

payment-gatewaysubscriptionstransactionsapipayment processingsubscriptionstransactions

###  Code Quality

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/rebilly-client-php/health.svg)

```
[![Health](https://phpackages.com/badges/rebilly-client-php/health.svg)](https://phpackages.com/packages/rebilly-client-php)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[algolia/algoliasearch-client-php

API powering the features of Algolia.

69735.1M159](/packages/algolia-algoliasearch-client-php)[oat-sa/tao-core

TAO core extension

66143.7k124](/packages/oat-sa-tao-core)

PHPackages © 2026

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