> ## 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. # Macropay: Turn Your Software into a Business > Merchant-of-Record billing for software and AI agents — global tax handled, PCI absorbed, usage and outcome billing built in.

## Sell software anywhere, skip the back office Macropay is open-source billing infrastructure built around one idea: you should be able to charge money for what you build — a SaaS subscription, a one-time license, or an AI agent that bills by the outcome it delivers — without becoming a tax filer, a PCI auditor, or a disputes desk. We do that as your **Merchant of Record (MoR)**. Macropay is the legal seller on your customer's statement, which means we calculate and remit sales tax, VAT, and GST worldwide, absorb PCI scope, and own the chargeback process. You ship product; the compliance machinery is ours. We sell as the merchant on record, then remit tax and VAT in every jurisdiction you sell into — so your global tax liability stays ours, not yours. Meter by tokens, by activity, or by verified outcome. Agents are first-class: attribute spend, certify ROI, and track margin per agent. ## What you stop worrying about **The problem:** A single global sale can trigger VAT, GST, or sales-tax obligations across dozens of jurisdictions, each with its own rate, threshold, and filing cadence. Most teams either gamble on non-compliance or wall themselves off from international customers. **With Macropay:** As your Merchant of Record we are the legal seller, so we calculate, collect, and remit the tax. Your liability is capped at the relationship with us — see [supported countries and tax handling](/merchant-of-record/fees). **The problem:** Subscriptions, proration, dunning, customer portals, invoices, refunds — each is weeks of work and a permanent maintenance tax on your team. **With Macropay:** A complete billing API ships on day one. Subscription lifecycle, failed-payment recovery, and a self-serve [customer portal](/features/products) are already wired up. Drop in an SDK and start charging. **The problem:** Emailing license keys, sending Discord invites, and adding people to private repos by hand breaks the moment you have real volume. **With Macropay:** Entitlements fire automatically on purchase — license keys, file downloads, [GitHub repo access](/features/benefits/github-access), Discord roles, prepaid credits, and more. Customers are provisioned the instant a payment clears. **The problem:** AI products don't fit flat subscriptions. You pay providers per token, and your customers expect to pay for what they actually use — or for the result they actually got. **With Macropay:** Send usage events to the [meter and credits](/api-reference) primitives, route model calls through our OpenAI-compatible AI proxy to capture token cost automatically, and bill agents on **usage, activity, or outcome**. More on this below. ## What's in the platform ### Products: one model for everything you sell In Macropay, everything you sell is a **product** — whether it's billed once or recurring. The API and data model stay the same; only the pricing and billing logic differ. Templates, courses, perpetual licenses, lifetime deals — paid for once, with instant fulfillment. Recurring billing with automatic renewals, proration, and dunning for failed payments. Fixed, free, pay-what-you-want, seat-based, or usage-based (metered) — mix and match per product. ### Usage-based & AI billing This is where Macropay goes beyond a typical payment processor. Charge for consumption, activity, or — for AI agents — the value actually delivered. Ingest **events**, aggregate them into **meters**, and attach a metered price. Sell **prepaid credits** or grant them, with stream, S3, delta-time, or LLM ingestion strategies. Point your model calls at our OpenAI-compatible endpoint (`POST /ai/v1/chat/completions`). Macropay captures the token cost of every request automatically — no manual metering code. Agents are first-class. The **Signals API** (`POST /v1/signals`) ingests activity and outcome signals attributed to a specific agent, so you can bill on results, not just minutes. **Value receipts** certify ROI — time saved, revenue generated, cost avoided. **Agentic margin** compares billed revenue against AI cost (COGS) per agent, so you always know which agents are profitable. Outcome-based pricing is the cleanest way to monetize an agent: route inference through `/ai/v1` to track COGS, then post the result to `/v1/signals` to bill for the win. The margin between the two is your agentic margin. ### A checkout your customers trust

Card details are tokenized in our **PCI DSS Level 1 compliant** vault, so sensitive data never touches your servers. Pick the integration depth that fits: No code required. Generate a checkout link in the dashboard and drop it into an email, a post, or a button. Keep customers on your domain with a themeable, localized embedded checkout. Create checkout sessions programmatically for fully custom purchase flows. ### Entitlements that fulfill themselves Configure a benefit once and Macropay grants it on every qualifying purchase — no scripts, no support tickets. Generate and deliver keys automatically, with custom formats and activation limits. Securely serve digital assets up to 10GB, with per-customer download tracking. Auto-invite buyers to private repositories and revoke access when a subscription ends. Assign roles and send server invites the moment someone joins a paid tier. ## Get to your first payment [Sign up](https://macropay.ai/signup) with GitHub, Google, or email, then create an organization to hold your products, customers, and payouts.

