> ## Documentation Index > Fetch the complete documentation index at: https://docs.macropay.ai/llms.txt > Use this file to discover all available pages before exploring further. # Introduction > Task-focused, copy-paste guides for shipping payments, subscriptions, usage billing, and AI agent monetization with Macropay. Reference docs tell you what every field does. Guides tell you how to ship a specific outcome — a working checkout, a metered AI product, a subscription upgrade flow — without stitching the pieces together yourself. Each guide is self-contained: a concrete scenario, the exact API calls and SDK snippets, and the result you should see at the end. Because Macropay is your [merchant of record](/merchant-of-record/introduction), most of these flows also mean sales tax, VAT, and PCI scope are handled for you — you wire up the product, we handle the seller-of-record obligations. ## Start here New to Macropay? These three cover the path from zero to your first live payment. Create a product and take your first payment end to end Spin up a hosted, PCI-compliant checkout from the API Receive and verify lifecycle events in your backend ## Pick a guide by what you're building ### Frameworks & SDKs Drop Macropay into your existing stack with a framework adapter or a typed SDK. Wire checkout, the customer portal, and webhooks into a Next.js app Integrate billing into a Laravel application Use the Python SDK to manage products, checkouts, and orders Add Macropay to an Encore backend ### AI & agent billing Monetize models and autonomous agents by usage, activity, or verified outcome — Macropay tracks the AI cost behind each call so you can see margin, not just revenue. Meter token usage, bill per outcome, and route calls through the AI proxy Top up a customer's prepaid usage balance once an order completes Seed trial or free-tier credits before a customer pays Deliver a resource link automatically after a successful purchase ### Subscriptions & plan changes Handle the lifecycle most billing bugs hide in: upgrades, downgrades, proration, and seats. Move a customer to a higher plan and charge correctly Schedule a step-down so it takes effect at the period boundary Control how mid-cycle plan changes are credited and charged Bill per seat and keep counts in sync as a team grows Let one customer hold more than one active subscription Move an existing seat-based plan onto the member model ### Checkout & customer experience Tune what buyers and existing customers see — branding, product order, and self-serve management. Give customers self-serve invoices, upgrades, and cancellations Match checkout to your brand's light and dark themes Control the sequence products appear in Reorder the entitlements shown to buyers Offer multiple variants of a single product Prevent buyers from editing a pre-filled email at checkout ### Account & operations Org setup, merchant-side housekeeping, and scheduled jobs. Run several brands or businesses from one account Update the email on your merchant account Disable subscription edits in the customer portal Trigger a delayed downgrade with a scheduled job Every guide runs against the [sandbox](https://sandbox.macropay.ai) with the same API and SDKs as production — build and test the full flow before going live, with no charges and no risk. ## Missing a guide? If there's a flow you'd like us to document, email [sales@macropay.ai](mailto:sales@macropay.ai) and tell us what you're trying to build.