PHP SDK - Biqli

biqli/sdk requires PHP 8.1 or newer and a secret workspace API key.

composer require biqli/sdk

use Biqli\Sdk\Biqli;

$biqli = new Biqli($_ENV['BIQLI_API_KEY']);

Constructor options

Pass options as the second constructor argument:

$biqli = new Biqli($_ENV['BIQLI_API_KEY'], [
    'timeoutMs' => 10000,
    'clientName' => 'acme-laravel',
    'clientVersion' => '1.0.0',
    'retry' => [
        'maxRetries' => 2,
        'baseDelayMs' => 250,
        'maxDelayMs' => 5000,
        'jitter' => true,
    ],
]);

Option	Default	Description
`baseUrl`	`https://biq.li/api`	API base URL
`timeoutMs`	`10000`	Connect and request timeout per attempt, up to 120 seconds
`clientName`	SDK name	Diagnostic client header
`clientVersion`	SDK version	Diagnostic version header
`retry.maxRetries`	`2`	Retries after the first attempt, up to 8
`retry.baseDelayMs`	`250`	Initial retry delay
`retry.maxDelayMs`	`5000`	Maximum retry delay, up to 60 seconds
`retry.jitter`	`true`	Randomize delays
`httpClient`	New Guzzle client	Custom `ClientInterface` for testing or integration

Methods

$lead = $biqli->track->lead($input, $options);
$sale = $biqli->track->sale($input, $options);

The optional request array accepts idempotencyKey and requestId. Inputs match the lead and sale API schemas. Results are associative arrays matching the endpoint responses.

Exceptions

use Biqli\Sdk\Exceptions\BiqliException;

BiqliException exposes:

$errorCode
$status
$requestId
$details
$retryable
$attempts

The SDK retries network errors and HTTP 408, 425, 429, and 5xx. It honors a valid Retry-After response up to 60 seconds. For durable replay across processes, supply a lead eventId or a sale paymentProcessor plus invoiceId. See PHP and Laravel for a complete implementation.