Iraca Marketplace Operator Program
The Iraca Marketplace Operator Program lets approved organizations launch and operate branded vertical marketplaces powered by Iraca's seller operations infrastructure. Operators own their marketplace brand and buyer relationships; Iraca handles the seller operations layer, payment processing, and infrastructure.
This article covers what operators and their sellers need to know about the program structure, the Marketplace Seedling plan, and invitation tokens.
What is a Marketplace Operator?
A Marketplace Operator is an approved organization — a trade association, export promotion body, farmers market association, or specialty food hub — that runs a branded storefront where sellers can list their products for buyers to discover and inquire about.
Operators are not sellers. They have no inventory, no products, and no orders. Their role is to curate, configure, and grow a seller community on top of Iraca's infrastructure.
Operators access a dedicated Operator Dashboard separate from the seller experience. Contact the Iraca team to request access credentials after your agreement is signed.
The Marketplace Seedling Plan
Sellers invited into an operator's marketplace are placed on the Marketplace Seedling plan — a free plan exclusive to operator-invited sellers.
What's included
- 15 parent SKUs with unlimited variants per SKU
- All 12 Iraca modules (inventory, production, orders, shipping, compliance, labels, and more)
- Order import from external channels — sellers can pull orders from Amazon, Shopify, Etsy, and other platforms into Iraca for fulfillment
- Your operator's storefront — sellers are listed on the marketplace immediately
What's not included
- Listing and inventory push to external channels — sellers on Marketplace Seedling cannot push their product listings or inventory levels to Amazon, Shopify, Etsy, or other external platforms. This restriction is intentional: the operator's marketplace is the seller's primary sales channel on this plan.
- Data export — CSV and bulk data export require upgrading to Sprout or higher.
- Multiple team members — team management requires a paid plan.
Upgrading from Marketplace Seedling
Sellers can upgrade to Sprout ($39/mo), Grove ($89/mo), or Canopy ($179/mo) at any time from their Billing page. Upgrading unlocks external marketplace sync, data export, and team management. The seller's attribution to your marketplace and their storefront listing are not affected by a plan upgrade.
Invitation Tokens
Operators onboard sellers using invitation tokens — unique links that register a seller directly onto the Marketplace Seedling plan and permanently attribute them to your marketplace.
Token types
| Type | Best for |
|---|---|
| Single use | Inviting one specific seller; the link becomes invalid after first use |
| Multi use | Sharing at events or with a defined group; set a max use count |
| Bulk import | Uploading a CSV of existing seller contacts |
Generating tokens
In your Operator Dashboard:
- Go to Sellers → Invite Sellers.
- Choose a token type, set an optional expiry date, and add an internal label (e.g. "Alimentec 2026 cohort") for your own tracking.
- Copy the generated link and send it to your sellers.
Tokens can be revoked at any time from the token list if you need to cancel an invitation.
What sellers see
When a seller clicks your invitation link, they arrive at a co-branded registration page showing your marketplace name and logo. After registering, they land directly in their Iraca dashboard — styled with your branding — and are prompted to complete their product catalog and publish their first listing.
Seller Directory
Your Operator Dashboard includes a Seller Directory showing every seller attributed to your marketplace:
- Plan (Seedling, Sprout, Grove, Canopy)
- Account status
- Product count
- Date joined
- Lifetime revenue attributed to your operator account
Sellers cannot be moved between operators and cannot remove themselves from attribution. Attribution is permanent for the lifetime of the operator agreement.
External Sync Restriction — What Sellers Will See
If a Marketplace Seedling seller attempts to push a listing to Amazon, Shopify, or another external channel, they will see this message:
Listing sync to external channels is not available on your current plan. Upgrade to Sprout or higher to enable it.
Order import (pulling orders in from external channels for fulfillment) is always permitted — sellers can manage multi-channel fulfillment through Iraca even on the free plan.
Revenue and Remittance
Iraca processes all revenue generated through your marketplace and remits your share on the schedule specified in your Operator Agreement. You have real-time visibility into accrued revenue in your Operator Dashboard throughout the remittance period.
Remittance frequency (weekly, biweekly, monthly, or quarterly) and net payment terms are configured per-operator in your agreement. Contact your Iraca partnership manager to adjust these terms at renewal.
Frequently asked questions
What happens to an attributed seller's account if our operator agreement ends? The seller's Iraca account, data, and products remain intact. Attribution is deactivated on the agreement termination date and the seller converts to a direct Iraca relationship. Sellers are never stranded.
Can a seller on Marketplace Seedling still receive orders from Amazon or Shopify? Yes. Order import is always permitted. A Seedling seller can connect their Amazon or Shopify store as an order source — orders flow into Iraca for fulfillment — they just cannot push new listings back out to those channels.
Can we have multiple invitation tokens active at once? Yes. There's no limit on active tokens. You can have a single-use link for a specific seller, a multi-use link for a conference, and a bulk import token for a CSV upload all active simultaneously.
Does upgrading a seller change their attribution to our marketplace? No. Attribution is permanent and unaffected by plan changes. If a Seedling seller upgrades to Grove, your marketplace continues to receive the rev-share on their subscription.
Revenue Attribution and Remittance
Every billing event for an attributed seller — subscription renewals, add-on purchases, promoted listing fees, and buyer plan subscriptions — is automatically linked to your operator account and split according to your agreement's rev-share rate (default 75% to operator, 25% to Iraca).
Financial Dashboard
Your operator portal at /operator/revenue shows:
- Revenue Summary — real-time breakdown by revenue stream (subscriptions, add-ons, promoted listings, buyer subscriptions) and by individual seller. Filter by date range.
- Attribution Ledger — paginated log of every revenue event with gross amount, gateway cost, your share, and current remittance status (
pending,included_in_batch, orremitted). - Remittance History — list of past remittance batches with period, amounts, status, and a PDF download link for each report.
Remittance Schedule
Remittance batches are generated automatically at the close of each period based on your agreement's remittance frequency:
| Frequency | Period |
|---|---|
| Weekly | Rolling 7-day periods ending on your configured remittance_day |
| Bi-weekly | Rolling 14-day periods |
| Monthly | Calendar month (or aligned to remittance_day) |
| Quarterly | Standard calendar quarters |
Batches are created idempotently — if the system runs during a holiday weekend or a deploy window, the next run catches up without creating duplicates.
Payment is initiated within remittance_net_days (default 30) of the period close. The method (ACH, wire, or check) is agreed upon at contract signing and does not change without a written amendment.
PDF Remittance Reports
A PDF report is generated automatically for every batch. It includes:
- Cover summary (operator name, period, total gross, gateway costs, your share, Iraca share)
- Line-item table of every revenue event (date, type, seller, plan or add-on slug, amounts)
- Totals row
Reports are stored for the life of the agreement plus three years. Download links from the portal are signed and expire after two hours — regenerate from the portal as needed.
Promoted Listings
Operators can configure paid promotion tiers for their marketplace (under Operator Portal → Marketplace Config). Each tier has a name, price, and duration.
Sellers purchase promotion from within Iraca (Marketplace → Listings → Promote). Payment is charged to their Iraca billing method. The revenue event is split according to your rev-share rate — you receive your share at the next remittance cycle.
Active promotions give the listing elevated placement on the marketplace storefront according to the placement rules configured in your tier definition.
Premium Buyer Access
Buyers on your marketplace can subscribe to paid buyer plans you define (under Operator Portal → Marketplace Config → Buyer Plans). Premium buyer plans unlock access to gated vendor fields — wholesale pricing, contact details, certifications — configured per field in the marketplace field builder.
When a buyer subscribes, Iraca collects the subscription fee and remits your share at the next cycle. Buyer subscriptions are managed from the buyer's marketplace account settings.
Seller Health Scores
Each seller attributed to your marketplace receives a health score (0–100) based on five factors:
| Factor | Max Points |
|---|---|
| Catalog completeness (≥1 product with image + description) | 25 |
| Active inventory (at least one product with stock > 0) | 20 |
| Recent order activity (any order in last 90 days) | 25 |
| Marketplace listing published | 15 |
| Compliance records on file (if applicable) | 15 |
Scores are visible in your seller directory. Sellers below a threshold (default 60) receive an automated nudge email every Wednesday highlighting their specific gaps. This is handled by the operator:compute-health-scores --nudge scheduled command and requires no action from you.
Bulk Seller Import
Instead of sending invitation links one at a time, you can import a list of sellers from a CSV file via Operator Portal → Sellers → Import.
CSV format:
| Column | Required | Notes |
|---|---|---|
name | Yes | Seller's full name |
email | Yes | Must be a valid email address |
business_name | No | Used as the invitation label and in the email |
Each valid row generates a single-use invitation token (30-day expiry) and sends an invitation email via Resend. Rows with invalid emails or missing names are recorded as errors and shown in the import result — the rest of the batch still processes.
Past imports and their error logs are available under Sellers → Import History.
Operator API
For programmatic integrations, Iraca provides an external Operator API accessible via API keys (separate from your portal login).
API keys are managed under Operator Portal → Settings → API Keys:
- Create a key with an optional scope restriction (
sellers,revenue,remittances,listings,config) - The full key is shown once at creation — store it immediately
- Keys are prefixed
iak_live_...for easy identification - Revoke keys any time; revocation is instant
Base URL: https://app.iraca.io/api/v1/operator-api/
Authentication: Authorization: Bearer iak_live_...
Available endpoints (read-only in v1):
GET /sellers— list attributed sellersGET /sellers/{id}— seller detail with health scoreGET /revenue/summary— real-time revenue breakdownGET /revenue/events— paginated attribution ledgerGET /remittances— remittance batch historyGET /revenue/forecast— 3/6/12-month revenue projections
Revenue Forecasting
Operator Portal → Revenue → Forecast shows forward-looking projections based on trailing 3-month averages:
- Monthly average — your average operator share over the last 3 months
- Churn adjustment — sellers with a health score below 40 are flagged as at-risk; their share slightly reduces the projection (conservative 10% weight)
- 3 / 6 / 12-month projections — monthly average × growth factor × horizon
- By stream — trailing average broken down by subscription renewals, add-ons, promoted listings, and buyer subscriptions
Forecasts are informational only — they are not commitments and do not account for new seller onboarding, marketplace growth, or plan pricing changes.
B2B Advertising Placements
Beyond promoted listings (which boost a single product), operators can offer structured advertising placements — fixed positions on the marketplace storefront that sellers can purchase for a set duration.
Available positions:
banner_top— full-width banner above the listing grid (1200×200)banner_mid— mid-page banner within the listing feed (1200×150)category_featured— featured slot within a specific product category (400×400)search_boost— keyword-targeted visibility in search resultssidebar— right-rail sidebar slot (300×600)
Sellers purchase placements from Iraca → Marketplace → Advertising. They set headline, image, CTA, and targeting (category or keywords). Revenue from placements is split per your rev-share rate and included in the next remittance cycle.
Operators can view active placements and impression/click performance from the operator portal.
Custom Domain Support
Each marketplace can be accessed at a custom domain (e.g. austinfarmersmarket.com). Domain setup has two steps:
- Verify DNS ownership — add the TXT record shown in Operator Portal → Marketplace → Domain to your DNS provider. Iraca checks for the record and marks the domain as verified.
- SSL provisioning — once verified, Iraca provisions a Let's Encrypt certificate automatically. SSL status (
pending → provisioning → active) is shown in the portal.
Until SSL is active, the marketplace is accessible at {slug}.iraca.io as a fallback.
Help Content
Operators can publish custom help articles visible to sellers and buyers on the marketplace. Manage articles under Operator Portal → Marketplace → Help Content.
Each article has a title, slug, body (plain text or Markdown), and an optional category for grouping. Articles are served publicly at GET /api/v1/marketplace/{slug}/help and surfaced in the marketplace frontend's help section.
Accounting Export
In addition to PDF remittance reports, CSV exports are available for accounting reconciliation:
- Revenue events CSV —
Operator Portal → Revenue → Export: all revenue events with date, type, seller, gross, gateway cost, operator share, Iraca share, and remittance status. Filterable by date range, event type, and status. Compatible with manual import into QuickBooks or Xero. - Batch CSV —
Operator Portal → Remittances → [batch] → Export CSV: line-item detail for a specific remittance period, including a summary row followed by individual events.