Configure the Paydios PHP SDK in a Laravel Application

The Paydios PHP SDK integrates cleanly into Laravel applications. Configure credentials in your .env file and instantiate the client anywhere in your application using Laravel’s config helper. No service provider is required — the SDK works with standard Laravel conventions out of the box.

Requirements

PHP 8.1+
Laravel 10+
Composer

Installation

Install the SDK with Composer:

composer require paydios/paydios-php

Configuration

Add credentials to .env

Add your Paydios API base URL and secret key to your .env file. Retrieve your secret key from the merchant dashboard:

PAYDIOS_BASE_URL=https://api.paydios.io
PAYDIOS_SECRET_KEY=sk_live_xxx

Never commit this file to version control.

Add a paydios entry to your config/services.php file so the SDK config is accessible via Laravel’s config helper:

'paydios' => [
    'base_url'   => env('PAYDIOS_BASE_URL'),
    'secret_key' => env('PAYDIOS_SECRET_KEY'),
],

Instantiate the client

Wherever you need the SDK, create a Client instance by passing the registered config:

use Paydios\Client;

$pk = new Client(config('services.paydios'));

Using in a Controller

The example below shows a controller method that creates a Paydios checkout session and redirects the customer to the payment page:

<?php

namespace App\Http\Controllers;

use Paydios\Client;
use Illuminate\Http\Request;

class CheckoutController extends Controller
{
    public function create(Request $request)
    {
        $pk         = new Client(config('services.paydios'));
        $merchantId = config('services.paydios.merchant_id');

        $session = $pk->sessions()->create($merchantId, [
            'amount'      => $request->input('amount'),
            'currency'    => 'USD',
            'description' => 'Order #' . $request->input('order_id'),
            'source'      => 'laravel',
        ]);

        return redirect($session['checkout_url']);
    }
}

Add your Merchant ID to your .env and config/services.php alongside your secret key:

PAYDIOS_MERCHANT_ID=your_merchant_id

'paydios' => [
    'base_url'    => env('PAYDIOS_BASE_URL'),
    'secret_key'  => env('PAYDIOS_SECRET_KEY'),
    'merchant_id' => env('PAYDIOS_MERCHANT_ID'),
],

Listing Products

Use the same pattern to call any SDK method. The example below lists your first 20 products:

$pk       = new Client(config('services.paydios'));
$products = $pk->products()->list(['per_page' => 20]);

Bind Paydios\Client in your AppServiceProvider as a singleton to avoid re-instantiating the client on every request:

$this->app->singleton(\Paydios\Client::class, function () {
    return new \Paydios\Client(config('services.paydios'));
});

You can then resolve it via dependency injection or app(\Paydios\Client::class).

See the PHP SDK reference for the full list of available methods, including product management, checkout sessions, and error handling.

Get Started

Core Features

Merchant Account

Integrations

Platform & Security

Configure the Paydios PHP SDK in a Laravel Application

Requirements

Installation

Configuration

Using in a Controller

Listing Products

​Requirements

​Installation

​Configuration

​Using in a Controller

​Listing Products

Requirements

Installation

Configuration

Using in a Controller

Listing Products