SDKs

Two thin clients over the same HTTP API. Neither is required, and neither is published to a package registry yet.

Both clients are thin wrappers over the HTTP API. They normalize result codes and nothing else — no scheduling, no storage, no retry loops. Anything either can do, a plain HTTPS request can do too.

Install

npm install github:P2Flux/sdk-js#v0.1.0   # not on npm yet

{
  "repositories": [{ "type": "vcs", "url": "https://github.com/P2Flux/sdk-php" }],
  "require": { "p2flux/p2flux-php": "v0.1.0" }
}

JavaScript / TypeScript

Zero dependencies. charge() never throws on a payment outcome — an unreachable API comes back as NETWORK_ERROR / RETRY_LATER rather than an exception.

import { createP2Flux } from '@p2flux/sdk'

const p2flux = createP2Flux({
  apiUrl: process.env.P2FLUX_API_URL,
  timeoutMs: 30_000   // default 60s: a charge waits for confirmation
})

const result = await p2flux.charge(ref)
result.ok            // CHARGED or ALREADY_CHARGED
result.action        // SUCCESS | WAIT | RETRY_LATER | …
result.retryable     // safe to repeat the identical call
result.raw           // the untouched API body

PHP

PHP 8.1+, curl by default, no framework and no Composer runtime dependencies. The constructor takes an optional transport callable, so a host application can route requests through its own HTTP stack — wp_remote_post, Guzzle — or stub them in tests.

use P2Flux\P2FluxClient;

$p2flux = new P2FluxClient([
  'apiUrl'    => getenv('P2FLUX_API_URL'),
  'timeout'   => 30,
  'transport' => fn($url, $payload, $timeout) => [$status, $body],
]);

$result = $p2flux->charge($subscriptionRef);   // never throws on an outcome

What each client covers

The two clients are not at parity today. The PHP client wraps the full surface; the JavaScript client implements the renewal path only. Anything missing is a plain POST away.

Or use REST

No SDK is required for any part of the integration. Every endpoint is a POST with a JSON body and no authentication — see the API reference. Python and other languages have no client yet; call the API directly.