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

# Payouts

> How payouts work

How payouts work. Every sale on your store goes through a short waiting period, then auto-settles into your merchant balance. From there, you request a payout whenever you want — funds land in your bank or Alipay a few business days later.

<Steps>
  <Step title="Store earns revenue">
    A customer pays. The amount lands in that store's balance and waits about **10 business days** (around two weeks) so any refunds or chargebacks can settle first.
  </Step>

  <Step title="Auto-settle to your merchant balance">
    After the waiting period, funds move automatically into your **merchant balance** — pooled across all of your stores. Nothing for you to do. View it in **Finance** at the top of the dashboard.
  </Step>

  <Step title="You request a payout">
    Once your balance clears the minimum, you initiate a payout from Finance. Funds typically land in **1–3 business days**.
  </Step>
</Steps>

## Fees and Payout Schedule

|                     |                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| **Minimum payout**  | **\$20 USD** — converted to your local currency at the rate when you submit                         |
| **Settlement hold** | \~10 business days from sale before funds clear                                                     |
| **Arrival time**    | 1–3 business days after you request                                                                 |
| **Payout schedule** | On-demand — no fixed cycle; request manually once your balance clears the minimum                   |
| **Payout fee**      | **1% per payout, \$10 minimum** — deducted from the amount before arrival                           |
| **Taxes**           | Local taxes may also apply, depending on your jurisdiction. Contact support if you need a breakdown |

<Note>
  **Current coverage:** mainland China, settled in CNY. More regions and currencies are on the roadmap.
</Note>

<Note>
  Test mode doesn't affect payouts. Finance and Payout History always show real data, and you can't simulate a payout.
</Note>

## Requesting a Payout

<Frame>
  <img src="https://mintcdn.com/waffo/ufjGfSwGi0IBOUvV/images/dashboard/merchant-finance.png?fit=max&auto=format&n=ufjGfSwGi0IBOUvV&q=85&s=a5b2bb4125eda58f6da8144e96714111" alt="Merchant Finance — balance, available amount, and request payout" width="1432" height="966" data-path="images/dashboard/merchant-finance.png" />
</Frame>

<Steps>
  <Step title="Open Finance">
    Click **Finance** in the top navigation. You'll see your merchant balance and the amount available to withdraw.
  </Step>

  <Step title="Enter an amount">
    Type the amount you want. The minimum is **\$20 USD** — the threshold is set in USD, and the local-currency amount arriving in your account is calculated at the rate the moment you submit.
  </Step>

  <Step title="Confirm the destination">
    Your default payout account is selected. If you've added more than one, switch before submitting. The holder name comes from your verified identity — it's not editable here.
  </Step>

  <Step title="Submit">
    Click **Request Payout**. The payout enters **pending** and you can track it under **Payout History**.
  </Step>
</Steps>

## Failed Payouts

Most payouts land without issue. If yours doesn't, work through this list:

* **Name mismatch.** The bank returned a holder name that doesn't match your legal name on file. Open **Profile**, compare your legal name to your ID character-by-character (including spaces and punctuation), correct it, and retry. If the field is locked, contact support.
* **Identity incomplete.** You can't request a payout — or even add a payout account — without a verified identity. See [Identity Verification](/merchant/identity-kyc).
* **Below the minimum.** Payouts under \$20 USD equivalent are rejected. Wait until your balance clears the threshold, or contact support for an exception.
* **Pending longer than 5 business days.** The bank may be running extra checks on a large amount or a brand-new account. If it doesn't clear within a week, contact support with your payout ID.
* **Holder name doesn't match your identity.** Each payout account must belong to the same legal person whose identity you've verified. If the names don't match exactly — even a punctuation or spacing difference — the payout fails. Open **Profile**, verify your legal name matches your ID exactly, and retry. See [Identity Verification](/merchant/identity-kyc).

<Tip>
  When contacting support, include your merchant ID, the payout ID, the timestamp, and a screenshot. That's enough for us to find the record and respond fast.
</Tip>

## Managing Your Payout Account

