README

League OAuth2 Client provider for Fakturoid invoicing platform.

Installation

composer require tomas-kulhanek/oauth2-fakturoid

Usage

Authorization Code Flow

use TomasKulhanek\OAuth2\Fakturoid\FakturoidProvider;

$provider = new FakturoidProvider([
    'clientId'     => 'your-client-id',
    'clientSecret' => 'your-client-secret',
    'redirectUri'  => 'https://your-app.com/callback',
]);

// Step 1: Redirect to authorization
$authUrl = $provider->getAuthorizationUrl();
$_SESSION['oauth2state'] = $provider->getState();
header('Location: ' . $authUrl);
exit;

// Step 2: Handle callback
if ($_GET['state'] !== $_SESSION['oauth2state']) {
    exit('Invalid state');
}

$token = $provider->getAccessToken('authorization_code', [
    'code' => $_GET['code'],
]);

// Step 3: Get resource owner
$owner = $provider->getResourceOwner($token);

echo $owner->getId();
echo $owner->getFullName();
echo $owner->getEmail();
echo $owner->getAvatarUrl();
echo $owner->getDefaultAccount();

Client Credentials Flow

$token = $provider->getAccessToken('client_credentials');

Refreshing a Token

$newToken = $provider->getAccessToken('refresh_token', [
    'refresh_token' => $existingToken->getRefreshToken(),
]);

Accessing Accounts

The resource owner provides access to all Fakturoid accounts the user can manage:

$owner = $provider->getResourceOwner($token);

foreach ($owner->getAccounts() as $account) {
    echo $account['slug'];           // Account URL identifier
    echo $account['name'];           // Account name
    echo $account['permission'];     // 'owner', 'accountant', etc.
    echo $account['registration_no'];// Registration number
}

Fakturoid OAuth Endpoints

License

MIT