Seller Registration & Buyer Accounts
This article covers two flows introduced in the Marketplace Operator Program: co-branded seller sign-up via invitation link, and the buyer account experience including paid plan subscriptions.
Seller Registration via Invitation Link
When a Marketplace Operator invites a vendor, they share an invitation link that looks like:
https://app.iraca.app/register?token=<invitation-token>What the seller sees
- The registration page loads with the operator's branding — their logo, name, and accent color — displayed above the form.
- The plan picker is hidden. The plan is determined by the invitation token (typically
marketplace_seedling). - The seller fills in their business name, email, and password, then clicks Create Account.
- Their account is created, the invitation token is consumed (single-use), and they are logged in.
What happens on the backend
- The token is validated before the account is created. If the token is expired, already used, or invalid, the form shows an error and prevents submission.
- The tenant is automatically assigned the plan specified in the token (
plan_override). If none is set, the default Seedling plan is used. - The token is marked used after the tenant record is committed, so a failed account creation never burns the token.
- The operator's branding details are returned in the registration response, and the seller's login page shows a welcome message from the operator.
If the token is invalid
The registration page shows a warning banner and disables the submit button. The seller should contact the operator to request a new invitation link.
Buyer Accounts
Buyers are shoppers or business purchasers who browse marketplace storefronts. They have separate accounts from Iraca tenants (vendors).
Signing up as a buyer
- Visit any marketplace storefront (e.g.,
austinfarmersmarket.iraca.io). - Click Sign In or Register in the top-right corner of the hero banner.
- On the registration page, enter your name, email, password, company name (optional), and role (e.g., Retailer, Importer).
- After registering, you are taken to My Account.
Buyer sessions are stored per marketplace — signing into one marketplace does not sign you into another.
My Account
After signing in, click My Account in the top-right corner of the storefront. Your account page has three tabs:
Plans
Shows all paid buyer plans offered by the marketplace operator. Each plan lists the price and billing interval. Click Subscribe on a plan to be taken to a secure Stripe Checkout page. After payment, you are redirected back and your subscription is active immediately.
Your current plan is highlighted with a badge. You cannot subscribe to your current plan again.
My Subscription
Shows your active subscription: plan name, status, and the next renewal date. If you have no subscription, this tab prompts you to browse plans.
To cancel: click Cancel Subscription, confirm in the dialog, and your access continues until the end of the current billing period.
My Inquiries
A history of all inquiry messages you have sent to vendors through this marketplace. Each entry shows the listing title, your message, the inquiry status (new / read / responded / closed), and the date.
Signing out
Click Sign Out in the top-right corner of the My Account page. Your session for this marketplace is cleared.
Operator notes
- Buyer plans are created in the Marketplace admin panel under Buyer Plans. Each plan requires a Stripe Price ID.
- Gated fields on listings or vendor profiles become visible to buyers once they subscribe to the plan linked to that field. Field visibility is enforced server-side — buyers cannot access gated data by manipulating the request.
- Buyer verification (marking a buyer as a verified business) is done manually in the Buyers section of the operator admin panel. Verification unlocks B2B pricing and wholesale contact forms on listings that require it.