codeswholesalev3/sdk

A PHP client library for CodesWholesale's API

1.0.1 2025-09-12 19:12 UTC

Requires

• php: >=7.0.0
• guzzlehttp/guzzle: ^6.3
• sainsburys/guzzle-oauth2-plugin: ^3.0

CC-BY-NC-4.0

• Waerenburgh Dorian

• security
• api
• cloud
• games
• codeswholesale
• cd-keys

README

A simple and lightweight PHP SDK for interacting with the CodesWholesale API V3.
Designed in an object-oriented style inspired by the V2 SDK, with support for:

Features

• Authentication & Token Management

  • Automatic OAuth2 client credentials flow.
  • Token storage via session or custom storage implementation.
  • Automatic token renewal when expired.

• Product Management

  • Fetch all products with optional callback handling for large datasets.
  • Retrieve specific products by ID.
  • Access product codes (text or image) through structured objects.

• Order Management

  • Create new orders with multiple products.
  • Retrieve orders and their status.
  • Access ordered products as structured objects with codes.

• Clean, Extensible Architecture

  • Namespaced classes under CodesWholesale\Resource and CodesWholesale\Storage.
  • Client class handles all HTTP requests and authentication.
  • Fully object-oriented with typed properties and methods.
  • Exception handling for HTTP and authentication errors.

Requirements

• PHP 7.4+
• cURL extension enabled

Usage

1. Initialize the Client

use CodesWholesale\Client;
use CodesWholesale\CodesWholesale;
use CodesWholesale\Storage\SessionAuthTokenStorage;
use CodesWholesale\Storage\FileContinuationTokenStorage;

$params = [
    'cw.client_id' => 'your-client-id',
    'cw.client_secret' => 'your-client-secret',
    'cw.endpoint_uri' => CodesWholesale::SANDBOX_ENDPOINT, // or LIVE_ENDPOINT,
    'cw.token_storage' => new SessionAuthTokenStorage()
];

$client = new Client($params);

$continuationStorage = new FileContinuationTokenStorage(__DIR__ . '/last_token.txt');
$continuationToken = $continuationStorage->getContinuationToken();

2. Retrieve Products

use CodesWholesale\Resource\Product;

// Get all products
$products = Product::getAll($client);

// Get a product by ID
$product = Product::getById($client, 'PRODUCT_ID');

Getter list for products

    $product->getName();
    $product->getPrices();
    $product->getDefaultPrice();
    $product->getStock();
    $product->getPlatform();
    $product->getRegions();
    $product->getReleaseDate();

3. Create an order

use CodesWholesale\Resource\Order;

$createdOrder = Order::createOrder($client, [
    ['productId' => '6313677f-5219-47e4-a067-7401f55c5a3a', 'quantity' => 2]
]);

4. Retrieve account details

use CodesWholesale\Resource\Account;

$accountDetails = Account::getCurrent($client);

Getter list for the current account

    $accountDetails->getBalance();