PHPackages                             geniusreferrals/geniusreferrals - 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. geniusreferrals/geniusreferrals

ActiveLibrary[API Development](/categories/api)

geniusreferrals/geniusreferrals
===============================

Genius Referrals PHP SDK - integrate referral programs using the Genius Referrals RESTful API.

v2.0.1(3w ago)011.2k↓27.3%1MITPHPPHP >=8.1

Since Feb 18Pushed 6y ago2 watchersCompare

[ Source](https://github.com/GeniusReferrals/Genius-Referrals-PHP)[ Packagist](https://packagist.org/packages/geniusreferrals/geniusreferrals)[ Docs](http://www.geniusreferrals.com)[ RSS](/packages/geniusreferrals-geniusreferrals/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (3)Dependencies (6)Versions (9)Used By (0)

Genius Referrals PHP SDK
========================

[](#genius-referrals-php-sdk)

A PHP SDK for integrating with the [Genius Referrals](https://www.geniusreferrals.com) RESTful API. This SDK provides convenient access to all API resources including accounts, advocates, bonuses, campaigns, products, referrals, redemption requests, reports, tags, vouchers, and widget packages.

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

[](#requirements)

- PHP 8.1 or higher
- Composer

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

[](#installation)

```
composer require geniusreferrals/geniusreferrals
```

Authentication
--------------

[](#authentication)

Get your API token from the [Genius Referrals settings page](https://www.geniusreferrals.com/en/settings/api-access).

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

use GeniusReferralsLib\GeniusReferralsClient;

$client = new GeniusReferralsClient(null, 'YOUR_API_TOKEN');
```

Usage
-----

[](#usage)

### Accounts

[](#accounts)

```
$accounts = $client->getAccounts();

// List with pagination
$accounts = $client->getAccounts()->getAccounts(1, 10);

// Get a single account
$account = $client->getAccounts()->getAccount('your-account-slug');

// Create an account
$client->getAccounts()->createAccount(['name' => 'My Account', ...]);

// Update an account
$client->getAccounts()->updateAccount('your-account-slug', ['name' => 'Updated']);

// Delete an account
$client->getAccounts()->deleteAccount('your-account-slug');
```

### Advocates

[](#advocates)

```
$advocates = $client->getAdvocates()->getAdvocates('your-account-slug');
$advocate = $client->getAdvocates()->getAdvocate('your-account-slug', 'advocate-token');
$client->getAdvocates()->postAdvocate('your-account-slug', ['firstname' => 'John', 'email' => 'john@example.com']);
$client->getAdvocates()->patchAdvocate('your-account-slug', 'advocate-token', ['firstname' => 'Updated']);
```

### Bonuses

[](#bonuses)

```
$bonuses = $client->getBonuses()->getBonuses('your-account-slug');
$client->getBonuses()->postBonus('your-account-slug', ['advocate_token' => 'token', ...]);
$client->getBonuses()->patchBonus('your-account-slug', $bonusId, ['status' => 'approved']);
$client->getBonuses()->getBonusTags('your-account-slug', $bonusId);
```

### Products

[](#products)

```
$products = $client->getProducts()->getProducts('your-account-slug');
$client->getProducts()->createProduct('your-account-slug', ['name' => 'Widget']);
$client->getProducts()->updateProduct('your-account-slug', 'product-slug', ['name' => 'Updated']);
```

### Tags

[](#tags)

```
$tags = $client->getTags()->getTags('your-account-slug');
$client->getTags()->createTag('your-account-slug', ['name' => 'VIP']);
```

### Vouchers

[](#vouchers)

```
$vouchers = $client->getVouchers()->getVouchers('your-account-slug');
$client->getVouchers()->createVoucher('your-account-slug', ['code' => 'VOUCHER1']);
```

### Widgets Packages

[](#widgets-packages)

```
$packages = $client->getWidgetsPackages()->getWidgetsPackages('your-account-slug');
$widgets = $client->getWidgetsPackages()->getWidgets('your-account-slug', 'package-slug');
```

### Reports

[](#reports)

```
$client->getReports()->getRevenue('your-account-slug', '2026-01-01', '2026-12-31');
$client->getReports()->get1099TaxReport('your-account-slug', 2026);
```

Docker Development
------------------

[](#docker-development)

```
# Install dependencies
make install

# Run tests
make test

# Run linting
make lint

# Run static analysis
make analyze

# Clean build
make clean
```

Resources
---------

[](#resources)

- [API Documentation](https://api.geniusreferrals.com/doc)
- [SDK repository](https://github.com/GeniusReferrals/Genius-Referrals-PHP)
- [Sandbox](https://github.com/GeniusReferrals/GRPHPSandbox)

License
-------

[](#license)

MIT

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance53

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity77

Established project with proven stability

 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

Every ~860 days

Total

5

Last Release

25d ago

Major Versions

v1.2 → v2.0.02026-07-23

PHP version history (2 changes)v1.0PHP >=5.4.0

v2.0.0PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/a54f562ec6cd3d50cef9f961183af5e579d12ebfaca114d30fae321099ae6a84?d=identicon)[alain@hlasolutionsgroup.com](/maintainers/alain@hlasolutionsgroup.com)

---

Top Contributors

[![alainhl](https://avatars.githubusercontent.com/u/1686340?v=4)](https://github.com/alainhl "alainhl (9 commits)")

---

Tags

sdkrefer a friendreferralaffiliatefriendgeniusreferralsreferral programspromotion campaignsreferral campaignsreferralsreferreferral marketing

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[aws/aws-sdk-php

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

6.2k555.0M2.8k](/packages/aws-aws-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

91524.8M38](/packages/facebook-php-business-sdk)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[facebook/php-ads-sdk

PHP SDK for Facebook Business

9154.2M8](/packages/facebook-php-ads-sdk)[resend/resend-php

Resend PHP library.

608.3M53](/packages/resend-resend-php)

PHPackages © 2026

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