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

ActiveLibrary[API Development](/categories/api)

recurringstack/recurringstack-php
=================================

This repository houses the official php client for the RecurringStack API. Official Release

v0.1.0-beta(1y ago)166MITPHP

Since Jun 14Pushed 2mo agoCompare

[ Source](https://github.com/recurringstack/recurringstack-php)[ Packagist](https://packagist.org/packages/recurringstack/recurringstack-php)[ RSS](/packages/recurringstack-recurringstack-php/feed)WikiDiscussions main Synced 1mo ago

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

[![Alt text](images/recurring_stack_logo-whitebg.png?raw=true "Title")](images/recurring_stack_logo-whitebg.png?raw=true)

recurringstack-php
==================

[](#recurringstack-php)

This repository houses the official php client for the RecurringStack™ API. Create and manage account, subscriptions, products, support tickets, and more.

Documentation for the RecurringStack™ API can be found at .

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

[](#requirements)

PHP 7 or later

guzzle/guzzle (dependency)

Composer
--------

[](#composer)

We recommend using Composer to install the bindings.

```
composer require recurringstack/recurringstack-php
```

Don't forget to include Composers autoload at the top of your project/script.

```
require_once 'vendor/autoload.php';
```

Creating a Client and Authenticating
------------------------------------

[](#creating-a-client-and-authenticating)

```
$rs = new recurringstack\api([
  'key' => "rs_key_....",
  'user_key' => "rs_user_....",
  'brand_id' => "",
  'response_format' => 'xml', //xml or json
  'response_type' => 'clean' //empty or clean (returns results as object)
]);
```

Error Handling & Exceptions
-------------------------------

[](#error-handling--exceptions)

The RecurringStack™ API client includes custom error handling methods.

```
try {

    # Delete a customer account
    $rs->deleteAccount('8247cf79-9296-4372-b39c-6370c70372ee');

} catch (recurringstack\apiException $e) {

    /* The following custom error handling functions are available /*

    $debug = debugError(); //Return the exception message, code, request, and the response as an object. Great for debugging!
    $errorObj = $e->errorAsObject(); //Return the code and message in an object
    $errorMessage = getExceptionMessage(); //Return just the message
    $errorCode = getExceptionCode(); //Return just the status code
    */

    }
```

Usage Examples
--------------

[](#usage-examples)

```
# List one or multiple customer accounts
$rs->listAccount(array('customer_account_id' => '8247cf79-9296-4372-b39c-6370c70372ee'))
```

```
# Delete a customer account
$rs->deleteAccount('8247cf79-9296-4372-b39c-6370c70372ee');
```

```
# Create a new subscription for a customer
$subConfig = array(
  "customer_account_id" => '8247cf79-9296-4372-b39c-6370c70372ee',
  "product_id" => "",
  "auto_pay" => "",
  "coupon_code" => '',
  "custom_field_1" => '',
  "custom_field_2" => '',
  "attached_components" => '',
  "override_initial_billing" => ""
);

$rs->createSubscription($subConfig);
```

```
# Manually create an invoice for a customer
$billableItems = array(
  array('item_name' => 'Programming Services Base Charge','item_price' => '25.00','tax_exempt' => 'Y'),
  array('item_name' => '25 Hours @ $15.00 Ea','item_price' => '375.00','tax_exempt' => 'Y'),
);

$invoiceConfig = array(
 "attached_items" => json_encode($billableItems),
 "custom_field_1" => '',
 "custom_field_2" => ''
);

$rs->createInvoice($invoiceConfig);
```

NOTES:

- We recommend wrapping your code in a try block as all errors returned locally or from the API will be returned as exceptions
- Find more example code in the official RecurringStack™ documentation at

Contributing
------------

[](#contributing)

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License
-------

[](#license)

[MIT](https://choosealicense.com/licenses/mit/)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance61

Regular maintenance activity

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity26

Early-stage or recently created project

 Bus Factor1

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

704d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef0b3e54f52e95452f27cf9660ff451965aa7f4102328d2813da4e5fa47b524a?d=identicon)[hawkinstechnologygroup](/maintainers/hawkinstechnologygroup)

---

Top Contributors

[![hawkinstg](https://avatars.githubusercontent.com/u/131827774?v=4)](https://github.com/hawkinstg "hawkinstg (33 commits)")

### Embed Badge

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

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

###  Alternatives

[rackspace/php-opencloud

PHP SDK for Rackspace/OpenStack APIs

4495.9M38](/packages/rackspace-php-opencloud)[cdaguerre/php-trello-api

Trello API v2 client

255666.7k3](/packages/cdaguerre-php-trello-api)[dchesterton/marketo-rest-api

A PHP client for the Marketo.com REST API

41844.1k1](/packages/dchesterton-marketo-rest-api)[carlosio/geckoboard

A PHP library for dealing with Geckoboard API (http://www.geckoboard.com)

40172.2k](/packages/carlosio-geckoboard)[teepluss/api

Laravel 4 Internal Request (HMVC)

7034.0k](/packages/teepluss-api)[jlinn/mandrill-api-php

A PHP client library for Mandrill's REST API

24117.4k](/packages/jlinn-mandrill-api-php)

PHPackages © 2026

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