You can add, switch, or change your default payout account at any time. See [Payout Accounts](/merchant/payout-accounts) for the setup walkthrough and supported methods.

<CardGroup cols={2}>
  <Card title="Payout Accounts" icon="building-columns" href="/merchant/payout-accounts">
    Add a bank card or Alipay and manage your default
  </Card>

  <Card title="Identity Verification" icon="id-card" href="/merchant/identity-kyc">
    Verify your identity before you can receive a payout
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="When can I start receiving payouts?" icon="clock">
    As soon as your identity is verified and you've added a payout account. The first sale on your store starts a \~10 business day waiting period before funds clear into your merchant balance — once they do, you can request a payout whenever your balance hits the \$20 USD minimum.
  </Accordion>

  <Accordion title="Which countries and currencies do you support?" icon="globe">
    Today we pay out to merchants in **mainland China**, settled in CNY via bank card or Alipay. Most major mainland Chinese banks are supported. More currencies and countries are on the roadmap — contact support and let us know which one you need.
  </Accordion>

  <Accordion title="Can I simulate a payout in test mode?" icon="flask">
    No. Finance and Payout History always read live data, and there's no way to simulate a payout. Anything you submit moves real money.
  </Accordion>

  <Accordion title="How do I change my payout account?" icon="pen-to-square">
    Open **Payout Accounts** from the user menu (or **Finance → Payout Account**). Add a new account and set it as default, or edit the details on an existing one. The holder name is taken from your identity and isn't editable here. See [Payout Accounts](/merchant/payout-accounts).
  </Accordion>

  <Accordion title="My payout is stuck in pending — is something wrong?" icon="spinner">
    Pending is normal for the first 3–5 business days while the bank processes it. Only worry if it stays pending past 5 business days — at that point, contact support with your payout ID.
  </Accordion>

  <Accordion title="My payout failed with a name mismatch. What do I do?" icon="circle-xmark">
    The bank returned a holder name that doesn't match your legal name on file. Open **Profile**, compare your legal name field to your ID character-by-character (including spaces and punctuation), save the correction, and retry. If the field is locked, contact support.
  </Accordion>

  <Accordion title="Alipay is asking me to submit extra documents. Why, and what do I provide?" icon="file-lines">
    For larger payouts, Alipay's risk team may ask you to supply documents proving the background of your transactions. This is a routine check on cross-border settlements — it does **not** mean anything is wrong with your account. You'll typically be asked for:

    * **Terms of service (TNC)** — proof that Waffo acts as your merchant of record, collecting, invoicing and settling on your behalf. See the [Developer Terms](https://www.waffo.ai/developer-terms).
    * **Transaction / settlement details** — download an export from the corresponding page in your dashboard and submit it as an Excel/CSV file.
    * **Invoices** — the receipts issued to your customers. Go to the Payments page, open a transaction to see its detail, and you'll find the invoice link there.
    * **Website / product info** — a screenshot of your own pricing page, so the products and prices match your transaction records.

    A few tips:

    * You can upload **up to 10 files**. A good mix is your terms + one transaction export + your top invoices.
    * **Prioritize your largest transactions** — they carry the most weight.
    * Submit **within 24 hours**, or the request is returned.
    * For the **service type** field, we recommend selecting **software service** (数字产品 / SaaS / 订阅), and keep it consistent with your website and invoices.
  </Accordion>

  <Accordion title="Alipay keeps rejecting my documents. Is there another way to get paid?" icon="building-columns">
    Yes. Alipay isn't your only option — you can switch to a **bank card**. Open **Payout Accounts**, add a Bank Transfer account, set it as your payout account, and request your payout through it. This bypasses the Alipay document review entirely. Contact support if you'd like help deciding.
  </Accordion>

  <Accordion title="When should I contact support?" icon="headset">
    Reach out if your payout has been pending for more than 5 business days, you see a failure reason you don't recognize, you need to change a locked identity field, or you need a country or currency we don't support yet. Include your merchant ID, the payout ID, the timestamp, and a screenshot.
  </Accordion>
</AccordionGroup>