README

Official PHP SDK for the Orqex payment orchestration API.

A single, framework-agnostic client for the Orqex merchant API: create payment intents, run hosted checkouts, attempt and confirm payments, issue refunds, requery transactions and read exchange rates. Pure PHP, with an optional Laravel integration that activates only inside Laravel applications.

• Pure PHP 8.3+ — works in any project, no framework required.
• Typed resources with IDE autocompletion, forward-compatible with new API fields.
• Guzzle by default, or bring your own HTTP client.
• Automatic retries with exponential backoff and jitter.
• Idempotency keys generated automatically for every write.
• Cursor pagination with a transparent auto-paging iterator.
• Typed exceptions mapped from HTTP status codes.

Documentation

Full documentation lives at docs.orqex.com:

Installation

composer require orqex/orchestrate-php

Requires PHP 8.3+ and ext-json. Guzzle 7.5+ is installed automatically.

Quickstart

use Orqex\Orchestrate\OrchestrateClient;

$orqex = new OrchestrateClient('sk_live_xxx');

$intent = $orqex->paymentIntents()->create([
    'amount'      => 50,
    'currency'    => 'USD',
    'description' => 'Order #1024',
    'customer'    => [
        'email'      => 'ama@example.com',
        'first_name' => 'Ama',
        'last_name'  => 'Mensah',
    ],
]);

echo $intent->status;          // "pending"
echo $intent->amount->value;   // 50 (major units)

Start a payment, resolve the customer's next action, then read the final status — see the usage guide for the full flow.

Laravel

The package ships an auto-discovered service provider and Orchestrate facade. Set ORCHESTRATE_SECRET_KEY in .env, then:

use Orqex\Orchestrate\Laravel\Facades\Orchestrate;

Orchestrate::paymentIntents()->all();

See the Laravel guide.

Custom network routing

Private deployments and split-network environments may route the public API hostname to a specific address while preserving the request Host header and TLS SNI. Laravel applications can configure this without changing application code:

ORCHESTRATE_BASE_URI=https://api.orqex.com/v1
ORCHESTRATE_RESOLVE_IP=192.0.2.10
ORCHESTRATE_CA_BUNDLE=/path/to/private-ca.pem

ORCHESTRATE_RESOLVE_IP is optional and requires the PHP cURL extension. The CA bundle is also optional; when omitted, the system trust store is used. TLS verification remains enabled whenever these routing options are used.

Development

composer test       # PHPUnit
composer analyse    # PHPStan
composer sniff      # php-cs-fixer (dry run)
composer format     # php-cs-fixer (apply)

License

Proprietary. Copyright Orqex. See LICENSE.