K
KiflyDeveloper Docs
Sign up →
Seller Network

Seller Onboarding

List your products on Kifly to make them discoverable and purchasable by AI agents.

What you get

  • A public agent-readable storefront at kifly.ai/store/{your-handle}
  • Semantic product search — agents find your products through vector search, not keyword matching
  • Multilingual discovery — buyers in any language can find your listings
  • Four payment rails: Stripe Payment Link (live), Coinbase Commerce, Stripe MPP, and x402 USDC on Base (all beta except Rail 1)
  • Order management in the Kifly portal with email notifications and tracking support
  • API keys for programmatic access

Sign up

  1. Go to kifly.ai, open the Sign in menu, and choose Seller (or follow the Sync your store on Kifly link)
  2. Sign in with Google — your seller account is tied to your Google identity
  3. Choose a store handle (e.g. acme-goods) — this becomes your storefront URL and the identifier agents pass to create_cart
  4. Complete your store profile: display name, description, and delivery settings

No monthly fees during the current network expansion. Transaction fees apply at settlement.

Listing products

Fastest path — import from your store URL. On Products, click Import from URL and paste a link to your existing storefront. Kifly reads the page's structured product data and stages your catalog as drafts — review them, then publish the ones you want live. Nothing on your original store changes; the import is read-only.

Or add a product manually from the Kifly portal:

  1. Go to Products → Add product
  2. Fill in title and description
  3. Set a price — products cannot be published without a price
  4. Upload at least one product image — required for publication
  5. Choose a Google Product Taxonomy category — required for agents to filter by category
  6. Define variants if applicable (size, color, etc.)
  7. Set delivery zones or configure delivery coverage (see below)
  8. Click Publish — your product becomes immediately searchable by agents

All three requirements (price, image, category) must be met before the Publish button becomes active. Products appear in semantic search within seconds of publishing.

Delivery coverage

Configure where you deliver under Store Settings → Delivery.

Recommended: delivery coverage (states + cities)

Set the US states and/or cities you deliver to. Agents validate the buyer's address against this list before checkout — no failed orders from undeliverable addresses.

Coverage: states: ["CA", "OR", "WA"] + cities: ["Las Vegas"]
→ Eligible: San Francisco CA ✓, Portland OR ✓, Las Vegas NV ✓
→ Ineligible: Austin TX ✗

Legacy: delivery zones (postal codes)

If you entered postal-code ranges in delivery zones, those are also checked. Prefer delivery coverage — the postal-code zone format is deprecated and new sellers should not use it.

Receiving orders

When an agent purchases one of your products:

  1. You receive an email notification
  2. The order appears under Orders in the portal with item details, buyer shipping address, and payment confirmation
  3. Fulfill and ship — add tracking information in the portal so agents can surface it to buyers via order_status

API access

Generate API keys from Settings → API Keys. Keys start with kfa_live_ and authenticate agent requests against your catalog.

UCP discoverability

Your store is automatically listed in Kifly's Universal Commerce Protocol (UCP) capability manifest at kifly.ai/.well-known/ucp. Any UCP-aware agent can discover Kifly's catalog, payment rails, and MCP connection details without prior configuration.