Benefits

Benefits are digital entitlements that are automatically delivered to customers when they purchase or subscribe to a product. They are the core mechanism for delivering value beyond the payment itself.

When a customer completes a checkout, mavi pay activates all benefits attached to the purchased product. For subscriptions, benefits remain active as long as the subscription is paid. When a subscription ends, benefit access is revoked.

How Benefits Work

1. You create a benefit in your dashboard under Benefits.
2. You attach the benefit to one or more products.
3. A customer purchases the product.
4. mavi pay automatically grants the benefit to the customer.
5. The customer can access their benefits from their order confirmation email or customer portal.

A single product can have multiple benefits attached. A single benefit can be shared across multiple products.

Benefit Types

License Keys

Automatically generate and deliver unique license keys upon purchase. Useful for software products, plugins, and digital tools.

• Keys are generated per order -- each customer gets a unique key.
• You can define the key format and prefix.
• Keys can have activation limits (e.g., max 3 devices).
• Revoked automatically when a subscription ends.

File Downloads

Deliver digital files to customers after purchase. Useful for e-books, templates, design assets, audio, video, and any downloadable content.

• Upload files directly to your dashboard. Files are stored securely and served via signed URLs.
• Customers access downloads from their confirmation page and email.
• You can update the file at any time -- existing customers get access to the updated version.
• Set download limits per customer if needed.

Discord Server Access

Grant customers automatic access to a private Discord server or role upon purchase.

• Connect your Discord server in the dashboard under Settings > Integrations.
• Select which role to assign to the customer.
• Role is automatically revoked when the subscription ends or is cancelled.
• Customers receive an invite link in their confirmation email.

Custom Benefits

For anything that does not fit the built-in types, use custom benefits. A custom benefit delivers a message, URL, or instructions to the customer after purchase.

• Define a title and description that the customer sees.
• Include a custom URL (e.g., a link to a private community, a Notion page, or a scheduling tool).
• Include custom instructions in Markdown.
• Useful for onboarding flows, access to private forums, consultation booking links, or anything that requires manual setup.

Attaching Benefits to Products

To attach a benefit to a product:

1. Go to Products in your dashboard and select the product.
2. In the Benefits section, click Add Benefit.
3. Choose an existing benefit or create a new one.
4. Save the product.

You can reorder benefits to control the display order on the checkout page and in the customer's confirmation email.

Managing Benefits

From the Benefits section of your dashboard, you can:

• View all benefits and see which products they are attached to.
• Edit benefit details, files, or configuration at any time. Changes apply to future orders and to existing subscribers.
• Delete a benefit. Existing customers who already received it retain access until their subscription ends, but no new customers will receive it.

Benefits and the API

You can manage benefits programmatically via the mavi pay API:

# List all benefits for your organisation
curl -H "Authorization: Bearer <your-api-key>" \
  https://api.mavifinans.sh/api/v1/benefits

# Get a specific benefit
curl -H "Authorization: Bearer <your-api-key>" \
  https://api.mavifinans.sh/api/v1/benefits/<benefit-id>

Benefits are also included in webhook payloads for checkout.completed events, so your backend can react to benefit grants in real time.

Next Steps

• Create a product and attach benefits to it.
• Set up checkout links to start selling.
• Manage your customers and their benefit access.