> ## 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.

# Product Updates

> Stay up to date with the latest changes and improvements to Macropay.

<Update label="2026-06-05">
  ## This week

  A big week. Agent Billing, a native Affiliate program, CRM sync,
  growth tooling, and a full dispute workflow all shipped — plus a long
  list of billing and checkout reliability fixes.

  ### New

  * **Agent Billing is live.** Track agents as first-class entities, bill
    on activity or outcomes, and watch margin per agent and per model in
    the new Agents dashboard. Value Receipts give buyers certified ROI
    for every run. Python and TypeScript SDKs both ship with
    `agent.setup_billing`, automatic tool-cost capture
    (`track_tool` / `track_cost`), and verified-vs-reported outcome
    splits. Start with [Agents](/features/agents/introduction),
    [Signals](/features/agents/signals),
    [Margin](/features/agents/margin),
    [Value Receipts](/features/agents/value-receipts), and the
    [SDK](/features/agents/sdk).
  * **Native Affiliate program.** Run your own affiliate program from
    the dashboard — invite by email, CSV, or share link, ship branded
    creatives and tracked links, and let referrals auto-attribute through
    hosted checkout with zero merchant JS. The public marketplace at
    [affiliate.macropay.ai](https://affiliate.macropay.ai) is a
    searchable directory of live programs. See
    [Affiliates](/features/affiliates/introduction) and
    [Setup](/features/affiliates/setup).
  * **Affiliate payouts.** Manual payout tooling with configurable hold
    windows, per-affiliate rollups, and one-click PayPal Payouts (opt-in).
    Pay-with-fee records payouts net of the actual processing fee — no
    Stripe Connect required. Details in
    [Payouts](/features/affiliates/payouts).
  * **CRM sync for Salesforce and HubSpot.** Connect from Settings → CRM
    to keep deals in sync with MRR, ARR, total paid, and contract terms.
    Lifecycle events (new customer, churn, expansion) flow through as
    they happen. One-click field mapping in the sync settings page.
  * **Growth: free → paid upgrades.** A complete PLG flow ships this
    week — in-product upgrade with card collection, smart-upgrade
    triggers based on usage, hard-limit entitlement gates, and a new
    Growth dashboard for rule CRUD. Two new webhook events,
    `usage.threshold_reached` and `subscription.upgrade_recommended`,
    let you wire upgrade prompts into your own UI.
  * **Dispute management.** Chargebacks now pull automatically from
    Stripe with the evidence deadline attached. AI drafts a first-pass
    evidence response (with safe fallback), routes it through an
    approval workflow, and posts Slack notifications across the
    lifecycle. The backoffice shows evidence due-by at a glance.
  * **MRR Movements + SaaS health metrics.** A stacked-bar breakdown of
    new, expansion, contraction, and churned MRR, plus derived metrics
    (NRR, GRR, quick ratio) and an Annual Run Rate surface on the
    analytics home.
  * **Cohort retention heatmap.** Drill into any cohort to see its
    customer list, filter by country, and export the full matrix as CSV.
  * **System Errors dashboard.** Payment failures are now classified as
    customer-caused vs system-caused, persisted, and surfaced in a new
    dashboard widget and page. Merchants get an alert on the first
    system failure.
  * **Bulk customer import + paid-outside billing.** Import customers in
    bulk, attach subscriptions that are billed outside Macropay
    (excluded from revenue), and mark individual orders as paid outside.
    Useful for migrating an existing book.
  * **Merchant-created subscriptions.** Add a subscription directly from
    the customer page — charge an existing card on file or track a
    paid-outside subscription.
  * **MCP agentic commerce tools.** New opt-in tools on
    [`mcp.macropay.ai`](/features/integrations/mcp) let agents create
    checkouts and record usage. Off by default — flip the agentic
    commerce toggle to enable. See
    [MCP agentic commerce](/features/integrations/mcp-agentic-commerce).
  * **x402 agentic payment rails (preview).** Initial HTTP 402 support
    for agent-to-merchant payments, opt-in and off by default. Read more
    in [x402](/features/integrations/x402).
  * **Dark mode toggle.** Light/dark toggle now lives in the dashboard
    topbar and on the login and signup pages.

  ### Updates

  * **Webhooks DX.** A test-event button on every endpoint, clearer
    paid-event copy, and 404 → endpoint redirects. The verification
    flow is now fully [Standard Webhooks](/integrate/webhooks/verification)
    compliant, and sandbox email checks have been relaxed for faster
    local iteration.
  * **Tax copy.** The pricing and tax pages now make it explicit that
    Macropay — not the merchant — files and remits sales tax, VAT, and
    GST in every supported jurisdiction.
  * **Products page performance.** Eager-loaded schema relationships cut
    about 10 seconds off list loads on large catalogs.
  * **Backoffice approve.** Merchant review can now approve an org from
    any status, including `created` → `active` in one click.

  ### Fixes

  * **AI proxy billing, end-to-end.** Round-once billing, correct
    reservation release on cancel, proper streaming usage capture, and
    FX-normalized AI cost so margin reports match invoices.
  * **Renewal double-charge.** Fixed a race that could charge a renewal
    twice when a budget overflow retried.
  * **Checkout reliability.** 3DS finalize now has a backup path, stale
    payment locks are cleaned up, and a reusable payment-method token is
    persisted on successful charges so re-subscribe keeps the saved card.
  * **Bank details detection.** Saving payout bank details now correctly
    flips the account to "details submitted," unblocking promotion to
    active.
  * **MCP server.** OAuth tokens now resolve correctly and `/ai/v1` is
    rate-limited per key, fixing intermittent 401s and noisy-neighbor
    throttling.
  * **Security.** Tightened KYC org checks, hardened Didit webhook
    signature verification, and namespaced idempotency keys per
    organization.
  * **Affiliate referral attribution.** Referral links now route through
    a server-side `/track` endpoint, so attribution works even when
    buyers block third-party JS.
  * **Signup access.** New customers can now reach the signup page
    again, and the dark-mode trust panel no longer flashes white
    before paint.
  * **Cmd+K.** Quick actions refresh on open and show the right set for
    the current page.
</Update>

<Update label="2026-05-29">
  ## This week

  A round of checkout, onboarding, and AI proxy improvements following
  the 1.0 launch.

  ### New

  * **3DS for EU / UK / IN cards.** Checkout now bridges Basis Theory
    tokenization to Stripe's 3DS challenge flow, so European, British,
    and Indian buyers can complete Strong Customer Authentication without
    leaving the hosted checkout page.
  * **Basis Theory is the default for every new organization.** All new
    merchants get Basis-Theory-tokenized card capture out of the box,
    which keeps PCI scope at SAQ-A. Read more in
    [Basis Theory checkout](/features/checkout/basis-theory).

  ### Updates

  * **Faster path to live.** Organizations now auto-promote to **active**
    as soon as bank-wire MoR prerequisites are satisfied — no more
    waiting on a separate identity step. The Stripe Identity surface
    has been removed from onboarding entirely; KYC runs through our
    in-house document upload.
  * **LLM inference accepts publishable tokens.** Calls to
    `ai.macropay.ai` now authenticate with `pk_` tokens, so you can
    proxy OpenAI, Anthropic, Google, and OpenRouter from client-side
    code paths that don't have a secret key. See
    [LLM inference](/features/llm-inference).
  * **Approve button restored in backoffice.** Orgs in
    `onboarding_started` are now actionable from the merchant review
    queue.

  ### Fixes

  * **No more duplicate charges on retry.** The checkout idempotency key
    now includes the Basis Theory / Stripe `confirmation_token`, so
    retried submissions on the same order can't double-charge a card.
  * **Payments gated on real bank details.** Checkout now blocks payment
    collection until the merchant's payout bank account is on file, and
    surfaces a clear message to the buyer if it isn't. This prevents
    successful charges that can't be paid out.
  * **Checkout submit reliability.** The Basis Theory card element is
    now consistently discovered at submit time, fixing an intermittent
    "card not tokenized" error on the first click.
  * **MCP server stability.** Production routing, OAuth client
    persistence, and tool registration fixes for
    [`mcp.macropay.ai`](/features/integrations/mcp) — all 53 tools are
    back online for Claude Desktop, Cursor, ChatGPT, and Claude Code.
</Update>

<Update label="2026-05-25">
  ## Macropay 1.0 — We're live

  Macropay is now generally available as a Merchant of Record for SaaS,
  digital goods, and AI-native businesses. One platform handles
  checkout, billing, global tax, KYC, fraud, chargebacks, and payouts —
  so you can ship and get paid in 175+ countries without touching
  compliance.

  Here's everything that ships with 1.0.

  ### Merchant of Record, end-to-end

  <CardGroup cols={2}>
    <Card title="Global tax handled" icon="globe">
      Sales tax, VAT, GST collected and remitted on your behalf in 60+
      jurisdictions. Macropay is the seller of record on every invoice.
    </Card>

    <Card title="Chargeback shield" icon="shield">
      We absorb chargebacks and dispute them with the network. You don't
      log into Stripe to upload evidence — we handle it.
    </Card>

    <Card title="KYC + fraud" icon="user-shield">
      Sub-second device fingerprinting, IP risk scoring, AI-assisted
      seller KYC review. Buyers don't see the friction; you don't see
      the fraud.
    </Card>

    <Card title="Bank-wire payouts" icon="building-columns">
      Direct bank wires to your business account in 40+ currencies. No
      Stripe Connect, no Express dashboard — you get paid like a
      vendor, not a sub-account.
    </Card>
  </CardGroup>

  ### Checkout you'd actually link to

  * **Hosted checkout** powered by Basis Theory tokenization — PCI
    scope drops to SAQ-A, you never touch a PAN.
  * **Adaptive payment methods**: cards, Apple Pay, Google Pay, SEPA,
    iDEAL, Bancontact, BLIK, and 25+ local methods that surface
    automatically by buyer country.
  * **Currency localization**: prices auto-convert with up-to-the-hour
    FX, displayed in the buyer's currency, settled in yours.
  * **One-click upsells** post-purchase without re-collecting card
    details.
  * **Light-mode-locked checkout page** for predictable rendering
    inside any merchant theme.

  ### Subscriptions, the way they should work

  <CardGroup cols={2}>
    <Card title="Usage-based billing" icon="gauge-high">
      Meter events via API or the Events stream, define pricing tiers
      in the dashboard, Macropay handles proration and invoicing.
    </Card>

    <Card title="Customer portal" icon="window">
      Self-serve cancellation, payment-method updates, invoice history.
      White-labeled to your domain.
    </Card>

    <Card title="Trials and discounts" icon="ticket">
      Free trials, percentage and fixed-amount discount codes,
      seat-based pricing, scheduled price changes.
    </Card>

    <Card title="Dunning + retries" icon="rotate">
      Smart retry windows tuned per issuer, branded email
      sequences, automatic pause/resume.
    </Card>
  </CardGroup>

  ### MCP server: your business as an AI tool catalog

  Macropay ships an **official remote MCP server** at
  [`mcp.macropay.ai`](https://mcp.macropay.ai). Add the URL to Claude
  Desktop, Cursor, ChatGPT, or Claude Code, click through the OAuth
  prompt once, and you have **53 tools** wired up: 45 auto-generated
  from the OpenAPI spec (customers, products, subscriptions, orders,
  payments, refunds, members, metrics, meters), plus 7 hand-authored
  extras.

  Ask in plain English:

  * *"What's my MRR right now and how does it compare to last week?"*
  * *"Top 10 customers by 30-day revenue."*
  * *"Refund order ord\_abc fully."*
  * *"Why did payment ch\_xyz fail?"*
  * *"Create a \$49/mo plan called AI Pro."*

  Read the full guide: [MCP server](/features/integrations/mcp).

  ### Slack integration

  One-click OAuth installs Macropay into your workspace and pipes
  **five event types** to any channel:

  * New paid order
  * Refund issued
  * Chargeback opened
  * Failed payment (after retries)
  * New customer signup

  Plus a **daily revenue summary** at the hour you pick, and slash
  commands so you can pull numbers without leaving Slack:

  ```
  /macropay revenue today
  /macropay mrr
  /macropay churn 30d
  /macropay help
  ```

  ### LLM inference billing (`ai.macropay.ai`)

  If your product calls an LLM, Macropay can be your billing layer. We
  proxy OpenAI, Anthropic, Google, and OpenRouter through a single
  endpoint, meter every token, and add a margin you control — then
  bill it through the same subscription or usage line the rest of your
  product uses. No separate Stripe meter to wire up.

  Read the full guide: [LLM inference](/features/llm-inference).

  ### Migrate in under two weeks

  Moving from Lemon Squeezy, Paddle, Stripe Billing, Gumroad, or
  Chargebee? Our team runs the migration end-to-end:

  <Steps>
    <Step title="Discovery call">
      30 minutes. We map your catalog, customers, and active
      subscriptions.
    </Step>

    <Step title="Sandbox dry-run">
      Full replication in a Macropay sandbox. You test before any
      customer-facing change.
    </Step>

    <Step title="Live cutover">
      \< 1 hour for accounts up to 10,000 active subscriptions.
      Customers don't re-authorize payment.
    </Step>

    <Step title="Two-week white-glove support">
      Dedicated Slack channel for the cutover and the two weeks
      after.
    </Step>
  </Steps>

  Migration is **free**. [Email sales@macropay.ai](mailto:sales@macropay.ai?subject=Migrate%20to%20Macropay)
  and we'll reply within one business day.

  ### Developer surface

  * **REST API** with idempotency keys, cursor pagination, and an
    OpenAPI 3.1 spec.
  * **Webhooks** signed per the [standard-webhooks](https://www.standardwebhooks.com/)
    spec — drop-in compatible with most existing webhook frameworks.
  * **TypeScript SDK** + Python SDK, auto-generated from the OpenAPI
    spec.
  * **Sandbox mode** with a shared test card, simulated webhooks, and
    test clocks so you can fast-forward subscription cycles.
  * **Organization Access Tokens** (OATs): org-scoped, scope-limited
    bearer tokens for server-to-server use. Mode-aware (live vs
    sandbox) and revocable from the dashboard.

  ### Onboarding in 4 steps

  <Steps>
    <Step title="Create your organization">
      Sign in with Google or email, pick a slug, you're in the
      dashboard in 30 seconds.
    </Step>

    <Step title="Add your business details">
      Legal entity, payout bank account, tax IDs. Stored encrypted.
    </Step>

    <Step title="KYC review">
      AI-assisted — we cross-check your business against public signals
      (Trustpilot, BBB, Reddit, web presence). Most merchants approved
      within a business day.
    </Step>

    <Step title="Go live">
      Flip from sandbox to live, paste your checkout URL on your site,
      take orders.
    </Step>
  </Steps>

  ### What's next

  We're already working on:

  * **Vector-DB-backed docs search** inside the MCP server
  * **Stripe-compatible webhook payloads** for drop-in migration
  * **More local payment methods** in LatAm and SEA
  * **Affiliate / partner payouts** as a first-class object

  Have a feature you want? [sales@macropay.ai](mailto:sales@macropay.ai)
  or ping us in the merchant Slack — we read every message.

  <Card title="Ready to take payments?" icon="rocket" href="https://app.macropay.ai/signup">
    Sign up free. Sandbox immediately, live the same week.
  </Card>
</Update>