ربط الفوترة الإلكترونية مع Laravel

// .env
WONDERFATOORA_API_URL=https://fatoora.tw.sa/api/v1
WONDERFATOORA_API_KEY=wbk_test_xxxxxxxxxxxxxxxxxxxxxxxx

// config/services.php
'wonderfatoora' => [
    'url' => env('WONDERFATOORA_API_URL'),
    'key' => env('WONDERFATOORA_API_KEY'),
],

<?php

namespace App\Billing;

use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Http;

class WonderFatoora
{
    private function http(): PendingRequest
    {
        return Http::baseUrl(config('services.wonderfatoora.url'))
            ->withToken(config('services.wonderfatoora.key'))
            ->acceptJson()
            ->timeout(60)
            // Retry network errors and 5xx only; external_reference keeps
            // a retried call from issuing a second invoice.
            ->retry(3, 2000, fn ($e) => ! $e instanceof \Illuminate\Http\Client\RequestException
                || $e->response->serverError(), throw: false);
    }

    /** @return array the invoice, as the API returns it */
    public function issueForOrder(Order $order): array
    {
        $response = $this->http()->post('invoices', [
            'external_reference' => 'order-'.$order->id,
            'issue_date'         => $order->paid_at->toDateString(),
            'customer'           => ['id' => $order->customer->wonderfatoora_id],
            'items'              => $order->lines->map(fn ($line) => [
                'description' => $line->name,
                'quantity'    => $line->quantity,
                'unit_price'  => $line->unit_price,
            ])->all(),
        ]);

        if (! $response->json('ok')) {
            throw new \RuntimeException($response->json('error.code', 'http_'.$response->status()));
        }

        return $response->json('data.invoice');
    }
}

<?php
// Issue from a queued job, so a slow or failed call never blocks checkout.
class IssueOrderInvoice implements ShouldQueue
{
    use Queueable;

    public int $tries = 5;
    public array $backoff = [10, 60, 300, 900];

    public function __construct(public Order $order) {}

    public function handle(WonderFatoora $api): void
    {
        $invoice = $api->issueForOrder($this->order); // idempotent per order

        $this->order->update([
            'invoice_id'  => $invoice['id'],
            'invoice_url' => $invoice['zatca']['deliverable'] ? $invoice['public_url'] : null,
        ]);
    }
}