T
TOMO
Developer Docs
BETA These docs are under partner review. Some features described are roadmap items, not yet shipped. Verify against your sandbox before relying on any contract.

marketplace.buy_used_electronics

Buy refurbished / pre-owned electronics (phones, laptops, tablets, cameras, gaming, audio) through TOMO partners (Cashify / 2GUD / Apple Certified Refurbished / Amazon Renewed / Yaantra). Grade-verified, warranty-backed, IMEI/serial-checked. TOMO is the discovery + comparison surface; partner holds money + warranty + return rail.


1. Identity

  • Intent ID: marketplace.buy_used_electronics
  • Vertical: marketplace
  • Verb: buy
  • Noun: used_electronics
  • Primary agent: MarketplaceAgent
  • Sub-agents (DATA only): FinanceAgent (no-cost EMI), LogisticsAgent (delivery ETA), SafetyAgent (IMEI blacklist / stolen-device check)
  • Single-intent → completed action: shortlist → grade-verified listing → checkout → delivery scheduled
  • Handoff layer: L2

2. NL Coverage

  • "buy used iphone"
  • "refurbished macbook air below 60000"
  • "second hand laptop for college"
  • "cashify iphone 13 quote"
  • "amazon renewed iphone"
  • "buy used dslr nikon"
  • "refurbished ps5"
  • "good condition used iphone 12 mini"
  • "pre-owned airpods pro"
  • "used iphone with warranty"

Must NOT match: "sell my phone" (→ marketplace.sell_used_electronics), "repair my laptop" (→ auto_service.book_service rejects; this routes to electronics-repair intent if exists).


3. Input (slots)

Slot Type Required Source
category enum [smartphone, laptop, tablet, camera, gaming, audio, wearable, monitor] HARD NL
brand string SOFT NL
model string SOFT NL
budget_max_inr int HARD NL or default category baseline
grade_min enum [unboxed, like_new, superb, good, fair] SOFT NL or default good
warranty_min_days int SOFT NL or default 90
delivery_pincode geo HARD saved or NL
finance_required bool SOFT NL

4. Provider Tools

  • search_inventory(filters){listings[], total, partner_id}
  • get_listing_detail(listing_id){imei_or_serial, grade, condition_report_url, photos[], original_purchase_year, warranty_days, return_window_days, partner_price_inr}
  • verify_imei(imei){stolen_blacklist, carrier_lock, activation_lock, original_warranty_status}
  • lock_listing(listing_id, hold_minutes){lock_id, expires_at}
  • initiate_purchase(lock_id, payment_method){transaction_id}
  • arrange_delivery(transaction_id, address){logistics_id, eta_hours}

5. Response Shape

  • Region 1 — INTELLIGENCE: imei_clean=true, activation_lock_clear, grade, warranty_days, return_window_days, original_box_included, accessories_included[]
  • Region 2 — summary: "{count} {category} listings, {grade}+ grade, ≥{warranty_days}d warranty."
  • Region 3 — visual: partner-uploaded condition photos (NOT stock for unboxed/like_new/superb)
  • Region 4 — NOW pin: nearest delivery ETA + lock timer
  • Region 5 — CHOICES: OK (lowest price, meets HARD), GOOD (balanced), GREAT (best grade + longest warranty + accessories)

6. Controlled Vocabularies

  • category: smartphone | laptop | tablet | camera | gaming | audio | wearable | monitor
  • grade: unboxed | like_new | superb | good | fair
  • partner: cashify | 2gud | apple_refurbished | amazon_renewed | yaantra | flipkart_refurbished
  • hard_filter_reject: imei_blacklist | stolen_alert | activation_lock_active | carrier_lock_active | parts_authenticity_fail
  • accessory: original_box | charger | cable | earphones | stylus | strap | adapter

7. TTBS Dimensions

Dim Weight Signal
Time 0.15 delivery ETA, return-window window
Taste 0.25 brand fit, colour, storage variant
Budget 0.35 price within budget, no-cost EMI fit, no hidden fees
Safety 0.25 IMEI clean, activation/carrier unlocked, warranty active, partner return policy

8. Completion Contract

Complete when:

  1. Buyer checkout confirmed
  2. Partner transaction_id returned + IMEI/serial logged
  3. Delivery scheduled (logistics_id present)
  4. CPC: event=purchase_completed, amount_inr = partner referral fee

9. Widget

  • CHOICES card: 3 tiers with hero photo + price + grade badge + warranty chip
  • DETAIL bubble: condition photo carousel, condition report PDF, IMEI-clean chip, accessory list, return-window chip
  • CHECKOUT: payment + address + delivery ETA
  • POST-PURCHASE: tracking + warranty card + return window timer

NEVER show: AI-rendered photos for graded devices, synthetic ratings, "lowest price guaranteed".


10. Caching Policy

Key TTL Invalidate on
listing:{partner}:{listing_id} 5 min edit, sold
imei_blacklist:{imei} 24 h refresh
partner:reputation:{partner} 7 days complaint spike
delivery_eta:{pincode} 1 h logistics rail change

11. Error Codes

Code Meaning UX
MKT_LISTING_SOLD already sold suppress
MKT_IMEI_BLACKLIST hard block reason chip
MKT_LOCK_EXPIRED hold timed out re-lock
MKT_FINANCE_REJECT EMI declined alt lenders
MKT_DELIVERY_REGION_UNSERVICEABLE pincode out alt pickup
MKT_WARRANTY_EXPIRED listing warranty lapsed suppress or flag

12. Sandbox → Production Checklist

  • 100 sample listings across 4 partners
  • IMEI blacklist API 50 sample IMEIs
  • Condition report PDF render
  • Delivery ETA in 5 pincodes
  • CPC HMAC 50 events
  • Grade ENUM mapping audit per partner
  • Anti-fab audit

13. Anti-Fabrication Rules

  • NEVER paid placement
  • NEVER AI photos for graded items
  • NEVER synthesise grade
  • NEVER hide IMEI blacklist status
  • NEVER claim "best price" without partner-cited comparison
  • NEVER claim TOMO holds warranty (partner does)
  • NEVER cache IMEI clean status >24h

14. Regulatory Framing

  • Consumer Protection Act 2019 — pre-owned/refurbished category must declare grade + warranty
  • BIS — partner responsible for spurious-part liability
  • DGFT — imported refurbished electronics under MeitY E-Waste Rules 2022
  • DoT IMEI — IMEI blacklist check via CEIR (Central Equipment Identity Register)
  • DPDPA 2023 — buyer PII to partner only
  • GST — partner margin scheme on used electronics from individual sellers
  • MeitY E-Waste Management Rules 2022 — partner must accept device-for-recycle if buyer returns under EOL