Guidance for customers and vendors.
Learn how to discover, join, host, fund, communicate, and fulfill group buys through practical customer and vendor guides authored in Markdoc.
Understand the platform
Mallello is a curated marketplace for discovering, hosting, funding, and following group buys while preserving clear ownership between the platform, vendors, and customers.
The customer journey covers discovery, verification, following, checkout, order tracking, account management, and refund requests.
The vendor journey moves from verified application through approval, Stripe onboarding, listing creation, sales, communication, fulfillment, and support.
A group buy progresses from draft through launch and order collection to either funded production and fulfillment or a failed-MOQ refund path.
Mallello uses direct charges on connected vendor accounts so the vendor receives sale proceeds, Mallello receives an application fee, and payment liability stays aligned with the seller.
Group buys are generally non-refundable and non-cancelable after the published refund window closes or manufacturing begins, while failed-MOQ and legally required outcomes follow a controlled refund process.
Browse all documentation
Search by feature, workflow, account type, payment topic, or group-buy stage.
82 guides
Customer journey
The customer journey covers discovery, verification, following, checkout, order tracking, account management, and refund requests.
Platform overview
Mallello is a curated marketplace for discovering, hosting, funding, and following group buys while preserving clear ownership between the platform, vendors, and customers.
Vendor journey
The vendor journey moves from verified application through approval, Stripe onboarding, listing creation, sales, communication, fulfillment, and support.
About page
The /about route explains the marketplace's purpose, values, and relationship with customers and vendors.
Acquisition campaign landing page
The /campaigns/[id] route presents one tracked vendor recruitment offer using a campaign name or stable identifier.
Categories page
The /categories route lets visitors enter discovery through curated product categories.
Checkout success page
The /checkout/success route reconciles a returned Stripe session and communicates confirmed or pending purchase state.
Contact page
The /contact route creates a support request through a validated public contact form.
Cookie information page
The /cookies route explains essential session, preference, attribution, and related browser storage.
Customer addresses
The /dashboard/addresses route creates, edits, defaults, and removes reusable customer address records.
Customer billing
The /dashboard/billing route shows customer payment-method context for completed orders; vendor Go+ plans are managed separately in Vendor Billing.
Customer dashboard
The /dashboard route routes an authenticated customer to the account overview.
Customer following
The /dashboard/following route shows listings associated with the customer's follow relationships.
Customer orders
The /dashboard/orders route lists the signed-in customer's hosted order history and status.
Customer profile
The /dashboard/profile route updates the ordinary account fields the customer is allowed to manage.
Customer refunds
The /dashboard/refunds route submits and tracks refund requests for eligible owned orders.
Discover page
The /discover route searches and filters active marketplace listings by useful catalog dimensions.
Edit vendor listing
The /vendor/listings/[id]/edit route edits one owned listing while preserving historical order details.
Group-buy detail page
The /group-buys/[slug] route presents one public listing's offer, vendor, progress, options, policy, timeline, actions, and updates.
Home page
The / route introduces Mallello, featured group buys, active promotions, and the path into marketplace discovery.
Hosted checkout page
The /checkout/[slug] route collects quantity and listing options before redirecting to the correct vendor's Stripe Checkout.
Login alias
The /login route provides a stable entry point that leads into the canonical sign-in experience.
New vendor listing
The /vendor/listings/new route creates a hosted or external listing with product, MOQ, policy, option, and media fields.
Privacy policy page
The /privacy route publishes Mallello's data categories, purposes, processors, rights, and contact path.
Refund policy page
The /refunds route publishes group-buy cancellation, failed-MOQ, fee-retention, and exception rules.
Saved listings page
The /saved route lists the customer's private listing bookmarks.
Sign-in page
The /sign-in route authenticates an existing user and preserves a permitted next destination.
Signup page
The /signup route creates an account, opens the verification modal, and preserves vendor-application intent when applicable.
Terms page
The /terms route publishes marketplace, account, vendor, payment, fee, conduct, and liability terms.
Unsubscribe page
The /unsubscribe route validates a signed email token and disables eligible optional mail.
Vendor advertising
The /vendor/ads route shows advertising credit and lets the vendor manage eligible listing campaigns.
Vendor analytics
The /vendor/analytics route summarizes the signed-in vendor's catalog, orders, revenue, progress, and audience signals.
Vendor application page
The /submit route submits a new application or presents the existing application's receipt and status.
Vendor billing and Connect
The /vendor/billing route shows plan, fee, credit, and Stripe connected-account onboarding or Dashboard actions.
Vendor dashboard
The /vendor/dashboard route provides the vendor's operational command center and key status indicators.
Vendor directory
The /vendors route discovers approved vendor profiles and follow actions.
Vendor listings
The /vendor/listings route lists and manages only the authenticated vendor's catalog.
Vendor orders
The /vendor/orders route shows the vendor's hosted sales for fulfillment and support.
Vendor profile
The /vendors/[slug] route shows one vendor's catalog, reliability, reviews, and follow control.
Vendor support page
The /vendor/support route creates and follows vendor-specific support requests.
Vendor updates page
The /vendor/updates route publishes progress updates for owned listings and their followers.
Account signup
Signup creates a Supabase authentication identity and an application user record, then guides the person through verification without requiring a second manual login.
Email verification
New accounts verify ownership of their email through Supabase and Resend before protected platform activity begins.
Password reset
Password reset uses an email-controlled Supabase recovery link and a protected password-update step.
Profile management
The profile page lets an authenticated user maintain non-sensitive account details while immutable identity and privileged fields stay server-controlled.
Saved addresses
Customers can maintain reusable shipping-address records for account convenience without treating them as immutable order history.
Sign-in and session handling
Supabase-backed sessions authenticate browser requests while application roles and statuses authorize each Mallello surface.
Following a listing
A listing follow subscribes an authenticated customer to applicable status and launch updates for one specific group buy.
Following a vendor
A vendor follow subscribes a customer to launch and listing-update activity across that vendor's catalog.
Saved listings
Saving creates a private customer bookmark for returning to a group buy without necessarily subscribing to every update.
Vendor reliability
Vendor profiles summarize fulfillment history, average delay, communication rating, and successful group-buy count to help customers make informed decisions.
Vendor reviews
Reviews provide purchase-linked communication and reliability feedback while supporting moderation and fair aggregation.
Creating a listing
The listing editor captures the commercial offer, group-buy schedule, media, variant choices, MOQ rules, refund cutoff, and fulfillment expectations.
External MOQ contributions
External MOQ entries let a vendor add real units sold through another channel so the public production threshold reflects the whole batch.
Group-buy lifecycle
A group buy progresses from draft through launch and order collection to either funded production and fulfillment or a failed-MOQ refund path.
Hosted and external listings
Mallello supports hosted listings paid through Stripe Connect and external listings that link to a vendor-controlled storefront.
Listing image uploads
Vendors upload listing media to the configured Supabase Storage bucket and store public references with their listing.
MOQ progress
Minimum order quantity progress combines eligible paid platform units with separately recorded external units to communicate whether production can proceed.
Product options and variants
Listing options let vendors offer structured choices while preserving the customer's exact selection on the order.
Failed-MOQ handling
When a closed group buy does not reach its minimum quantity, eligible hosted orders enter a full product-price refund process while the originally disclosed platform fee is retained where lawful.
Order tracking
Order tracking presents the current payment, group-buy, refund, and fulfillment state from one durable hosted-order record while preserving the purchase snapshot.
Refund policy
Group buys are generally non-refundable and non-cancelable after the published refund window closes or manufacturing begins, while failed-MOQ and legally required outcomes follow a controlled refund process.
Submitting and reviewing refunds
Refund requests preserve the customer's reason, policy eligibility, review status, and provider result without treating a request as an automatic refund.
Vendor-defined refund window
Each group buy can define when voluntary customer refund requests close, reflecting the point at which exact batch funding or manufacturing commitments become irreversible.
Checkout return reconciliation
Return reconciliation closes the timing gap between a successful Stripe-hosted checkout and asynchronous webhook delivery.
Disputes and chargebacks
A cardholder dispute is handled by Stripe against the connected vendor's direct charge, with the vendor responsible for evidence and resulting balance impact under platform terms.
Hosted checkout
Hosted checkout creates a Stripe Checkout Session for a vendor's direct connected-account charge and applies Mallello's disclosed platform fee.
Mallello Go+ vendor subscription
Go+ is Mallello's optional vendor subscription: it lowers the standard hosted-listing fee from 3% to 1.5%, adds USD 20 in monthly advertising credits, and provides advanced vendor benefits for USD 15.99 per month at the current displayed pricing.
Stripe Connect funds flow
Mallello uses direct charges on connected vendor accounts so the vendor receives sale proceeds, Mallello receives an application fee, and payment liability stays aligned with the seller.
Stripe Connect onboarding
Approved vendors launch Stripe-hosted onboarding to create or resume a connected account and satisfy payment and payout requirements.
Vendor balances and payouts
Stripe, not Mallello, determines when direct-charge funds become available and when a connected vendor account pays them out to its bank.
Vendor analytics
Vendor analytics summarizes catalog, orders, MOQ, revenue, fees, followers, campaigns, and reliability data scoped to the authenticated vendor.
Vendor application
The vendor application is saved to the verified account, presents a durable receipt, and moves through pending, approved, or declined review states without duplicate submissions.
Vendor support
A dedicated vendor dashboard section routes onboarding, payments, listing, fulfillment, advertising, and account questions into trackable support tickets.
Advertising credits
Advertising credits fund eligible Mallello promotion and can be granted, purchased, or matched under campaign rules without being confused with withdrawable cash.
Matched advertising offer
Qualified acquisition campaigns can match a vendor's paid advertising input, with the advertised offer capped at up to USD 400 in bonus credit under configured terms.
Vendor advertising campaigns
Vendors spend available advertising credit on platform promotion while administrators control eligibility, lifecycle, and delivery records.
Listing status updates
Vendors publish durable progress messages for launch, manufacturing, delay, fulfillment, or other important group-buy milestones.
Support email and ticket replies
Support tickets preserve an application conversation, while ordinary email-client replies appear in that conversation only when inbound email is integrated with the admin system.
Email unsubscribe
A signed unsubscribe URL lets a recipient stop optional marketing delivery without signing in or exposing an enumerable contact identifier.
Privacy and data handling
Mallello collects only the account, transaction, fulfillment, communication, and attribution data needed to operate the marketplace and applies access, retention, and deletion controls.
Terms, privacy, refund, and cookie pages
Public legal pages explain marketplace roles, group-buy risk, payment and fee treatment, refunds, privacy, cookies, acceptable conduct, and contact methods.