Paydios PHP SDK: Manage Products and Checkout Sessions

The Paydios PHP SDK lets you integrate payment processing into any PHP application. It wraps the Merchant API and handles authentication, request formatting, and error handling for you — so you can manage products, create checkout sessions, and verify payments without writing raw HTTP calls.

This SDK is for server-side (merchant backend) use only. Never expose your secret key in frontend code or commit it to version control.

Requirements

PHP 8.1+
Composer

Installation

Install the SDK with Composer:

composer require paydios/paydios-php

Configuration

The SDK resolves configuration in this order:

Config array passed directly to Client
Environment variables (PAYDIOS_SECRET_KEY, PAYDIOS_BASE_URL)
Default base URL (https://api.paydios.io)

This means you can rely on environment variables for credentials and only override when needed.

Environment variables (recommended)

Create a .env file in your project root and add your secret key:

PAYDIOS_SECRET_KEY=sk_live_xxxxxxxxx

Using environment variables keeps your credentials out of source code. Never commit your .env file to version control — add it to .gitignore.

Passing config manually

If you prefer to configure the client explicitly, pass an array when creating the instance:

$pk = new Client([
  'base_url'   => 'https://api.paydios.io',
  'secret_key' => 'sk_live_xxx'
]);

Quick Start

Once the SDK is installed and your secret key is set in your environment, you can make your first API call:

<?php

require __DIR__ . '/vendor/autoload.php';

use Paydios\Client;

$pk = new Client();

$products = $pk->products()->list(['per_page' => 20]);

print_r($products);

Authentication

All Merchant API requests are authenticated with a Bearer token:

Authorization: Bearer {secret_key}

The SDK sets this header automatically using the secret key you provide. You never need to construct or attach authorization headers manually.

Products API

The merchant identity is inferred from your secret key, so you do not need to pass a merchant ID to product endpoints. The SDK uses the following endpoints:

Method	Endpoint
`GET`	`/merchant-api/products`
`POST`	`/merchant-api/products`
`GET`	`/merchant-api/products/{product_id}`
`PUT`	`/merchant-api/products/{product_id}`
`DELETE`	`/merchant-api/products/{product_id}`

List products

Retrieve a paginated list of your products. Use search to filter by keyword:

$products = $pk->products()->list([
  'per_page' => 20,
  'page'     => 1,
  'search'   => 'shirt'
]);

Create product

Create a new product. Set status to draft to keep it unpublished until ready:

$created = $pk->products()->create([
  'name'        => 'Black T-Shirt',
  'description' => 'Cotton tee',
  'status'      => 'draft',
  'currency'    => 'USD',
  'unit_amount' => 1999
]);

$productId = $created['product']['id'];

Get product

Retrieve a single product by its ID:

$product = $pk->products()->get($productId);

Update product

Update one or more fields on an existing product. Change status to published to make it live:

$updated = $pk->products()->update($productId, [
  'name'   => 'Black T-Shirt (Updated)',
  'status' => 'published'
]);

Delete product

Permanently delete a product:

$pk->products()->delete($productId);

Checkout Sessions

Use checkout sessions for backend-driven payment flows. The session returns a checkout_url you can redirect your customer to, and a session_id you use to verify the result after payment. The SDK uses these endpoints:

Method	Endpoint
`POST`	`/merchant-api/{merchant_id}/checkout-sessions`
`GET`	`/merchant-api/{merchant_id}/{session_id}`

Create checkout session

Create a session for a specific transaction. Pass your Merchant ID (available in the merchant dashboard):

$session = $pk->sessions()->create($merchantId, [
  'amount'      => 1999,
  'currency'    => 'USD',
  'description' => 'Order #1001',
  'source'      => 'custom_php'
]);

$sessionId = $session['session_id'];

Verify checkout session

After the customer completes payment, verify the session status on your server:

$status = $pk->sessions()->verify($merchantId, $sessionId);

Testing

The SDK ships with unit tests (mocked HTTP) and optional integration tests that run against a real API.

Run unit tests

./vendor/bin/phpunit

Integration tests (real API)

Integration tests are skipped unless you explicitly enable them. Add the following to your .env:

PAYDIOS_INTEGRATION=1
PAYDIOS_BASE_URL=http://localhost:8000
PAYDIOS_SECRET_KEY=sk_test_xxx

Then run:

./vendor/bin/phpunit tests/Integration/ProductsIntegrationTest.php --testdox

Laravel Usage

For Laravel-specific setup — including config/services.php registration, controller examples, and the singleton pattern — see the dedicated Laravel integration guide.

Common Errors

Missing secret key

If the SDK cannot find a secret key, requests will fail with an authentication error. Make sure your environment includes:

PAYDIOS_SECRET_KEY=sk_test_xxx

If you are passing config manually, confirm the secret_key key is present in the array passed to Client.

Security Notes

Never expose your secret key in frontend or client-side code.
Use the publishable key for client-side checkout flows.
Use the secret key only in your server-side backend code.

Resources

Paydios PHP SDK on GitHub

Browse the source code, open issues, and contribute to the SDK.

Packagist Package

View the Composer package on Packagist for version history and install stats.

Get Started

Core Features

Merchant Account

Integrations

Platform & Security

Paydios PHP SDK: Manage Products and Checkout Sessions

Requirements

Installation

Configuration

Environment variables (recommended)

Passing config manually

Quick Start

Authentication

Products API

List products

Create product

Get product

Update product

Delete product

Checkout Sessions

Create checkout session

Verify checkout session

Testing

Run unit tests

Integration tests (real API)

Laravel Usage

Common Errors

Missing secret key

Security Notes

Resources

Paydios PHP SDK on GitHub

Packagist Package

​Requirements

​Installation

​Configuration

​Environment variables (recommended)

​Passing config manually

​Quick Start

​Authentication

​Products API

​List products

​Create product

​Get product

​Update product

​Delete product

​Checkout Sessions

​Create checkout session

​Verify checkout session

​Testing

​Run unit tests

​Integration tests (real API)

​Laravel Usage

​Common Errors

​Missing secret key

​Security Notes

​Resources

Paydios PHP SDK on GitHub

Packagist Package

Requirements

Installation

Configuration

Environment variables (recommended)

Passing config manually

Quick Start

Authentication

Products API

List products

Create product

Get product

Update product

Delete product

Checkout Sessions

Create checkout session

Verify checkout session

Testing

Run unit tests

Integration tests (real API)

Laravel Usage

Common Errors

Missing secret key

Security Notes

Resources