> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zen.land/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide for Sellers

> How to get paid securely while protecting your work with Zenland escrow.

## Why Use Escrow as a Seller?

Escrow protects you just as much as the buyer:

* ✅ **Funds are locked upfront** — buyer can't ghost after you deliver
* ✅ **You're protected** from chargebacks and "I changed my mind"
* ✅ **You can always refund** if something goes wrong on your end

***

## Getting Started as a Seller

### 1. Share Your Wallet Address

Give your **Ethereum wallet address** to the buyer. They'll use it to create the escrow.

<Tip>
  Use an ENS name (like `yourname.eth`) to make it easier for buyers to find you and verify your identity.
</Tip>

### 2. Review the Escrow Invitation

When a buyer creates an escrow with you, you'll see it in your dashboard:

<CardGroup cols={2}>
  <Card title="What to Check">
    * Is the amount correct?
    * Do the terms match your agreement?
    * Is the protection time reasonable?
    * Who is the selected agent?
  </Card>

  <Card title="Red Flags">
    * Amount doesn't match discussion
    * Vague or missing terms
    * Very short protection time
    * No agent selected (understand the risks)
  </Card>
</CardGroup>

### 3. Accept or Decline

<CardGroup cols={2}>
  <Card title="Accept" icon="check">
    If everything looks good, accept the escrow. You're now committed to delivering.
  </Card>

  <Card title="Decline" icon="xmark">
    If something's wrong, decline. The buyer gets an immediate refund.
  </Card>
</CardGroup>

<Warning>
  Once you accept, you're expected to deliver. Only accept escrows you're confident you can complete.
</Warning>

***

## Doing the Work

Once the escrow is active:

### Stay in Communication

* **Update the buyer** on your progress
* **Ask questions** if anything is unclear
* **Set expectations** for delivery timeline

### When You're Done

<Steps>
  <Step title="Double-check your work">
    Make sure you've delivered everything in the agreement
  </Step>

  <Step title="Click 'Mark as Fulfilled'">
    This signals to the buyer that you're done
  </Step>

  <Step title="Wait for release">
    The buyer reviews and releases funds. The protection timer starts.
  </Step>
</Steps>

***

## Getting Paid

### Best Case: Buyer Releases

The buyer reviews your work, loves it, and hits Release. Funds arrive instantly!

### Buyer is Unresponsive

If the buyer doesn't respond after marking fulfilled:

1. **Wait for protection time to expire**
2. **Claim the funds yourself** — you've earned them!

This is your safety net against buyers who ghost after receiving good work.

### Buyer Opens a Dispute

Don't panic. Here's what happens:

<Steps>
  <Step title="You'll be notified">
    You'll see the dispute in your dashboard
  </Step>

  <Step title="Agent is invited">
    The pre-selected agent reviews the case
  </Step>

  <Step title="Present your side">
    Share delivery proof, messages, and anything showing you delivered
  </Step>

  <Step title="Agent decides">
    The agent determines a fair split. Their fee is deducted from the total.
  </Step>
</Steps>

***

## Your Secret Weapon: Seller Refund

As a seller, you have a powerful option others don't: **unilateral refund**.

<Card title="sellerRefund()" icon="undo">
  At any time before the escrow is finalized, you can return 100% to the buyer — no approval needed.
</Card>

Use this when:

* 😅 You realize you can't complete the work
* 🤝 You want to end things on good terms
* ⚠️ The project scope changed unexpectedly

<Note>
  Refunding protects your reputation. It's better to refund early than get a bad resolution.
</Note>

***

## Proposing a Split

Sometimes partial payment is fair. You can propose a split:

<Steps>
  <Step title="Click 'Propose Split'">
    Choose how to divide the funds (e.g., 70% to you, 30% to buyer)
  </Step>

  <Step title="Buyer reviews">
    They can accept, reject, or counter-propose
  </Step>

  <Step title="Agreement = Payout">
    When you both agree, funds are distributed automatically
  </Step>
</Steps>

***

## Important Seller Tips

<CardGroup cols={2}>
  <Card title="Keep Records" icon="folder">
    Save all communications, specs, and work files. They're crucial in disputes.
  </Card>

  <Card title="Mark Fulfilled Promptly" icon="flag-checkered">
    When you're done, mark it. This starts the protection timer.
  </Card>

  <Card title="Communicate Delays" icon="message">
    If you need more time, tell the buyer early. Most are understanding.
  </Card>

  <Card title="Know the Agent" icon="user-shield">
    Understand who will resolve disputes before you accept.
  </Card>
</CardGroup>

***

## FAQs for Sellers

<AccordionGroup>
  <Accordion title="What if the buyer opens a frivolous dispute?">
    Present your evidence to the agent. If you delivered what was agreed, you'll likely win the dispute. Agents are trained to identify bad-faith buyers.
  </Accordion>

  <Accordion title="Can I increase the escrow amount mid-work?">
    The current escrow amount is fixed. For additional work, create a new escrow with the new scope.
  </Accordion>

  <Accordion title="What if the buyer disappears?">
    Mark as fulfilled, wait for protection time to expire, then claim the funds. The smart contract enforces your right to payment.
  </Accordion>

  <Accordion title="Do I pay any fees?">
    No! The buyer pays the 1% creation fee. You receive the full escrow amount (minus agent fees only if there's a dispute resolution).
  </Accordion>
</AccordionGroup>