Skip to content

Buyer Guide

How buyers discover, pay for, and use agents on AgentDukaan. Each of the four listing types has its own purchase and delivery flow.

Discover

  • Homepage (/) — featured agents + category chips.
  • Catalog (/listings) — filter by type (hosted / code / dfy / guide), category, India integration, price, and full-text search. Results are quality-ranked (review quality + seller trust + traction + responsiveness + freshness).
  • Listing detail (/listings/[id]) — description, demo video, the ROI / before-after / running-cost panels, reviews, and a seller trust block. The call-to-action depends on the type.
  • Seller profile (/sellers/[id]) — a seller's verification tier, rating, sales, listings, and reviews.

Sign-in is email-OTP or Google (/login). Buying anything redirects you to log in first if needed.

Hosted agent → subscribe

  1. On the listing, Start free trial or Subscribe (→ POST /api/subscriptions). Hosted agents bill monthly; trials need no card.
  2. If the seller built a setup wizard, fill it in — business details, preferences, and any API keys/credentials the agent needs (each credential step can include a provider guide showing exactly how to get the key). Known keys (OpenAI, etc.) are validated on submit, so a wrong key is caught before activation. Submit → POST /api/subscriptions/:id/setup.
  3. Your keys are encrypted at rest and never handed to the seller to keep — their agent pulls them only when it runs, over a signed request. The seller's agent is notified and provisions itself for you.
  4. Manage everything from /dashboard: status (trialing / active / paused / cancelled), a health badge (✓ Running once the agent reports its first run, or Awaiting first run), last-run time, usage against your monthly run limit, and pause / resume / cancel. Billing history is at /dashboard/billing.
  5. If the agent needs a credential fixed (e.g. an expired token), you'll see an "action needed" prompt to re-enter just those fields.
  6. If you cancel, your saved configuration (including any keys) is kept so you can reactivate and pick up where you left off — then permanently deleted ~30 days after cancellation. Reactivating before then restores it. You can also rotate a key any time from the dashboard.

Source code → buy a license

  1. Buy license on the listing → POST /api/purchases/initiate → pay via Razorpay → POST /api/purchases/confirm. Pick the license tier (single / multi / unlimited deploys) that matches how you'll use it.
  2. You receive a license key and a support thread (open for the listing's support window).
  3. /purchases/[id] is your home for the agent:
    • Download the source zip — each download link is valid 24 hours and counts against your download allowance (3 by default; ask support to top up).
    • Setup & deploy guide — the seller's setup-docs PDF (when provided) plus a step-by-step deploying a source-code agent walkthrough and an in-product next-steps checklist.
    • Support thread with the seller (response SLA shown on the listing; the seller can extend the window).
    • Feature requests — ask the seller for improvements and upvote others'.
  4. Updates: when the seller ships a new version you're notified and can download it from the purchase page; the version you originally bought stays available.
  5. Need help deploying? Many sellers offer a paid setup plan — buy it right from the purchase page (the seller deploys/configures it; you still enter your own keys, which the seller never sees).

Done-for-you → place an order

  1. Choose a package, fill the intake form, and order → POST /api/orders/initiate → pay → POST /api/orders/confirm. Funds are held in escrow.
  2. Track the order at /orders and /orders/[id]: message thread with the seller, milestones, delivery deadline, and auto-release date.
  3. When the seller marks it delivered, either Accept (releases payment) or Request a revision (within your package's revision limit). If you do nothing, escrow auto-releases 7 days after delivery.
  4. If something's wrong, raise a dispute (POST /api/orders/:id/dispute) — an admin reviews and rules.

Build-it guide → buy & build

  1. Get the guide → same one-time purchase flow as source code (/api/purchases/initiate → confirm).
  2. /purchases/[id] shows the guide's steps and files, each as a signed download (PDFs, prompt packs, configs). Step prompt text and files are only revealed after purchase.
  3. Follow the steps to build the agent yourself; support is available for the listing's support window.

Reviews

After a verified subscription, purchase, or order you can leave a review (1–5 stars + category ratings: value, communication, setup ease) via /review. Reviews are editable for 7 days, and sellers can reply. Reviews drive seller ranking and trust badges.

Referrals

Share your referral link from /referral. When someone you referred transacts, you earn ₹500 credit (applied to future purchases). Codes are validated at /api/referrals/check/:code.

Notifications & WhatsApp

  • /notifications (and the header bell) — order updates, QA results, badge upgrades, referral wins, etc. Polls every 60s.
  • Add a WhatsApp number in settings to get transactional alerts; reply STOP to opt out, START to opt back in.

See the Seller Guide for the other side of the marketplace.