composer require payzcore/payzcore-php

use PayzCore\PayzCore;

// Project API (payment monitoring)
$client = new PayzCore('pk_live_YOUR_KEY');

// With options
$client = new PayzCore('pk_live_YOUR_KEY', [
    'baseUrl' => 'https://api.payzcore.com', // optional, default
    'timeout' => 30,                          // optional, seconds
    'maxRetries' => 2,                        // optional, retries on 5xx
]);

// Admin API (project management)
$admin = new PayzCore('mk_YOUR_MASTER_KEY', ['masterKey' => true]);

$result = $client->payments->create([
    'amount' => 50,
    'chain' => 'TRC20',
    'token' => 'USDT',                  // optional
    'externalRef' => 'customer-123',
    'externalOrderId' => 'ORD-456',     // optional
    'expiresIn' => 3600,                // optional
    'metadata' => ['type' => 'topup'],  // optional
]);

$payment = $result['payment'];
echo $payment['address'];  // blockchain address
echo $payment['amount'];   // "50.00"
echo $payment['qrCode'];   // base64 PNG

$result = $client->payments->get('payment-uuid');

$payment = $result['payment'];
echo $payment['status'];       // 'pending', 'paid', etc.
echo $payment['paidAmount'];

$result = $client->payments->list([
    'status' => 'paid',
    'limit' => 25,
    'offset' => 0,
]);

foreach ($result['payments'] as $payment) {
    echo $payment['id'] . ': ' . $payment['status'] . "\n";
}

$result = $client->payments->cancel('payment-uuid');

$result = $client->payments->confirm('payment-uuid', 'abc123def...');
echo $result['verified']; // true if found on blockchain

use PayzCore\Webhook;

use PayzCore\Webhook;

$isValid = Webhook::verifySignature(
    $rawBody,                                    // raw request body string
    $_SERVER['HTTP_X_PAYZCORE_SIGNATURE'],        // signature header
    'whsec_YOUR_SECRET'                          // webhook secret
);

use PayzCore\Webhook;
use PayzCore\Exceptions\WebhookSignatureException;

// Verifies signature and returns a parsed array
// Throws WebhookSignatureException if signature is invalid
try {
    $event = Webhook::constructEvent(
        $rawBody,
        $_SERVER['HTTP_X_PAYZCORE_SIGNATURE'],
        'whsec_YOUR_SECRET'
    );
} catch (WebhookSignatureException $e) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
    exit;
}

echo $event['event'];        // "payment.completed"
echo $event['paymentId'];    // UUID
echo $event['paidAmount'];   // "50.00"

$event = Webhook::constructEvent(
    $rawBody,
    $signature,
    'whsec_YOUR_SECRET',
    $_SERVER['HTTP_X_PAYZCORE_TIMESTAMP'] ?? null, // optional timestamp header
    300                                             // tolerance in seconds (default)
);

use Illuminate\Http\Request;
use PayzCore\Webhook;
use PayzCore\Exceptions\WebhookSignatureException;

Route::post('/webhooks/payzcore', function (Request $request) {
    $body = $request->getContent();
    $signature = $request->header('x-payzcore-signature');

    try {
        $event = Webhook::constructEvent(
            $body,
            $signature,
            config('services.payzcore.webhook_secret')
        );
    } catch (WebhookSignatureException $e) {
        return response()->json(['error' => 'Invalid signature'], 401);
    }

    switch ($event['event']) {
        case 'payment.completed':
            User::where('external_id', $event['externalRef'])
                ->increment('balance', (float) $event['paidAmount']);
            break;
        case 'payment.expired':
            // Handle expired payment
            break;
    }

    return response()->json(['ok' => true]);
});

use PayzCore\Webhook;
use PayzCore\Exceptions\WebhookSignatureException;

$body = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_PAYZCORE_SIGNATURE'] ?? '';

try {
    $event = Webhook::constructEvent($body, $signature, 'whsec_YOUR_SECRET');
} catch (WebhookSignatureException $e) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
    exit;
}

if ($event['event'] === 'payment.completed') {
    // Process payment
    // $event['externalRef'], $event['paidAmount'], etc.
}

http_response_code(200);
echo json_encode(['ok' => true]);

use PayzCore\Exceptions\PayzCoreException;
use PayzCore\Exceptions\ValidationException;
use PayzCore\Exceptions\AuthenticationException;
use PayzCore\Exceptions\RateLimitException;

try {
    $result = $client->payments->create([...]);
} catch (ValidationException $e) {
    echo "Invalid request: {$e->getMessage()} (details: " . json_encode($e->getDetails()) . ")";
} catch (AuthenticationException $e) {
    echo "Auth error: {$e->getMessage()}";
} catch (RateLimitException $e) {
    echo "Rate limited: {$e->getMessage()}";
} catch (PayzCoreException $e) {
    echo "Error {$e->getStatusCode()}: {$e->getMessage()}";
}