Growth & Distribution

Bundles & Referrals

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

Updated · Guide version 1.1

Read as Markdown

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 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:

{"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 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. 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, Subscriptions and Monetization.