PHP and Laravel - Biqli

The biqli/sdk package supports PHP 8.1 or newer and uses a secret workspace API key.

Install

composer require biqli/sdk

Add the key to your server environment:

BIQLI_API_KEY=biqli_xxxxxxxxxxxxxxxxxxxxxxxx

Create a reusable client

use Biqli\Sdk\Biqli;

$biqli = new Biqli($_ENV['BIQLI_API_KEY'], [
    'clientName' => 'acme-laravel',
    'clientVersion' => '1.0.0',
]);

In Laravel, bind this client as a singleton in a service provider rather than creating it for every event.

Track a lead

$lead = $biqli->track->lead([
    'clickId' => $request->cookie('bq_id'),
    'eventId' => 'signup:' . $user->getKey(),
    'eventName' => 'Signed up',
    'customerExternalId' => (string) $user->getKey(),
    'customerName' => $user->name,
    'customerEmail' => $user->email,
]);

Track a sale

$sale = $biqli->track->sale([
    'customerExternalId' => (string) $user->getKey(),
    'amount' => 4999,
    'currency' => 'usd',
    'paymentProcessor' => 'stripe',
    'invoiceId' => $invoice->id,
]);

Handle errors

use Biqli\Sdk\Exceptions\BiqliException;

try {
    $biqli->track->sale($input);
} catch (BiqliException $error) {
    logger()->error('Biqli tracking failed', [
        'code' => $error->errorCode,
        'status' => $error->status,
        'request_id' => $error->requestId,
        'retryable' => $error->retryable,
        'attempts' => $error->attempts,
    ]);
}

Do not log the API key or the entire unfiltered payload. The SDK retries bounded temporary failures. Stable event and invoice identifiers make retries safe across workers and deployments. See the complete PHP SDK reference.