PHP download

Download the PHP package siren/sdk without Composer

On this page you can find all versions of the php package siren/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download siren/sdk
More information about siren/sdk
Files in siren/sdk

Vendor siren
Package sdk
Short Description Official Siren SDK for PHP — affiliate and incentive tracking for any commerce stack.
License MIT
Homepage https://sirenaffiliates.com

Keywords ecommerce sdk stripe referral Siren rewards affiliate webhooks affiliate-marketing incentives

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of siren/sdk

Informations about the package sdk

Siren SDK for PHP

Affiliate and incentive tracking for any commerce stack — record sales, verify signed webhooks, and reconcile your ledger in a few lines of PHP.

What is Siren?

Siren is an affiliate, referral, and incentive platform. You track the events that matter — sales, refunds, referred visits — and Siren attributes them to collaborators, calculates rewards, and manages payouts.

This SDK is the official PHP client for the Siren API. It lets you:

Record commerce and tracking events (sale, refund, siteVisited, and custom event types)
Verify signed webhooks in a single, constant-time call
Manage API keys and webhook subscriptions
Reconcile Siren's ledger (conversions, transactions, obligations, payouts) against your own

The full API surface is described in the OpenAPI spec.

Requirements

PHP 8.1+
ext-json

Install

Quickstart

Record a sale

Mint an API key in the Siren dashboard (Settings → API Keys), then:

Refunds reverse a sale by (externalId, source):

Verify a webhook

Siren signs every delivery with X-Siren-Signature: sha256=<hex hmac> — an HMAC-SHA256 of the raw request body keyed by your subscription's signing secret.

⚠️ Pass the raw body bytes. The HMAC is computed over the exact bytes Siren sent. Read php://input directly — if you json_decode and re-encode the payload, verification will fail.

Create a subscription (the signingSecret is returned once — store it):

Features

Event ingestion — sale, refund, siteVisited, and custom event types via ingest.
Webhook verification — one-call constructEvent, plus a lower-level constant-time verifySignature boolean check.
Subscription management — create, list, and delete webhook subscriptions.
API key management — create, list, and revoke keys.
Reconciliation readers — paginated iterators over conversions, transactions, obligations, and payouts.
Automatic retries — network errors, 429s, and 5xx are retried with exponential backoff on idempotent operations; management writes are never auto-retried.
Typed exceptions — every error extends Siren\Sdk\Exception\SirenException and carries the status code, error code, and error data.

Configuration

Errors

Every exception extends Siren\Sdk\Exception\SirenException and carries getStatusCode(), getErrorCode(), and getErrorData().

Status	Exception
400	`BadRequestException`
401	`AuthenticationException`
403	`PermissionException`
404	`NotFoundException`
409	`ConflictException`
422	`ValidationException` — `getFieldErrors()`
429	`RateLimitException` — `getRetryAfter()`
5xx / other	`ApiException`
network/timeout	`ConnectionException`

Webhook verification failures throw SignatureVerificationException.

Other SDKs

Siren also ships official clients for other stacks:

Node.js — Novatorius/siren-node
Python — Novatorius/siren-python

Contributing

Contributions are welcome. See CONTRIBUTING.md for how to set up the project, run the tests, and open a pull request. By participating you agree to the Code of Conduct.

Tests mock the HTTP layer — no live network calls.

License

All versions of sdk with dependencies

PHP Build Version

Package Version

Version 0.1.0 Release 11. Jul 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of sdk from vendor siren

Requires php Version >=8.1
ext-json Version *
guzzlehttp/guzzle Version ^7.8

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package siren/sdk contains the following files

Loading the files please wait ...