nick/nick-doc
3
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
docs/multi-surface-guide
nick-doc/06 - Usage/Seller Guide.md

12 KiB
Raw Permalink Blame History

title, tags, audience, created
title tags audience created
Seller Guide
usage
role/seller
role/owner
Seller (Owner) 2026-05-23

Seller Guide (Owner)

End-to-end usage for a Seller (Shop Owner) — the person who responds to buyer purchase requests, fulfils orders, and withdraws escrow funds.

[!info] Looking for a different role? See User Guide (Buyer), Admin Guide, Support Guide.

1. Becoming a Seller

You can either:

  • Sign up as Seller at registration (/auth/jwt/sign-up → choose role = Seller).
  • Upgrade from Buyer: existing buyer → Dashboard → Account → Become a seller → submit shop info → admin verification.

Either path requires:

  • Verified email
  • Phone number on file (some regions require KYC)
  • Initial shop info (name, country, payout wallet address)

2. Configuring your shop

2.1 Shop branding

Dashboard → Shop Settings → Settings:

Field Notes
Shop name Public; shown in shop URL /shop/{slug}
Tagline One-line summary on the shop card
About Rich-text editor (use the editor for headings, lists, links)
Avatar / logo 256×256 recommended
Cover image 1600×400 recommended
Category specialisations Tag your shop with categories you cover
Country / Region Used for delivery filters
Default response time "I usually respond within X hours"
Default delivery window "Typical fulfilment 3–5 business days"

2.2 Social links

Shop Settings → Socials: Twitter, Instagram, Telegram, website. Shown on your public shop page.

2.3 Security

Shop Settings → Security:

  • Withdraw confirmation requires email code (recommended)
  • Two-factor authentication
  • Login alerts

2.4 Payout wallet

Account → Wallet or Shop Settings → Payout:

  • Add a crypto address you control on the supported networks (BSC, Polygon, …).
  • All payouts (escrow releases) go here.
  • You can change it, but new payouts go to the new address — past payouts are settled to whichever address was active at the time.

Warning

Your payout address is the single source of funds out of escrow. Triple-check it. If it's wrong, funds can be irretrievably lost.

2.5 Payment methods

Shop Settings → Payments controls the default payment rails for templates that inherit shop settings:

  • Choose at least one supported network, such as Ethereum or BSC.
  • Choose at least one supported token, such as USDT or USDC.
  • Individual request templates can override these defaults with their own accepted network/token list.

3. Request Templates

Templates are pre-defined product/service offerings. Buyers can create a request from your template with one click.

3.1 Create a template

Dashboard → Request Templates → + New:

  1. Title — what you sell ("Vintage leather jacket", "Custom logo design").
  2. Category — primary category.
  3. Description — rich text, use images.
  4. Pricing — fixed price or "starts at" range. Specify currency.
  5. Delivery method — choose either physical delivery or online/email delivery. Buyers cannot override this at checkout.
  6. Payment methods — choose at least one network and one token for the template, or explicitly inherit shop defaults.
  7. Delivery window — typical days from acceptance.
  8. Customisations — list of options (size, color, quantity) buyers can choose.
  9. Videos (optional) — embed up to N video URLs.
  10. Default proposal — your standard offer text that auto-populates when a buyer creates from this template.
  11. Expiration — leave blank for evergreen; set a date for limited-time offers.
  12. Visibility — public (anyone can use) or unlisted (shareable URL only).

Click Publish. You'll get a shareable URL: https://amn.gg/shop/{seller}/{templateId}.

For physical templates, checkout asks the buyer for a delivery/billing address. For online templates, checkout asks the buyer for the email that should receive the digital item.

3.2 Manage templates

Dashboard → Request Templates shows all templates with:

  • Status (active / expired / draft)
  • Usage count (how many buyers used it → became a real request)
  • Conversion rate (used → accepted)
  • Quick edit / clone / disable

See RequestTemplate and Purchase Request Flow.

4. Finding open buyer requests

Once your shop is configured, you can browse incoming buyer demand.

4.1 Public requests

Dashboard → Shops → Browse (or via the marketplace surface):

  • Filter by category, budget range, delivery deadline, buyer location.
  • Sort by recency, budget, urgency.
  • Click a request for details.

4.2 Invited requests

If a buyer specifically invites you (often via a template URL), the request appears under Dashboard → Requests → Invited.

4.3 Notifications

  • New public request matching your specialisation → notification + email (if enabled).
  • Direct invitation → push notification.

5. Submitting an offer

