Custom Benefit

When none of the built-in benefits fit, the Custom benefit is your escape hatch. It does two jobs: it shows a private note that only paying customers can read, and it acts as a generic entitlement flag you can wire into your own integration logic. Because Macropay is the merchant of record, the purchase that unlocks this benefit is already tax-compliant and dispute-managed on your behalf — you just decide what the customer receives.

What it’s good for

Private notes

Reveal a secret link, a support address, or onboarding instructions only after payment clears.

Custom entitlements

Use it as a named flag your backend reads to grant bespoke access that the standard benefits don’t cover.

Private note

A custom benefit can carry a note that stays hidden until a customer has an active grant. Anything you’d only want a paying customer to see works well here:

A private scheduling link (for example, a Cal.com booking URL)
A dedicated support email or priority inbox
A coupon code, invite, or early-access instruction
A short welcome message specific to the product they bought

The note renders for the customer in their customer portal once the grant is active, and disappears if the entitlement lapses.

Custom entitlements for integrations

Each custom benefit you create is distinct, so you can attach several to different products and tell them apart in code. When a customer is granted (or loses) a benefit, Macropay emits webhook events you can act on.

// Listen for benefit grants and unlock your own feature flags.
// See /api-reference/webhooks/benefit_grant.created for the payload shape.
app.post("/webhooks/macropay", (req, res) => {
  const event = req.body;

  if (event.type === "benefit_grant.created") {
    const { customer_id, benefit_id } = event.data;
    // Match against the custom benefit you configured, then
    // grant whatever bespoke access this product implies.
    grantBespokeAccess(customer_id, benefit_id);
  }

  if (event.type === "benefit_grant.revoked") {
    const { customer_id, benefit_id } = event.data;
    revokeBespokeAccess(customer_id, benefit_id);
  }

  res.sendStatus(200);
});

Pair this with usage-based billing when the bespoke access is metered — for example, an AI agent whose access tier and per-event cost are both governed by the same purchase.

Steps

Create the benefit

In the dashboard, add a new benefit and choose Custom. Give it a clear internal name so you can recognize it in webhook payloads.

Write the customer note

Add the private message — a link, support address, or instructions — that should appear only after purchase.

Attach it to a product

Add the benefit to any product (one-time or subscription). Customers receive it automatically on a successful order.

React in your backend (optional)

Subscribe to benefit_grant.created and benefit_grant.revoked webhooks to drive your own custom integration logic.

Need a more specialized benefit instead? Macropay also ships license keys, file downloads, Discord access, GitHub repository access, and prepaid credits.

Bootup

Features

Integrate

Merchant of Record (MoR)

What it’s good for

Private notes

Custom entitlements

Private note

Custom entitlements for integrations

Steps

​What it’s good for

Private notes

Custom entitlements

​Private note

​Custom entitlements for integrations

​Steps

What it’s good for

Private note

Custom entitlements for integrations

Steps