Fakturácia cez Stripe

use RoundlyConsulting\Purchases\Facades\Purchases;

Purchases::canBill('stripe');   // true — the provider implements Contracts\SupportsBilling
Purchases::canBill('apple');    // false
Purchases::stripe();            // StripeBilling; UnsupportedCapabilityException without a registered Stripe provider

// Dependency injection — the same object behind the facade
public function __construct(private PurchasesManager $purchases) {}
$this->purchases->stripe()->subscriptions()->updateQuantity($seatItem, 11);

use RoundlyConsulting\Purchases\DataTransferObjects\Stripe\{AddressData, CustomerData, TaxIdData};

$customer = Purchases::stripe()->customers()->sync($company, new CustomerData(
    name: 'Acme s.r.o.',
    email: '[email protected]',
    address: new AddressData(line1: 'Hlavná 1', city: 'Bratislava', postalCode: '81101', country: 'SK'),
    taxIds: [new TaxIdData('eu_vat', 'SK2020123456')],
    metadata: ['plan' => 'team'],
    preferredLocale: 'sk',
));

Purchases::stripe()->customers()->id($company);        // 'cus_…' or null
Purchases::stripe()->customers()->owner('cus_…');      // the owner model or null

use RoundlyConsulting\Purchases\DataTransferObjects\Stripe\{CreateSubscriptionData, SubscriptionPrice};
use RoundlyConsulting\Purchases\Providers\Stripe\Enums\{CollectionMethod, PaymentBehavior};

$subscription = Purchases::stripe()->subscriptions()->create($company, new CreateSubscriptionData(
    prices: [
        SubscriptionPrice::licensed('price_seats', 10),   // per seat, quantity 10
        SubscriptionPrice::metered('price_storage_gb'),   // usage-based: no quantity
    ],
    name: 'team',                                         // the local row's name, what subscribedTo() checks
    trialDays: 7,
    automaticTax: true,
    collectionMethod: CollectionMethod::ChargeAutomatically, // or SendInvoice + daysUntilDue
    paymentBehavior: PaymentBehavior::DefaultIncomplete,
    metadata: ['company' => (string) $company->getKey()],
), idempotencyKey: "start-{$company->getKey()}");

use RoundlyConsulting\Purchases\Providers\Stripe\Enums\BillingMode;

Purchases::stripe()->subscriptions()->create($company, new CreateSubscriptionData(
    prices: [
        SubscriptionPrice::licensed('price_licence_yearly'),   // billed every year
        SubscriptionPrice::metered('price_api_calls_monthly'), // usage, billed every month
    ],
    name: 'platform',
    billingMode: BillingMode::Flexible,   // billing_mode[type]=flexible
));

use RoundlyConsulting\Purchases\Providers\Stripe\Enums\MissingPaymentMethod;

Purchases::stripe()->subscriptions()->create($company, new CreateSubscriptionData(
    prices: [SubscriptionPrice::licensed('price_team')],
    trialDays: 14,
    trialEndBehavior: MissingPaymentMethod::Pause,   // trial_settings[end_behavior][missing_payment_method]
));

// config/purchases.php — or PURCHASES_ONE_SUBSCRIPTION_PER_OWNER=true
'subscriptions' => [
    'one_per_owner' => true,
    'lock' => ['store' => 'redis', 'wait' => 10],   // a store with atomic locks, shared by every server
],

Purchases::for($company)->hasOngoingSubscription();   // what the limit checks
Subscription::query()->ongoing()->get();              // every status but canceled, failed and refunded

use RoundlyConsulting\Purchases\DataTransferObjects\Stripe\CheckoutSubscriptionData;
use RoundlyConsulting\Purchases\Providers\Stripe\Enums\PaymentMethodCollection;

$session = Purchases::stripe()->subscriptions()->checkout($company, new CheckoutSubscriptionData(
    prices: [SubscriptionPrice::licensed('price_seats', 10), SubscriptionPrice::metered('price_storage_gb')],
    successUrl: route('billing.done').'?session={CHECKOUT_SESSION_ID}',
    cancelUrl: route('billing'),
    trialDays: 7,
    paymentMethodCollection: PaymentMethodCollection::IfRequired,   // a free trial without a card
    trialEndBehavior: MissingPaymentMethod::Cancel,
    automaticTax: true,          // also sends customer_update[address]=auto, which Stripe Tax needs
));

return redirect($session->url);

use RoundlyConsulting\Purchases\Providers\Stripe\Enums\ProrationBehavior;

$seats = $subscription->itemFor('price_seats');                       // the stored item for a price

Purchases::stripe()->subscriptions()->updateQuantity($seats, $company->members()->count(), ProrationBehavior::CreateProrations);
Purchases::stripe()->subscriptions()->swap($seats, 'price_seats_annual', quantity: 11, proration: ProrationBehavior::AlwaysInvoice);
Purchases::stripe()->subscriptions()->addItem($subscription, 'price_api_calls');          // metered: no quantity
Purchases::stripe()->subscriptions()->removeItem('si_…', ProrationBehavior::None, clearUsage: true);

Purchases::stripe()->subscriptions()->cancelAtPeriodEnd($subscription);   // POST cancel_at_period_end=true
Purchases::stripe()->subscriptions()->resume($subscription);              // POST cancel_at_period_end=false
Purchases::stripe()->subscriptions()->cancel($subscription, invoiceNow: true, prorate: true); // DELETE, now

use RoundlyConsulting\Purchases\DataTransferObjects\Stripe\MeterData;
use RoundlyConsulting\Purchases\Providers\Stripe\Enums\MeterAggregation;

$meter = Purchases::stripe()->meters()->findOrCreate(new MeterData(
    eventName: 'storage_gb_days',
    displayName: 'Storage (GB-days)',
    aggregation: MeterAggregation::Sum,
));

Purchases::stripe()->meters()->report(
    $company,                                   // an owner with a Stripe customer, or 'cus_…'
    'storage_gb_days',
    12.5,                                       // int, float or decimal string — sent as an exact decimal string
    timestamp: now(),
    identifier: "storage-{$company->id}-".today()->toDateString(),
);

$session = Purchases::stripe()->portal($company, returnUrl: route('settings.billing'));
return redirect($session->url);