# Bundles & Referrals

> Understand catalog bundles, explicit referral redemption and the limits of publisher bundle management.

Canonical: https://theaimart.co/docs/bundles-and-referrals
Updated: 2026-10-08 · Guide version: 1.1

Bundles and referrals are separate marketplace features. A bundle groups catalog apps; a referral identifies an inviter. Neither guarantees a higher conversion rate or a particular income.

## Browse a bundle

Open [Growth](/Dashboard/Growth) to inspect available bundle titles, descriptions, included app IDs, price and period. The public `GET /bundles` response has a `bundles` array. An empty response means no active offers were returned, not that your account is broken.

The bundle subscription request uses an existing bundle ID:

```json
{"bundle_id":"EXISTING_BUNDLE_UUID"}
```

`POST /bundles/subscribe` requires your session, checks an active offer and charges marketplace credits. The reviewed handler records a 30-day subscription. It is a purchase operation; inspect actual price and balance before confirming it. Do not run a synthetic purchase in production.

## Publisher limitation

There is no publisher bundle-creation form or `POST /monetization/bundles` route in this interface. You cannot create an arbitrary discounted app-and-agent package using the old `listing_ids`/`discount_percent` example. Contact support about bundle curation rather than assuming the feature is available to every publisher.

## Referrals

Open [Refer & Earn](/Dashboard/Referrals) to retrieve your code and share link. Referral stats report redeemed referrals and earned bonus credits. The reviewed backend requires explicit code redemption and rejects self-referral and a second redemption by the same user.

A referral does not automatically subscribe someone to a bundle. Credits granted by the referral program are a separate locked bonus balance, not cash earnings or an immediately withdrawable wallet balance. Check current program terms with support before advertising a reward amount or purchase discount.

## Troubleshooting

For an inactive bundle, use a current catalog offer. For insufficient credits, review [Wallet & Credits](/docs/wallet-and-credits). For referral errors, confirm the code belongs to another user and has not already been redeemed. Do not create fake accounts to test rewards.

## Next

See [Refer & Earn](/docs/referrals), [Subscriptions](/docs/subscriptions) and [Monetization](/docs/monetization).