{"slug":"platform/13-marketplace","title":"13 — Marketplace","section":"platform","sectionLabel":"Platform","status":"unclassified","type":"document","path":"platform/13-marketplace.mdx","bytes":2118,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n> **Extracted from:** IntegrateWise Platform Specification Suite\n> **Region:** first_pass\n> **Original line:** 1157\n> **Lines:** 40 | **Chars:** 1,905\n> **Status:** Raw extraction — requires review and canonicalization\n\n13 — Marketplace\n13.1 Responsibilities\nListings for Connectors, Capabilities, Workflows, Design Packs, Persona Kits.\nInstallation, upgrade, uninstall, reinstallation, tenant migration.\n13.2 Listing model\nCopymkt*listing:\nid: mkt_listing*…\nvendor: org\\_…\nkind: connector|capability|workflow|design_pack|persona_kit\nversion: semver\nvisibility: public | tenant_only | beta\npermissions: [scopes…]\npricing: free | trial | metered | seat\ntrial_days: 14\nartifacts: [signed bundle URLs]\naudits: last_review_at, reviewer\n13.3 Installation lifecycle\nCopydiscover ──▶ trial ──▶ purchase ──▶ installed ──▶ upgraded ──▶ (uninstalled | reinstalled)\n│ │ │\n▼ ▼ ▼\nrefunded downgraded archived\n13.4 Tenant migration\nMigrating a listing installation is a re-bind; IDs preserved via installation_id.\nRevoked listing → all hanging tenants receive ListingRevoked event.\n13.5 Permissions / Billing / Trial / Uninstall / Reinstall\nPermissions enforced by Governance (09) on first invocation.\nBilling via Stripe (CF Worker integration); usage events emitted for metered SKUs.\nTrial marks tenant with trial=true; expiry triggers downgrade flow.\nUninstall revokes tokens, archives projection cache, retains audit (16).\nReinstall uses installation_id to keep Connector credentials rotation-safe.\n13.6 Events\nProduced: ListingInstalled, ListingUpgraded, ListingTrialStarted, ListingUninstalled, ListingRevoked, ListingBilled.\nConsumed: CapabilityRegistered, WorkflowRegistered.\n13.7 APIs\nPOST /marketplace/listings, POST /marketplace/install, POST /marketplace/{mkt_id}/uninstall, POST /marketplace/{mkt_id}/upgrade.\n13.8 Failure handling\nInstall auth failure → reject + admin notification.\nUninstall mid-call → mark pending then finalize.\n13.9 Extension points\nVendors onboard through SDK (17), validated by automated review and manual sign-off.\n"}