# Macropay

> Payments & Billing with 6 lines of code. Global Merchant of Record.

## Docs

- [Create Benefit](https://docs.macropay.ai/api-reference/benefits/create.md): Create a benefit.
- [Delete Benefit](https://docs.macropay.ai/api-reference/benefits/delete.md): Delete a benefit.
- [Get Benefit](https://docs.macropay.ai/api-reference/benefits/get.md): Get a benefit by ID.
- [List Benefits](https://docs.macropay.ai/api-reference/benefits/list.md): List benefits.
- [List Benefit Grants](https://docs.macropay.ai/api-reference/benefits/list-grants.md): List the individual grants for a benefit.
- [Update Benefit](https://docs.macropay.ai/api-reference/benefits/update.md): Update a benefit.
- [Create Checkout Link](https://docs.macropay.ai/api-reference/checkout-links/create.md): Create a checkout link.
- [Delete Checkout Link](https://docs.macropay.ai/api-reference/checkout-links/delete.md): Delete a checkout link.
- [Get Checkout Link](https://docs.macropay.ai/api-reference/checkout-links/get.md): Get a checkout link by ID.
- [List Checkout Links](https://docs.macropay.ai/api-reference/checkout-links/list.md): List checkout links.
- [Update Checkout Link](https://docs.macropay.ai/api-reference/checkout-links/update.md): Update a checkout link.
- [Confirm Checkout Session from Client](https://docs.macropay.ai/api-reference/checkouts/confirm-session-from-client.md): Confirm a checkout session by client secret.
- [Create Checkout Session](https://docs.macropay.ai/api-reference/checkouts/create-session.md): Create a checkout session.
- [Get Checkout Session](https://docs.macropay.ai/api-reference/checkouts/get-session.md): Get a checkout session by ID.
- [Get Checkout Session from Client](https://docs.macropay.ai/api-reference/checkouts/get-session-from-client.md): Get a checkout session by client secret.
- [List Checkout Sessions](https://docs.macropay.ai/api-reference/checkouts/list-sessions.md): List checkout sessions.
- [Update Checkout Session](https://docs.macropay.ai/api-reference/checkouts/update-session.md): Update a checkout session.
- [Update Checkout Session from Client](https://docs.macropay.ai/api-reference/checkouts/update-session-from-client.md): Update a checkout session by client secret.
- [Create Custom Field](https://docs.macropay.ai/api-reference/custom-fields/create.md): Create a custom field.
- [Delete Custom Field](https://docs.macropay.ai/api-reference/custom-fields/delete.md): Delete a custom field.
- [Get Custom Field](https://docs.macropay.ai/api-reference/custom-fields/get.md): Get a custom field by ID.
- [List Custom Fields](https://docs.macropay.ai/api-reference/custom-fields/list.md): List custom fields.
- [Update Custom Field](https://docs.macropay.ai/api-reference/custom-fields/update.md): Update a custom field.
- [Get Customer Meter](https://docs.macropay.ai/api-reference/customer-meters/get.md): Get a customer meter by ID.
- [List Customer Meters](https://docs.macropay.ai/api-reference/customer-meters/list.md): List customer meters.
- [Get](https://docs.macropay.ai/api-reference/customer-portal/downloadables/get.md)
- [List Downloadables](https://docs.macropay.ai/api-reference/customer-portal/downloadables/list.md): **Scopes**: `customer_portal:read` `customer_portal:write`
- [Get Customer](https://docs.macropay.ai/api-reference/customer-portal/get-customer.md): Get authenticated customer.
- [Get Organization](https://docs.macropay.ai/api-reference/customer-portal/get-organization.md): Get a customer portal's organization by slug.
- [Activate License Key](https://docs.macropay.ai/api-reference/customer-portal/license-keys/activate.md): Activate a license key instance.
- [Deactivate License Key](https://docs.macropay.ai/api-reference/customer-portal/license-keys/deactivate.md): Deactivate a license key instance.
- [Get License Key](https://docs.macropay.ai/api-reference/customer-portal/license-keys/get.md): Get a license key.
- [List License Keys](https://docs.macropay.ai/api-reference/customer-portal/license-keys/list.md): **Scopes**: `customer_portal:read` `customer_portal:write`
- [Validate License Key](https://docs.macropay.ai/api-reference/customer-portal/license-keys/validate.md): Validate a license key.
- [Get Order](https://docs.macropay.ai/api-reference/customer-portal/orders/get.md): Get an order by ID for the authenticated customer.
- [Get Order Invoice](https://docs.macropay.ai/api-reference/customer-portal/orders/get-invoice.md): Get an order's invoice data.
- [List Orders](https://docs.macropay.ai/api-reference/customer-portal/orders/list.md): List orders of the authenticated customer.
- [Update Order](https://docs.macropay.ai/api-reference/customer-portal/orders/patch.md): Update an order for the authenticated customer.
- [Generate Order Invoice](https://docs.macropay.ai/api-reference/customer-portal/orders/post-invoice.md): Trigger generation of an order's invoice.
- [Assign Seat](https://docs.macropay.ai/api-reference/customer-portal/seats/assign.md)
- [List Seats](https://docs.macropay.ai/api-reference/customer-portal/seats/list.md): **Scopes**: `customer_portal:read` `customer_portal:write`
- [List Claimed Subscriptions](https://docs.macropay.ai/api-reference/customer-portal/seats/list-subscriptions.md): List all subscriptions where the authenticated customer has claimed a seat.
- [Resend Invitation](https://docs.macropay.ai/api-reference/customer-portal/seats/resend.md)
- [Revoke Seat](https://docs.macropay.ai/api-reference/customer-portal/seats/revoke.md)
- [Create Customer Session](https://docs.macropay.ai/api-reference/customer-portal/sessions/create.md): Create a customer session.
- [Cancel Subscription](https://docs.macropay.ai/api-reference/customer-portal/subscriptions/cancel.md): Cancel a subscription of the authenticated customer.
- [Get Subscription](https://docs.macropay.ai/api-reference/customer-portal/subscriptions/get.md): Get a subscription for the authenticated customer.
- [List Subscriptions](https://docs.macropay.ai/api-reference/customer-portal/subscriptions/list.md): List subscriptions of the authenticated customer.
- [Update Subscription](https://docs.macropay.ai/api-reference/customer-portal/subscriptions/update.md): Update a subscription of the authenticated customer.
- [Assign Seat](https://docs.macropay.ai/api-reference/customer-seats/assign.md): **Scopes**: `customer_seats:write`
- [Claim Seat](https://docs.macropay.ai/api-reference/customer-seats/claim.md)
- [Get Claim Info](https://docs.macropay.ai/api-reference/customer-seats/get-claim-info.md)
- [List Seats](https://docs.macropay.ai/api-reference/customer-seats/list.md): **Scopes**: `customer_seats:write`
- [Resend Invitation](https://docs.macropay.ai/api-reference/customer-seats/resend.md): **Scopes**: `customer_seats:write`
- [Revoke Seat](https://docs.macropay.ai/api-reference/customer-seats/revoke.md): **Scopes**: `customer_seats:write`
- [Create Customer](https://docs.macropay.ai/api-reference/customers/create.md): Create a customer.
- [Delete Customer](https://docs.macropay.ai/api-reference/customers/delete.md): Delete a customer.
- [Delete Customer by External ID](https://docs.macropay.ai/api-reference/customers/delete-external.md): Delete a customer by external ID.
- [Get Customer](https://docs.macropay.ai/api-reference/customers/get.md): Get a customer by ID.
- [Get Customer by External ID](https://docs.macropay.ai/api-reference/customers/get-external.md): Get a customer by external ID.
- [List Customers](https://docs.macropay.ai/api-reference/customers/list.md): List customers.
- [Get Customer State](https://docs.macropay.ai/api-reference/customers/state.md): Get a customer state by ID.
- [Get Customer State by External ID](https://docs.macropay.ai/api-reference/customers/state-external.md): Get a customer state by external ID.
- [Update Customer](https://docs.macropay.ai/api-reference/customers/update.md): Update a customer.
- [Update Customer by External ID](https://docs.macropay.ai/api-reference/customers/update-external.md): Update a customer by external ID.
- [Create Discount](https://docs.macropay.ai/api-reference/discounts/create.md): Create a discount.
- [Delete Discount](https://docs.macropay.ai/api-reference/discounts/delete.md): Delete a discount.
- [Get Discount](https://docs.macropay.ai/api-reference/discounts/get.md): Get a discount by ID.
- [List Discounts](https://docs.macropay.ai/api-reference/discounts/list.md): List discounts.
- [Update Discount](https://docs.macropay.ai/api-reference/discounts/update.md): Update a discount.
- [Get Event](https://docs.macropay.ai/api-reference/events/get.md): Get an event by ID.
- [Ingest Events](https://docs.macropay.ai/api-reference/events/ingest.md): Ingest batch of events.
- [List Events](https://docs.macropay.ai/api-reference/events/list.md): List events.
- [Complete File Upload](https://docs.macropay.ai/api-reference/files/complete-upload.md): Complete a file upload.
- [Create File](https://docs.macropay.ai/api-reference/files/create.md): Create a file.
- [Delete File](https://docs.macropay.ai/api-reference/files/delete.md): Delete a file.
- [List Files](https://docs.macropay.ai/api-reference/files/list.md): List files.
- [Update File](https://docs.macropay.ai/api-reference/files/update.md): Update a file.
- [API Overview](https://docs.macropay.ai/api-reference/introduction.md): Base URLs, authentication, pagination, rate limits, error handling, idempotency, and the difference between the Core API and the Customer Portal API
- [Activate License Key](https://docs.macropay.ai/api-reference/license-keys/activate.md): Activate a license key instance.
- [Deactivate License Key](https://docs.macropay.ai/api-reference/license-keys/deactivate.md): Deactivate a license key instance.
- [Get License Key](https://docs.macropay.ai/api-reference/license-keys/get.md): Get a license key.
- [Get Activation](https://docs.macropay.ai/api-reference/license-keys/get-activation.md): Get a license key activation.
- [List License Keys](https://docs.macropay.ai/api-reference/license-keys/list.md): Get license keys connected to the given organization & filters.
- [Update License Key](https://docs.macropay.ai/api-reference/license-keys/update.md): Update a license key.
- [Validate License Key](https://docs.macropay.ai/api-reference/license-keys/validate.md): Validate a license key.
- [Create Meter](https://docs.macropay.ai/api-reference/meters/create.md): Create a meter.
- [Get Meter](https://docs.macropay.ai/api-reference/meters/get.md): Get a meter by ID.
- [Get Meter Quantities](https://docs.macropay.ai/api-reference/meters/get-quantities.md): Get quantities of a meter over a time period.
- [List Meters](https://docs.macropay.ai/api-reference/meters/list.md): List meters.
- [Update Meter](https://docs.macropay.ai/api-reference/meters/update.md): Update a meter.
- [Get Metrics](https://docs.macropay.ai/api-reference/metrics/get.md): Get metrics about your orders and subscriptions.
- [Get Metrics Limits](https://docs.macropay.ai/api-reference/metrics/get-limits.md): Get the interval limits for the metrics endpoint.
- [Authorize](https://docs.macropay.ai/api-reference/oauth2/connect/authorize.md)
- [Get User Info](https://docs.macropay.ai/api-reference/oauth2/connect/get-user-info.md): Get information about the authenticated user.
- [Introspect Token](https://docs.macropay.ai/api-reference/oauth2/connect/introspect-token.md): Get information about an access token.
- [Request Token](https://docs.macropay.ai/api-reference/oauth2/connect/request-token.md): Request an access token using a valid grant.
- [Revoke Token](https://docs.macropay.ai/api-reference/oauth2/connect/revoke-token.md): Revoke an access token or a refresh token.
- [Get Order](https://docs.macropay.ai/api-reference/orders/get.md): Get an order by ID.
- [Get Order Invoice](https://docs.macropay.ai/api-reference/orders/get-invoice.md): Get an order's invoice data.
- [List Orders](https://docs.macropay.ai/api-reference/orders/list.md): List orders.
- [Update Order](https://docs.macropay.ai/api-reference/orders/patch.md): Update an order.
- [Generate Order Invoice](https://docs.macropay.ai/api-reference/orders/post-invoice.md): Trigger generation of an order's invoice.
- [Create Organization](https://docs.macropay.ai/api-reference/organizations/create.md): Create an organization.
- [Get Organization](https://docs.macropay.ai/api-reference/organizations/get.md): Get an organization by ID.
- [List Organizations](https://docs.macropay.ai/api-reference/organizations/list.md): List organizations.
- [Update Organization](https://docs.macropay.ai/api-reference/organizations/update.md): Update an organization.
- [Create Product](https://docs.macropay.ai/api-reference/products/create.md): Create a product.
- [Get Product](https://docs.macropay.ai/api-reference/products/get.md): Get a product by ID.
- [List Products](https://docs.macropay.ai/api-reference/products/list.md): List products.
- [Update Product](https://docs.macropay.ai/api-reference/products/update.md): Update a product.
- [Update Product Benefits](https://docs.macropay.ai/api-reference/products/update-benefits.md): Update benefits granted by a product.
- [Create Refund](https://docs.macropay.ai/api-reference/refunds/create.md): Create a refund.
- [List Refunds](https://docs.macropay.ai/api-reference/refunds/list.md): List refunds.
- [Create Subscription](https://docs.macropay.ai/api-reference/subscriptions/create.md): Create a subscription programmatically.
- [Get Subscription](https://docs.macropay.ai/api-reference/subscriptions/get.md): Get a subscription by ID.
- [List Subscriptions](https://docs.macropay.ai/api-reference/subscriptions/list.md): List subscriptions.
- [Revoke Subscription](https://docs.macropay.ai/api-reference/subscriptions/revoke.md): Revoke a subscription, i.e cancel immediately.
- [Update Subscription](https://docs.macropay.ai/api-reference/subscriptions/update.md): Update a subscription.
- [benefit.created](https://docs.macropay.ai/api-reference/webhooks/benefit.created.md)
- [benefit.updated](https://docs.macropay.ai/api-reference/webhooks/benefit.updated.md)
- [benefit_grant.created](https://docs.macropay.ai/api-reference/webhooks/benefit_grant.created.md)
- [benefit_grant.cycled](https://docs.macropay.ai/api-reference/webhooks/benefit_grant.cycled.md)
- [benefit_grant.revoked](https://docs.macropay.ai/api-reference/webhooks/benefit_grant.revoked.md)
- [benefit_grant.updated](https://docs.macropay.ai/api-reference/webhooks/benefit_grant.updated.md)
- [checkout.created](https://docs.macropay.ai/api-reference/webhooks/checkout.created.md)
- [checkout.expired](https://docs.macropay.ai/api-reference/webhooks/checkout.expired.md)
- [checkout.updated](https://docs.macropay.ai/api-reference/webhooks/checkout.updated.md)
- [customer.created](https://docs.macropay.ai/api-reference/webhooks/customer.created.md)
- [customer.deleted](https://docs.macropay.ai/api-reference/webhooks/customer.deleted.md)
- [customer.state_changed](https://docs.macropay.ai/api-reference/webhooks/customer.state_changed.md)
- [customer.updated](https://docs.macropay.ai/api-reference/webhooks/customer.updated.md)
- [customer_seat.assigned](https://docs.macropay.ai/api-reference/webhooks/customer_seat.assigned.md)
- [customer_seat.claimed](https://docs.macropay.ai/api-reference/webhooks/customer_seat.claimed.md)
- [customer_seat.revoked](https://docs.macropay.ai/api-reference/webhooks/customer_seat.revoked.md)
- [Create Webhook Endpoint](https://docs.macropay.ai/api-reference/webhooks/endpoints/create.md): Create a webhook endpoint.
- [Delete Webhook Endpoint](https://docs.macropay.ai/api-reference/webhooks/endpoints/delete.md): Delete a webhook endpoint.
- [Get Webhook Endpoint](https://docs.macropay.ai/api-reference/webhooks/endpoints/get.md): Get a webhook endpoint by ID.
- [List Webhook Endpoints](https://docs.macropay.ai/api-reference/webhooks/endpoints/list.md): List webhook endpoints.
- [Update Webhook Endpoint](https://docs.macropay.ai/api-reference/webhooks/endpoints/update.md): Update a webhook endpoint.
- [member.created](https://docs.macropay.ai/api-reference/webhooks/member.created.md)
- [member.deleted](https://docs.macropay.ai/api-reference/webhooks/member.deleted.md)
- [member.updated](https://docs.macropay.ai/api-reference/webhooks/member.updated.md)
- [order.created](https://docs.macropay.ai/api-reference/webhooks/order.created.md)
- [order.paid](https://docs.macropay.ai/api-reference/webhooks/order.paid.md)
- [order.refunded](https://docs.macropay.ai/api-reference/webhooks/order.refunded.md)
- [order.updated](https://docs.macropay.ai/api-reference/webhooks/order.updated.md)
- [organization.updated](https://docs.macropay.ai/api-reference/webhooks/organization.updated.md)
- [product.created](https://docs.macropay.ai/api-reference/webhooks/product.created.md)
- [product.updated](https://docs.macropay.ai/api-reference/webhooks/product.updated.md)
- [refund.created](https://docs.macropay.ai/api-reference/webhooks/refund.created.md)
- [refund.updated](https://docs.macropay.ai/api-reference/webhooks/refund.updated.md)
- [subscription.active](https://docs.macropay.ai/api-reference/webhooks/subscription.active.md)
- [subscription.canceled](https://docs.macropay.ai/api-reference/webhooks/subscription.canceled.md)
- [subscription.created](https://docs.macropay.ai/api-reference/webhooks/subscription.created.md)
- [subscription.past_due](https://docs.macropay.ai/api-reference/webhooks/subscription.past_due.md)
- [subscription.revoked](https://docs.macropay.ai/api-reference/webhooks/subscription.revoked.md)
- [subscription.uncanceled](https://docs.macropay.ai/api-reference/webhooks/subscription.uncanceled.md)
- [subscription.updated](https://docs.macropay.ai/api-reference/webhooks/subscription.updated.md)
- [How to Bill for LLM Inference: The Complete Guide](https://docs.macropay.ai/blog/ai-inference-billing-guide.md): Meter tokens, protect your margin, and collect payment for AI inference — with global tax handled for you. DIY metering vs. managed billing, compared.
- [Macropay vs Paddle: Which Merchant of Record Is Right for You?](https://docs.macropay.ai/blog/macropay-vs-paddle.md): Macropay vs Paddle compared: pricing, tax handling as Merchant of Record, AI and agent billing, SDKs, and a step-by-step migration path.
- [Why a Merchant of Record Beats Stripe for SaaS Companies](https://docs.macropay.ai/blog/why-mor-beats-stripe.md): Stripe processes the payment but leaves you the tax bill. See why a Merchant of Record like Macropay ships global, compliant billing for one flat fee.
- [API Changelog](https://docs.macropay.ai/changelog/api.md): Stay up to date with the latest changes, improvements and deprecations to the Macropay API.
- [Product Updates](https://docs.macropay.ai/changelog/recent.md): Stay up to date with the latest changes and improvements to Macropay.
- [For affiliates](https://docs.macropay.ai/features/affiliates/for-affiliates.md): Promote a merchant, earn commission. Apply, grab your referral link, and track clicks, conversions, and payouts in one portal.
- [Affiliates](https://docs.macropay.ai/features/affiliates/introduction.md): Run a native affiliate program inside Macropay — recruit partners, track referrals, and pay commission on the sales they drive.
- [Earnings & payouts](https://docs.macropay.ai/features/affiliates/payouts.md): Track accrued affiliate commission, export it for accounting, and mark conversions paid once you settle with your affiliates.
- [Set up affiliates](https://docs.macropay.ai/features/affiliates/setup.md): Launch a merchant affiliate program in minutes — set commissions, share an apply link, approve partners, and attribute sales automatically.
- [Agents](https://docs.macropay.ai/features/agents/introduction.md): Treat every AI agent as a billable unit — bill by usage, activity, or outcome, and prove its margin and ROI with a certified value receipt.
- [Agentic Margin](https://docs.macropay.ai/features/agents/margin.md): See revenue vs. AI cost (COGS) per agent so you know which agents make money — captured automatically from every proxied model call.
- [Agent SDK](https://docs.macropay.ai/features/agents/sdk.md): Instrument an AI agent in a few lines of Python or TypeScript — route LLM calls through the proxy, report outcomes, and bill on results.
- [Signals API](https://docs.macropay.ai/features/agents/signals.md): Report what an AI agent did and achieved. Ingest activity and outcome signals to bill on results and prove agent value.
- [Value Receipts](https://docs.macropay.ai/features/agents/value-receipts.md): Generate a certified ROI statement for any agent — human value equivalent, time saved, cost savings, revenue, and risk avoided, with a verified-value split.
- [Analytics](https://docs.macropay.ai/features/analytics.md): A zero-setup dashboard for revenue, conversion, cost, and agent margin — MRR and AI COGS computed for you, no BI tool or SQL required.
- [Credits Benefit](https://docs.macropay.ai/features/benefits/credits.md): Grant prepaid usage credits that top up a customer's meter balance automatically
- [Custom Benefit](https://docs.macropay.ai/features/benefits/custom.md): Deliver a private note or build your own entitlement logic for paying customers
- [Automate Discord Invites & Roles](https://docs.macropay.ai/features/benefits/discord-access.md): Grant Discord invites and tier-based roles automatically when customers buy or subscribe
- [Automate Customer File Downloads](https://docs.macropay.ai/features/benefits/file-downloads.md): Attach downloadable files to any product and let Macropay deliver secure, signed URLs to every buyer automatically
- [Automate Private GitHub Repo(s) Access](https://docs.macropay.ai/features/benefits/github-access.md): Grant and revoke private GitHub repo access automatically on every purchase, subscription, and cancellation.
- [Automated Benefits](https://docs.macropay.ai/features/benefits/introduction.md): Provision what a customer paid for the instant they pay — license keys, downloads, repo and Discord access, and prepaid credits — and revoke it the moment they stop.
- [Automate Customer License Key Management](https://docs.macropay.ai/features/benefits/license-keys.md): Issue, validate, and revoke software license keys automatically — no key server to build, no sales tax to remit.
- [Basis Theory checkout](https://docs.macropay.ai/features/checkout/basis-theory.md): Card data is tokenized in a PCI DSS Level 1 vault and never touches your servers or Macropay's
- [Embedded Checkout](https://docs.macropay.ai/features/checkout/embed.md): Sell from inside your own site — no redirect, no PCI scope, tax handled for you
- [Checkout Links](https://docs.macropay.ai/features/checkout/links.md): Share a URL, sell a product. Macropay handles tax, compliance, and the checkout — no code required.
- [Checkout Localization](https://docs.macropay.ai/features/checkout/localization.md): Show checkout in the buyer's own language to lift conversion worldwide
- [Checkout API](https://docs.macropay.ai/features/checkout/session.md): Build your own checkout flow and let us handle tax, fraud, and PCI as merchant of record.
- [Cost Events](https://docs.macropay.ai/features/cost-insights/cost-events.md): Attach a _cost tag to any ingested event to track spend and margin next to revenue
- [Cost Traces](https://docs.macropay.ai/features/cost-insights/cost-traces.md): Roll up per-event costs into sessions to see the true cost of every agent run, conversation, or workflow
- [Introduction to Cost Insights](https://docs.macropay.ai/features/cost-insights/introduction.md): Attach cost data to your events to see true profit, margin, and LTV per customer
- [Custom Fields](https://docs.macropay.ai/features/custom-fields.md): Capture extra data at checkout — consent, attribution, anything you need — and read it back from Orders and Subscriptions.
- [Customer Management](https://docs.macropay.ai/features/customer-management.md): A single source of truth for every buyer — orders, subscriptions, metadata, and your own IDs.
- [Customer Portal](https://docs.macropay.ai/features/customer-portal.md): A self-serve hub where customers manage subscriptions, orders, receipts, and benefits — no support tickets required.
- [Discounts](https://docs.macropay.ai/features/discounts.md): Run promos and coupons on any product or subscription — tax-correct, MoR-handled, code or auto-applied
- [Setup a Payout Account](https://docs.macropay.ai/features/finance/accounts.md): Register the bank account Macropay pays you into — ACH, SEPA, or SWIFT — and clear KYC once to unlock payouts.
- [Account Balance & Transparent Fees](https://docs.macropay.ai/features/finance/balance.md): See exactly what you've earned and what's left to pay out — no hidden fees, tax handled for you
- [Merchant of Record payouts (bank wire)](https://docs.macropay.ai/features/finance/mor-bank-wire.md): Macropay sells under its own name, remits your tax, then wires your share to your bank on NET terms — no Connect handoff.
- [Payouts](https://docs.macropay.ai/features/finance/payouts.md): Move your earnings from Macropay to your bank on your schedule — no payout fee, free ACH and SEPA.
- [Macropay Integration in Fernand](https://docs.macropay.ai/features/integrations/fernand.md): Surface Macropay billing, plan, and order history inside Fernand so support agents answer with full context.
- [Macropay MCP Server](https://docs.macropay.ai/features/integrations/mcp.md): Run your Macropay billing from any AI client — refunds, MRR, churn, plan changes — over one OAuth-secured MCP connection.
- [Agentic Commerce via MCP](https://docs.macropay.ai/features/integrations/mcp-agentic-commerce.md): Let a connected AI agent act on your billing — create checkouts and record usage — not just read it. Off by default, opt-in per organization.
- [Purchase Power Parity with ParityDeals](https://docs.macropay.ai/features/integrations/paritydeals.md): Auto-localize prices by country with ParityDeals — discounts created and managed on Macropay via OAuth.
- [Macropay for Slack](https://docs.macropay.ai/features/integrations/slack.md): Pipe live payments, refunds, disputes and a daily revenue digest straight into Slack — no dashboard tab required.
- [x402 Agentic Payments](https://docs.macropay.ai/features/integrations/x402.md): Let an AI agent pay for a resource autonomously over HTTP 402 — no human, no card. Macropay is the facilitator; settlement draws down a prepaid wallet.
- [Bill for LLM inference](https://docs.macropay.ai/features/llm-inference.md): Resell OpenAI, Anthropic, and Google models through one OpenAI-compatible URL — metered, marked up, and billed as Merchant of Record.
- [Orders & Subscriptions](https://docs.macropay.ai/features/orders.md): Track every sale, subscription, and checkout — with tax already remitted and disputes handled as your Merchant of Record.
- [Products](https://docs.macropay.ai/features/products.md): Model anything you sell — one-time, subscription, or usage — as a single product object on Macropay.
- [Manage Refunds](https://docs.macropay.ai/features/refunds.md): Issue full or partial refunds on any order, revoke benefits, and let Macropay proactively head off chargebacks as your Merchant of Record.
- [Seat-Based Pricing](https://docs.macropay.ai/features/seat-based-pricing.md): Sell to teams with assignable seats, volume tiers, and per-seat benefit grants — tax handled as Merchant of Record.
- [Trials](https://docs.macropay.ai/features/trials.md): Let customers try a subscription before they pay — Macropay collects the card, defers the charge, and remits tax when billing begins.
- [Billing](https://docs.macropay.ai/features/usage-based-billing/billing.md): Price and invoice metered usage on subscriptions — with tax remitted for you as Merchant of Record.
- [Credits](https://docs.macropay.ai/features/usage-based-billing/credits.md): Prepaid balances for usage-based billing — grant credits, draw them down per event, and bill only the overage
- [Event Ingestion](https://docs.macropay.ai/features/usage-based-billing/event-ingestion.md): Send usage events to Macropay and turn raw activity into metered, tax-handled revenue
- [Delta Time Strategy](https://docs.macropay.ai/features/usage-based-billing/ingestion-strategies/delta-time-strategy.md): Meter wall-clock execution time and bill per millisecond of compute
- [Strategy Introduction](https://docs.macropay.ai/features/usage-based-billing/ingestion-strategies/ingestion-strategy.md): Pick the right ingestion strategy to meter LLM tokens, streamed bytes, file uploads, or elapsed time — and bill on it automatically.
- [LLM Strategy](https://docs.macropay.ai/features/usage-based-billing/ingestion-strategies/llm-strategy.md): Auto-meter LLM token usage per customer and bill on usage, activity, or outcome — tax and compliance handled.
- [S3 Strategy](https://docs.macropay.ai/features/usage-based-billing/ingestion-strategies/s3-strategy.md): Meter S3 storage and upload usage automatically — wrap your S3 client, bill the bytes, and let Macropay handle tax as Merchant of Record.
- [Stream Strategy](https://docs.macropay.ai/features/usage-based-billing/ingestion-strategies/stream-strategy.md): Meter bytes flowing through any Node Readable or Writable stream — no manual event calls
- [Introduction](https://docs.macropay.ai/features/usage-based-billing/introduction.md): Meter real usage, then bill for it — tax, compliance, and AI/agent costs handled as Merchant of Record.
- [Meters](https://docs.macropay.ai/features/usage-based-billing/meters.md): Turn raw usage events into billable units — define meters that filter, aggregate, and price what your customers and AI agents actually consume.
- [Set up agent billing](https://docs.macropay.ai/guides/agent-billing-setup.md): Bill an AI agent end to end: create it, pick a billing model, meter token and tool cost, then read live margin and a certified ROI receipt.
- [AI/LLM Billing Setup](https://docs.macropay.ai/guides/ai-billing.md): Meter tokens automatically, bill customers for AI usage, and watch your per-customer margins — without writing billing code
- [How to allow multiple subscriptions per customer](https://docs.macropay.ai/guides/allow-multiple-subscriptions-per-customer.md): Let one customer hold several active subscriptions at once — ideal for multi-product, multi-seat, and per-agent billing.
- [How to automatically share links to customers after purchase](https://docs.macropay.ai/guides/automate-post-purchase-link-sharing.md): Use a Custom Benefit to deliver private links, docs, or onboarding steps to every customer automatically the moment payment clears.
- [How to Change Account Email (as a Merchant)](https://docs.macropay.ai/guides/change-email-as-merchant.md): Update the email on your Macropay merchant account in six verified steps — with no interruption to payouts, tax remittance, or billing.
- [How to Create Checkout Session](https://docs.macropay.ai/guides/create-checkout-session.md): Spin up a hosted, tax-handled checkout for any product with a single API call.
- [How to Create Multiple Organizations](https://docs.macropay.ai/guides/create-multiple-organizations.md): Run separate brands, clients, or agents under one login — each with its own products, payouts, and tax handling.
- [How to create product variants](https://docs.macropay.ai/guides/create-variants.md): Sell Good/Better/Best tiers as separate Macropay products and let customers self-serve upgrades and downgrades from the customer portal.
- [Customer Portal](https://docs.macropay.ai/guides/customer-portal.md): Give customers a self-serve hub for invoices, subscriptions, and benefits — no support tickets required
- [How to Customize Benefits Order in Checkouts](https://docs.macropay.ai/guides/customize-benefits-order-in-checkouts.md): Control the order benefits appear at checkout so the most compelling entitlement leads the sale.
- [How to Customize Products Order in Checkouts](https://docs.macropay.ai/guides/customize-products-order-in-checkouts.md): Control exactly which products appear in a checkout — and in what order — using the Macropay API.
- [How to disable email editing in checkout](https://docs.macropay.ai/guides/disable-email-editing-in-checkout.md): Lock the checkout email to a known customer so signed-in buyers can't mistype it — and every order maps cleanly back to your user.
- [How to disable subscription upgrades/downgrades in customer portal](https://docs.macropay.ai/guides/disable-subscription-changes-in-customer-portal.md): Lock plan tiers in the self-serve customer portal so subscribers can't switch plans without going through your sales or support flow.
- [Integrate Macropay with Encore](https://docs.macropay.ai/guides/encore.md): Wire Macropay's merchant-of-record checkout and webhooks into an Encore TypeScript backend, with traces you can debug end-to-end.
- [How to Grant Meter Credits After Purchase](https://docs.macropay.ai/guides/grant-meter-credits-after-purchase.md): Drop a starting credit balance into a customer's meter the moment they buy — with a no-code benefit, or a webhook for full control.
- [How to Grant Meter Credits Before Purchase](https://docs.macropay.ai/guides/grant-meter-credits-before-purchase.md): Pre-load usage credits onto a customer before they ever pay — for trials, promos, demos, and AI-agent starter balances.
- [Introduction](https://docs.macropay.ai/guides/introduction.md): Task-focused, copy-paste guides for shipping payments, subscriptions, usage billing, and AI agent monetization with Macropay.
- [Integrate Macropay with Laravel](https://docs.macropay.ai/guides/laravel.md): Sell products from a Laravel app with hosted checkout, webhooks, and Macropay handling tax, compliance, and payouts as merchant of record.
- [Next.js Integration](https://docs.macropay.ai/guides/nextjs.md): Ship paid plans in your Next.js app — checkout, webhooks, and tax handled as Merchant of Record
- [Proration for Subscription Upgrades and Downgrades](https://docs.macropay.ai/guides/proration-for-subscription-changes.md): Configure how Macropay charges or credits the price difference when a subscription plan changes — immediately or on the next invoice — via dashboard, OAT API, or SDK.
- [Python/FastAPI Integration](https://docs.macropay.ai/guides/python.md): Take your first payment from a Python or FastAPI app in five minutes — Macropay handles tax, PCI, and disputes as merchant of record.
- [Quickstart](https://docs.macropay.ai/guides/quickstart.md): Sell something in five minutes. As merchant of record, Macropay handles tax, compliance, and disputes — you ship a checkout link and collect a webhook.
- [How to schedule subscription downgrades with Upstash QStash](https://docs.macropay.ai/guides/schedule-subscription-downgrades-qstash.md): Defer a subscription downgrade to the end of the billing period with the Macropay API and Upstash QStash — no cron server required.
- [Implementing Seat-Based Pricing](https://docs.macropay.ai/guides/seat-based-pricing.md): Sell team plans where one payer buys seats and assigns them to teammates — each seat carries its own benefits.
- [How to perform subscription downgrades](https://docs.macropay.ai/guides/subscription-downgrades.md): Move a subscriber to a lower plan with the right proration — from the dashboard or self-serve in the portal.
- [How to perform subscription upgrades](https://docs.macropay.ai/guides/subscription-upgrades.md): Move a subscriber to a higher plan from the dashboard or let them self-serve in the portal — with proration handled for you.
- [How to Switch Checkout Theme](https://docs.macropay.ai/guides/theme-switch-in-checkout.md): Force light or dark mode on any Macropay checkout with a single theme query parameter — for both API sessions and checkout links.
- [Webhook Integration](https://docs.macropay.ai/guides/webhooks.md): Keep your app in sync with Macropay — get signed, real-time events for orders, subscriptions, and customer state.
- [Authentication](https://docs.macropay.ai/integrate/authentication.md): How to authenticate Macropay API requests with organization access tokens or OAuth 2.0 — plus automatic leak protection.
- [Customer State](https://docs.macropay.ai/integrate/customer-state.md): Read a customer's active subscriptions, benefits, and meter balances in one call — the fastest way to gate access.
- [Macropay over Model Context Protocol (MCP)](https://docs.macropay.ai/integrate/mcp.md): Give your AI agents and assistants live access to your Macropay account through a hosted MCP server.
- [OAuth 2.0 Connect](https://docs.macropay.ai/integrate/oauth2/connect.md): Let your app act on behalf of Macropay users with OpenID Connect — organization-scoped tokens, PKCE for public clients, and refreshable access.
- [Introduction](https://docs.macropay.ai/integrate/oauth2/introduction.md): For partners building services and extensions for Macropay customers
- [Create an OAuth 2.0 Client](https://docs.macropay.ai/integrate/oauth2/setup.md)
- [Sandbox Environment](https://docs.macropay.ai/integrate/sandbox.md): A full, isolated clone of Macropay where you can build, break, and rehearse your integration without touching real money or live data.
- [Go SDK](https://docs.macropay.ai/integrate/sdk/golang.md): Idiomatic Go client for Macropay — checkout, billing, usage events, and agent signals on the v1 API.
- [PHP SDK](https://docs.macropay.ai/integrate/sdk/php.md): Type-safe PHP client for the Macropay API — products, checkout, customers and usage billing, with a one-line sandbox switch.
- [Python SDK](https://docs.macropay.ai/integrate/sdk/python.md): Type-hinted Python SDK for Macropay — sync or async billing, payments, and agent metering as the merchant of record.
- [TypeScript SDK](https://docs.macropay.ai/integrate/sdk/typescript.md): Typed Macropay client for Node.js and the browser — checkout, billing, and agent metering in a few lines.
- [Handle & monitor webhook deliveries](https://docs.macropay.ai/integrate/webhooks/delivery.md): Receive, verify and react to Macropay webhooks — with delivery monitoring, retries and troubleshooting built in
- [Setup Webhooks](https://docs.macropay.ai/integrate/webhooks/endpoints.md): Push real-time notifications to your app the moment an event happens — no polling required.
- [Webhook Events](https://docs.macropay.ai/integrate/webhooks/events.md): Every webhook Macropay emits — what fires, when, and how to react to it in your billing logic.
- [Integrating Webhooks Locally](https://docs.macropay.ai/integrate/webhooks/locally.md): Tunnel live Macropay webhook events to localhost and test signature verification before you ship
- [Webhook Signature Verification](https://docs.macropay.ai/integrate/webhooks/verification.md): Confirm every webhook genuinely came from Macropay and wasn't tampered with in transit.
- [Macropay: Turn Your Software into a Business](https://docs.macropay.ai/introduction.md): Merchant-of-Record billing for software and AI agents — global tax handled, PCI absorbed, usage and outcome billing built in.
- [Acceptable use](https://docs.macropay.ai/merchant-of-record/acceptable-use.md)
- [Account reviews](https://docs.macropay.ai/merchant-of-record/account-reviews.md)
- [Fees](https://docs.macropay.ai/merchant-of-record/fees.md): Transparent fees at a 20% discount vs. other MoRs
- [Merchant of Record](https://docs.macropay.ai/merchant-of-record/introduction.md): We become the seller of record so global sales tax, PCI, and disputes stop being your problem.
- [KYC and onboarding](https://docs.macropay.ai/merchant-of-record/kyc-onboarding.md): How Macropay verifies your business once — so we can be your Merchant of Record and release payouts
- [Supported Countries](https://docs.macropay.ai/merchant-of-record/supported-countries.md): Sell almost everywhere and get paid in your local currency — Macropay is your Merchant of Record across 190+ countries
- [Migrate to Macropay](https://docs.macropay.ai/migrate.md): Move off Lemon Squeezy, Paddle, or Stripe Billing with zero downtime — and become a merchant of record on day one.
- [Support](https://docs.macropay.ai/support.md): How to reach Macropay support, which channels you can use, and what to expect when you ask for help.
- [Payment Infrastructure for AI SaaS](https://docs.macropay.ai/use-cases/ai-saas.md): Meter tokens, bill by usage or outcome, and watch your margin per customer — Merchant of Record billing built for AI products and agents.
- [Sell Digital Products Globally](https://docs.macropay.ai/use-cases/digital-products.md): Ship software, courses, and downloads worldwide. We're the merchant of record — global tax, license keys, and file delivery are built in.

## OpenAPI Specs

- [openapi](https://docs.macropay.ai/openapi.yaml)