# Laravel Polar

## Docs

- [LaravelPolar facade: complete API reference](https://laravel-polar.hephaestus.sh/advanced/facade.md): Every method on the LaravelPolar facade, grouped by category — with signatures, parameter types, and return types drawn from the source.
- [Access the Polar SDK directly for advanced use](https://laravel-polar.hephaestus.sh/advanced/sdk-access.md): Use LaravelPolar::sdk() to call any Polar API endpoint not covered by the facade — wallets, OAuth2, file uploads, organization updates, and more.
- [Create reusable checkout links](https://laravel-polar.hephaestus.sh/checkouts/checkout-links.md): Generate persistent Polar-hosted checkout URLs that don't require a user session. Ideal for marketing pages, transactional emails, and static 'Buy now' buttons.
- [Embed Polar checkout in your app](https://laravel-polar.hephaestus.sh/checkouts/embedded-checkout.md): Open a Polar checkout in an overlay on your own page instead of redirecting. Works with Blade, Inertia, React, and Vue with minimal setup.
- [Accept one-time and subscription payments](https://laravel-polar.hephaestus.sh/checkouts/single-payments.md): Send customers to a Polar-hosted checkout with one method call. Supports single products, multi-product selection, custom pricing, redirects, and metadata.
- [The Billable trait: enable billing on any model](https://laravel-polar.hephaestus.sh/concepts/billable.md): Add the Billable trait to any Eloquent model to unlock checkouts, subscriptions, orders, license keys, usage billing, and the full Polar API.
- [Handle Polar.sh webhooks in Laravel](https://laravel-polar.hephaestus.sh/concepts/webhooks.md): Laravel Polar automatically verifies and processes Polar.sh webhooks, dispatching typed Laravel events for every order, subscription, checkout, and more.
- [Configure Laravel Polar: tokens, webhooks, and more](https://laravel-polar.hephaestus.sh/configuration.md): Configure your Polar access token, organization ID, server environment, webhook secret, route path, redirect URL, and currency locale.
- [Automate product benefits with Polar](https://laravel-polar.hephaestus.sh/features/benefits.md): Define automated features that Polar grants when customers purchase your products, and react to grant lifecycle events using typed Laravel webhook events.
- [Collect custom data at checkout with custom fields](https://laravel-polar.hephaestus.sh/features/custom-fields.md): Define structured fields — text, number, date, checkbox, or select — and attach them to checkout sessions to capture data like VAT IDs or seat counts.
- [Manage customers and payment methods](https://laravel-polar.hephaestus.sh/features/customers.md): Redirect customers to Polar's self-service portal, retrieve their saved payment methods, and delete cards programmatically from your Laravel app.
- [Create and apply discount codes with Polar](https://laravel-polar.hephaestus.sh/features/discounts.md): Create reusable coupon codes, apply them at checkout or to existing subscriptions, and manage your full discount catalogue via the LaravelPolar facade.
- [Issue and validate license keys with Polar](https://laravel-polar.hephaestus.sh/features/license-keys.md): Manage license keys as a Polar benefit, validate and activate keys from end-user machines, and retrieve a customer's keys through the Billable trait.
- [Usage-based billing with metered events](https://laravel-polar.hephaestus.sh/features/usage-billing.md): Charge customers based on actual consumption by ingesting usage events into Polar, then query meter balances through the Billable trait and facade.
- [Install Laravel Polar in your Laravel app](https://laravel-polar.hephaestus.sh/installation.md): Install and configure Laravel Polar via Composer, publish migrations and config, exempt webhooks from CSRF, and add the embed script for checkout.
- [Laravel Polar: Polar.sh billing for Laravel](https://laravel-polar.hephaestus.sh/introduction.md): Laravel Polar integrates Polar.sh billing into Laravel 11/12 apps. Add subscriptions, one-time payments, webhooks, license keys, and usage-based billing with a single Billable trait — no custom webhook logic required.
- [Generate and download PDF invoices for orders](https://laravel-polar.hephaestus.sh/orders/invoices.md): Retrieve a PDF invoice URL for any Polar order and redirect customers to download it — with built-in memoization to avoid redundant API calls.
- [Issue refunds for Polar orders](https://laravel-polar.hephaestus.sh/orders/refunds.md): Refund an order in full or partially, attach a reason and comment, and list previous refunds — all from the Order model or the LaravelPolar facade.
- [Retrieve and display customer orders](https://laravel-polar.hephaestus.sh/orders/retrieving.md): Access a user's order history, inspect order attributes and status, and check whether a customer has purchased a specific product.
- [Create subscriptions with Laravel Polar](https://laravel-polar.hephaestus.sh/subscriptions/creating.md): Start a subscription checkout, support multiple subscription types per user, and retrieve subscription state with the Billable trait.
- [Manage subscription status, plans, and cancellation](https://laravel-polar.hephaestus.sh/subscriptions/managing.md): Check subscription status, swap plans, cancel and resume subscriptions, apply discounts, and query subscriptions using built-in scopes.
- [Manage team seats on multi-seat subscriptions](https://laravel-polar.hephaestus.sh/subscriptions/team-seats.md): List, assign, revoke, and resend seat invitations on multi-seat Polar subscriptions directly from your Subscription model or facade.
- [Subscription trials with Laravel Polar](https://laravel-polar.hephaestus.sh/subscriptions/trials.md): Check trial status, read the trial end date, detect expired trials, and update the trial period directly from your subscription model.