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.sell_used_electronics

Sell used electronics through TOMO partners (Cashify / Yaantra / Instacash / Apple Trade-In / Samsung Upgrade). Instant quote → at-home diagnostic → escrow payout. TOMO is the listing/quote conversational surface; partner holds money + diagnostic + data-wipe rail.


1. Identity

  • Intent ID: marketplace.sell_used_electronics
  • Vertical: marketplace
  • Verb: sell
  • Noun: used_electronics
  • Primary agent: MarketplaceAgent
  • Sub-agents (DATA only): SafetyAgent (data-wipe-certificate verification), LogisticsAgent (at-home pickup)
  • Single-intent → completed action: instant quote → at-home diagnostic → data wipe → escrow payout
  • Handoff layer: L2

2. NL Coverage

  • "sell my iphone"
  • "cashify quote for my macbook"
  • "sell my old laptop"
  • "trade in iphone for new"
  • "what is my ipad worth"
  • "sell my dslr nikon d5600"
  • "sell my ps4"
  • "instant cash for my phone"
  • "sell airpods used"
  • "at-home pickup sell phone"

Must NOT match: "buy used electronics", "repair my phone".


3. Input (slots)

Slot Type Required Source
category enum HARD NL
brand string HARD NL
model string HARD NL or partner picker
variant_storage string SOFT NL
purchase_year int SOFT NL
condition_self_declared enum [unboxed, like_new, superb, good, fair] HARD quiz
imei_or_serial string HARD seller declared
accessories_present[] enum SOFT quiz
pickup_address geo HARD saved or NL
pickup_slot datetime HARD partner calendar
payout_method enum [upi, bank_transfer, partner_credit, store_voucher] HARD NL

4. Provider Tools

  • get_instant_quote(category, brand, model, variant_storage, purchase_year, condition_self_declared){quote_inr, quote_ttl_min, quote_id}
  • schedule_pickup(quote_id, pickup_address, slot){visit_id, executive_name, eta_min}
  • submit_diagnostic_report(visit_id){final_offer_inr, delta_inr, downgrade_reasons[]}
  • accept_offer(visit_id){transaction_id, escrow_state}
  • submit_data_wipe_certificate(transaction_id){wipe_cert_id, standard, signed_at_iso}
  • release_payout(transaction_id){utr, settled_at_iso}
  • cancel_visit(visit_id, reason){cancellation_fee_inr}

5. Response Shape

  • Region 1 — INTELLIGENCE: quote_ttl_min, data_wipe_standard, payout_eta_min, safety_flags, accessories_required_for_max_quote[]
  • Region 2 — summary: "₹{quote_inr} instant quote, valid {ttl} min. Final after at-home diagnostic + data wipe."
  • Region 3 — visual: stock reference photo
  • Region 4 — NOW pin: nearest pickup slot + executive badge
  • Region 5 — CHOICES: OK (highest quote), GOOD (balanced), GREAT (best match-rate + fastest payout)

6. Controlled Vocabularies

  • category: smartphone | laptop | tablet | camera | gaming | audio | wearable | monitor
  • condition_self_declared: unboxed | like_new | superb | good | fair
  • partner: cashify | yaantra | instacash | apple_tradein | samsung_upgrade | flipkart_smartbuy
  • payout_method: upi | bank_transfer | partner_credit | store_voucher
  • data_wipe_standard: nist_800_88 | dod_5220_22m | factory_reset_with_overwrite
  • downgrade_reason: screen_cracked | battery_health_below_80 | speaker_fault | camera_fault | port_damage | back_panel_dent | software_locked | accessory_missing | water_damage_indicator | imei_mismatch
  • accessory: original_box | charger | cable | earphones | stylus | strap

7. TTBS Dimensions

Dim Weight Signal
Time 0.20 quote TTL, pickup ETA, payout SLA
Taste 0.10 partner brand preference
Budget 0.40 quote, downgrade history, payout speed
Safety 0.30 data wipe certificate, executive ID badge, escrow protection, female-friendly toggle

8. Completion Contract

Complete when:

  1. Seller accepts final offer
  2. escrow_state=escrow_held AND wipe_cert_id present
  3. Payout utr settled
  4. CPC: event=sale_completed, amount_inr = referral fee

9. Widget

  • CHOICES card (3 partners)
  • HONESTY strip: "Final offer may differ — average downgrade for {category} = ₹{X}"
  • SLOT picker + female-executive toggle
  • POST-DIAGNOSTIC reveal: final + delta + plain-English reasons + Accept/Reject
  • DATA WIPE confirmation: certificate ID + standard + signed timestamp
  • PAYOUT pill: pending → held → settled (UTR)

NEVER show AI photos, fake exec ratings, "guaranteed best price".


10. Caching Policy

Key TTL Invalidate on
instant_quote:electronics:{category}:{brand}:{model}:{variant}:{year}:{condition} quote_ttl_min (max 720) partner price refresh
partner:reputation 7 days complaint spike
executive:availability 15 min bookings

No caching of final offer or wipe-cert.


11. Error Codes

Code Meaning UX
MKT_QUOTE_EXPIRED TTL elapsed regenerate
MKT_IMEI_BLACKLIST hard block reason chip
MKT_DEVICE_LOCKED iCloud/Google account active unlock prompt
MKT_EXEC_NO_SHOW SLA breach reschedule + credit
MKT_DOWNGRADE_EXCESSIVE final < 75% quote honesty + cooling-off
MKT_WIPE_FAILED wipe error freeze + partner support
MKT_PAYOUT_BANK_FAIL UTR rail fail freeze + support

12. Sandbox → Production Checklist

  • 100 sample devices across 4 partners
  • IMEI sandbox verify
  • Diagnostic dispatch 3 cities
  • Data-wipe cert flow tested per partner
  • Payout rail 10 × ₹1
  • CPC HMAC 50 events
  • Downgrade ENUM audit
  • Female-exec toggle
  • Anti-fab audit

13. Anti-Fabrication Rules

  • NEVER paid placement
  • NEVER AI seller-device photos
  • NEVER synthesise market-comparison ₹
  • NEVER fake exec ratings
  • NEVER claim TOMO performs data wipe (partner does)
  • NEVER hide downgrade reasons
  • NEVER cache final offer

14. Regulatory Framing

  • DoT IMEI / CEIR — partner verifies IMEI clean
  • DPDPA 2023 — data wipe is partner's legal obligation; certificate retained 3 years
  • MeitY E-Waste Management Rules 2022 — partner must channel devices through authorised recyclers if not resaleable
  • Consumer Protection Act 2019 — grade + downgrade disclosure mandatory
  • GST — partner margin scheme on resale
  • Income Tax — individual sale below ₹50k cash payout = exempt; above = bank/UPI mandatory
  • Cybercrime advisory — TOMO never asks for device password / Apple ID / Google account