npm install @palpluss/sdk
# or
pnpm add @palpluss/sdk
# or
yarn add @palpluss/sdk

pip install palpluss

composer require palpluss/sdk

import { PalPluss } from '@palpluss/sdk';

const client = new PalPluss({ apiKey: 'pk_live_...' });

// or — reads PALPLUSS_API_KEY automatically
const client = new PalPluss();

from palpluss import PalPluss

client = PalPluss(api_key="pk_live_...")

# or — reads PALPLUSS_API_KEY automatically
client = PalPluss()

use PalPluss\PalPluss;

$client = new PalPluss(apiKey: 'pk_live_...');

// or — reads PALPLUSS_API_KEY automatically
$client = new PalPluss();

import { PalPlussApiError, RateLimitError } from '@palpluss/sdk';

try {
  const result = await client.stkPush({ amount: 500, phone: '254712345678' });
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log(`Rate limited — retry after ${err.retryAfter}s`);
  } else if (err instanceof PalPlussApiError) {
    console.log(`[${err.code}] ${err.message}  requestId=${err.requestId}`);
  }
}

from palpluss import PalPlussApiError, RateLimitError

try:
    result = client.stk_push(amount=500, phone="254712345678")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except PalPlussApiError as e:
    print(f"[{e.code}] {e}  request_id={e.request_id}")

use PalPluss\Http\Errors\PalPlussApiError;
use PalPluss\Http\Errors\RateLimitError;

try {
    $result = $client->stkPush(amount: 500, phone: '254712345678');
} catch (RateLimitError $e) {
    echo "Rate limited — retry after {$e->retryAfter}s\n";
} catch (PalPlussApiError $e) {
    echo "[{$e->errorCode}] {$e->getMessage()}  requestId={$e->requestId}\n";
}