8ctopus/paddle-rest-api

Paddle REST API implementation using PSR-7, PSR-17 and PSR-18

0.1.0 2026-04-30 06:17 UTC

Requires

• php: >=8.4

Requires (Dev)

• clue/commander: ^1.4
• nimbly/shuttle: ^1.0
• nunomaduro/collision: ^6.2|^7.0|^8.0

Replaces

• symfony/polyfill-ctype: *
• symfony/polyfill-intl-grapheme: *
• symfony/polyfill-intl-normalizer: *
• symfony/polyfill-mbstring: *

MIT

• 8ctopus

• api
• paddle

README

A php implementation of the Paddle REST API using PSR-7, PSR-17 and PSR-18 as I didn't like the official API's excessive use of dependencies.

The package is an exploratory work in progress and contributions are welcome. For now, it currently covers Products, Prices, Discounts, Discount Groups and Adjustments (refunds).

install package

composer require 8ctopus/paddle-rest-api

before you get started

Copy .env.example to .env and fill in your Paddle REST API key. If you don't have it yet, follow the guide:

https://developer.paddle.com/api-reference/about/authentication#get-api-key

demo

Here's a code snippet that shows the general architecture. To see all possibilites run php demo.php.

use Nimbly\Capsule\Factory\RequestFactory;
use Nimbly\Capsule\Factory\StreamFactory;
use Nimbly\Shuttle\Shuttle;
use Oct8pus\Paddle\HttpHandler;
use Oct8pus\Paddle\Auth;
use Oct8pus\Paddle\Products;

$handler = new HttpHandler(
    // PSR-18 http client
    new Shuttle(),
    // PSR-17 request factory
    new RequestFactory(),
    // PSR-7 stream
    new StreamFactory()
);

$sandbox = true;

$auth = new Auth($sandbox, $handler, $env['secret']);

$products = new Products($sandbox, $handler, $auth);

var_dump($products->list());

issues with the current minimalist architecture

• hard to use the demo for more complex things
  • list items with filters
  • create complex items as arrays are not presently supported
  • it's not possible to update a key which is not a string