Create your first [product](/features/products) in a couple of minutes: * Decide one-time or subscription * Set the pricing model — fixed, free, pay-what-you-want, seat-based, or metered * Attach the entitlements that should fulfill on purchase Fastest way to take money today: * Create a [checkout link](/features/checkout/links) in the dashboard * Share it anywhere — email, social, a landing page * Payments start flowing immediately Keep the experience on your site: * Drop in the [embedded checkout](/features/checkout/embed) * Match your branding and locale * Customers never leave your domain Maximum control for custom flows: * Install a [native SDK](/integrate/sdk/typescript) * Build bespoke checkout and provisioning logic * Wire billing into your existing stack Keep your own database in sync as things happen: * Register [webhook endpoints](/integrate/webhooks/endpoints) in the dashboard * React to orders, subscription changes, and customer updates * Verify deliveries with Standard Webhooks signatures and test them locally Webhooks make your system the source of truth for fulfillment beyond the built-in entitlements. ## Integrate with your stack ### Framework adapters Drop-in adapters wire Macropay into your framework's routing and auth so you write less glue code. Full-stack React with App Router support. Billing tied directly into your authentication and authorization layer. First-class PHP support for Laravel applications. A modern, secure TypeScript runtime. Vue.js framework React framework Fast Node.js Cloudflare Workers Full-stack React Bun framework Static site generator Flexible Node.js framework Full-stack framework ### Native SDKs & tooling Web and Node.js applications Django, Flask, FastAPI Go web services WordPress, Laravel, plain PHP Authenticate with OAuth2 or organization access tokens (OAT), test everything in the **sandbox** before going live, and connect agent tooling through our **MCP** server. Here's a metered AI charge, end to end — capture model cost through the proxy, then bill the customer for usage: ```bash cURL theme={null} # Run inference through the AI proxy — token cost is captured automatically curl https://api.macropay.ai/ai/v1/chat/completions \ -H "Authorization: Bearer $MACROPAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{ "role": "user", "content": "Summarize this support ticket." }] }' ``` ```ts TypeScript theme={null} import { Macropay } from "@macropay/sdk"; const macropay = new Macropay({ accessToken: process.env.MACROPAY_API_KEY }); // Record an outcome signal so an agent can bill for the result it delivered await macropay.signals.create({ customerId: "cus_8fK2", agentId: "agent_triage", type: "outcome", name: "ticket_resolved", value: 1, }); ``` ```python Python theme={null} from macropay import Macropay macropay = Macropay(access_token=os.environ["MACROPAY_API_KEY"]) # Ingest a usage event into a meter for metered billing macropay.events.ingest( customer_id="cus_8fK2", name="rows_processed", value=4200, ) ``` ## Who it's for Skip the billing build entirely and spend your time on the product. We handle tax and compliance everywhere, so geography stops being a blocker. Keys, downloads, and access grants are delivered automatically. No setup fees and no monthly minimums — costs scale with revenue. The AI proxy records COGS per request, so margin is never a mystery. Bill for resolved tickets, booked meetings, or code merged — not seats. Compare billed revenue to AI cost for every agent you run. Value receipts quantify time saved and revenue generated for customers. Full API control over products, customers, orders, and subscriptions. Signed, replayable event delivery keeps your systems in sync. A hosted customer portal handles upgrades, invoices, and cancellations. ## Pricing One transparent rate. We only make money when you get paid. **Per successful transaction** No monthly fees, no setup costs, no minimums. **ACH (US) and SEPA (EU)** SWIFT is passed through at cost. No payout markup. A few situational add-ons: **+1.5%** on international (non-US) cards, **+0.5%** on subscriptions, and **\$30 per dispute** regardless of outcome. Full breakdown on the [fees page](/merchant-of-record/fees). ## Start building **Free, no card required** You'll be set up in under two minutes. **Framework tutorials** Step-by-step integration walkthroughs. **Full reference** Endpoints, schemas, and live examples. **Get help fast** Talk to the team and other builders on Discord.