On a request detail page → Submit offer:

  1. Your price (in the buyer's requested currency).
  2. Delivery window (days from acceptance).
  3. Notes (rich text — explain your approach, materials, brand, etc.).
  4. Attachments (optional — photos of work samples, references).
  5. Expire offer in (default 7 days) — after which the offer auto-rejects.

Click Send offer. The buyer is notified instantly via socket.

Tip

Offers with personalised notes convert ~3× better than generic ones. Show the buyer you read their request.

See Seller Offer Flow.

6. Negotiating

The buyer may message you to discuss:

  • Lowering your price
  • Faster delivery
  • Customisations not in your template

You can:

  1. Reply via chat to explain or negotiate.
  2. Issue a counter-offer — opens a new offer slot replacing your previous one.
  3. Accept their counter-proposal if they sent one.

See Negotiation Flow.

7. Acceptance — what happens

When the buyer accepts your offer:

  1. All other sellers' offers on this request are auto-rejected.
  2. Status moves to Accepted.
  3. The buyer is prompted to pay into escrow.
  4. You receive a notification.
  5. You can prepare to fulfil — but DO NOT ship until escrow is funded.

Warning

Shipping before funding = you have no recourse if buyer never pays. Always wait for status = Funded.

8. Fulfilment

Once status = Funded:

  1. Prepare the item / service.
  2. On the request page → click Mark as shipped.
  3. Optionally add:
    • Tracking number + carrier
    • Photos of packed item
    • Notes for buyer
  4. The buyer is notified.

For digital goods (designs, files): upload via the request's Deliverables section. Buyer is notified to confirm.

See Delivery Confirmation Flow.

9. Getting paid

When the buyer confirms receipt → status = Delivered → escrow released.

Important

Today, escrow release after confirmation triggers a payout request which an admin manually processes. See Payout Flow. Payouts typically clear within 1–2 business days.

9.1 Withdraw

Dashboard → Payment → Payouts lists pending and processed payouts.

For self-service withdrawal (if enabled):

  1. Click Request payout.
  2. Confirm your payout wallet address.
  3. Enter the amount (≤ available balance).
  4. Submit.
  5. Status moves through pending → processing → completed.

Once completed, you'll see the on-chain transaction hash linking to a block explorer.

10. Disputes

If a buyer opens a dispute:

  1. You're notified immediately.
  2. The escrow is paused — neither party can move funds until the dispute resolves.
  3. Open the dispute page → review the buyer's claim and evidence.
  4. Submit your evidence: photos (e.g., shipped item, packaging proof), chat screenshots, tracking confirmation.
  5. Write a clear response narrative.
  6. An admin mediator reviews both sides and issues a decision.

Possible outcomes:

  • Full refund to buyer (dispute upheld) — you lose the sale + may lose listing if pattern.
  • Partial refund — split.
  • Release to you (dispute denied) — full payout proceeds.
  • Mutual cancellation — agreed refund.

Tips to win disputes:

  • Always include proof of shipping with timestamp.
  • Save chat screenshots (the platform retains them, but redundant proof helps).
  • Respond to disputes within 24 hours.
  • Don't argue with the buyer publicly in chat — let the mediator decide.

See Dispute Flow.

11. Reviews

After each completed transaction:

  • Buyer rates you (1–5 stars + comment).
  • You rate the buyer.

Your overall rating is shown on every offer you make. Common rating thresholds:

  • 4.8+ — Top-rated badge, priority listing
  • 4.0–4.7 — Normal
  • <4.0 — Limited visibility, manual review may follow

Respond to negative reviews professionally — your reply is public.

12. Analytics

Dashboard → Overview shows your seller KPIs:

Metric Description
Open requests Active conversations
Acceptance rate Offers accepted / submitted
Avg. response time How fast you reply
Avg. delivery time From accept to ship
Revenue (30/90/365 days) Net of fees
Active templates Live request templates
Rating Current overall stars
Dispute rate % of orders disputed

Improve weak areas to climb the seller leaderboard.

13. Earning points (Seller side)

Sellers earn points for:

  • Each successful sale
  • Maintaining high rating
  • Fast response times
  • Referring other sellers / buyers

Points unlock benefits — see User Guide §12 and LevelConfig.

14. Settings

Same as Buyer (theme, language, notifications, security) plus:

  • Auto-decline new requests when busy (set a date range).
  • Vacation mode — pause public visibility without losing offers in flight.
  • Tax info — if applicable in your jurisdiction.

15. Common issues

"My offer isn't getting acceptance"

  • Compare your price to similar offers (visible in the request side panel).
  • Improve your default response time & rating.
  • Add personalised notes to each offer.
  • Use rich descriptions in templates.

"Escrow funds not showing up after delivery"

Warning

Auto-release on delivery confirmation is not yet automated — an admin manually triggers payouts on a schedule. Allow 1–2 business days.

If it's been longer, contact support.

"Wrong payout address"

If you noticed a wrong address BEFORE the payout was sent → update in Shop Settings → Payout and contact support.

If the payout was already broadcast → recovery requires on-chain coordination; contact support immediately with the transaction hash.

"Dispute opened — what to do first"

  1. Don't panic.
  2. Read the buyer's claim carefully.
  3. Gather all proof (shipping receipts, photos, chat history).
  4. Submit evidence within 24 hours.
  5. Be respectful in your narrative.

"Need to take time off"

Set Vacation mode in Shop Settings. New requests auto-decline with a courteous message; existing orders proceed normally.

16. Tips & best practices

Tip

  • Reply fast — first responder often wins.
  • Photos sell — clear, well-lit images convert.
  • Be specific in delivery dates — buyers value predictability.
  • Use templates for repeat offerings — saves time, increases conversion.
  • Build a portfolio in your shop About — recent work, certifications.
  • Respond to ALL reviews — even one-line "Thank you" helps.

17. Related

Reference in New Issue View Git Blame Copy Permalink