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

# Payments

> Track transactions and manage refunds

## Payments Overview

The Payments page shows all transactions processed through your store, including one-time purchases and subscription charges.

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/payments-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=132d6aa291132199c1cb507c4eefea64" alt="Payments List" width="1440" height="900" data-path="images/dashboard/payments-list.png" />
</Frame>

## Payment List

View all payments in a comprehensive table:

| Column         | Description                         |
| -------------- | ----------------------------------- |
| Date           | Transaction timestamp               |
| Amount Paid    | Gross payment amount                |
| Tax Amount     | Tax collected                       |
| Status         | Payment status                      |
| Payment Method | Card type and last 4 digits         |
| Description    | Payment description or product name |
| Customer       | Customer email                      |
| Product        | Associated product                  |

## Payment Statuses

<CardGroup cols={2}>
  <Card title="Paid" icon="check" color="#22c55e">
    Successfully processed and funds received.
  </Card>

  <Card title="Pending" icon="clock" color="#f59e0b">
    Payment initiated but not yet confirmed.
  </Card>

  <Card title="Refunded" icon="rotate-left" color="#6366f1">
    Full amount has been refunded.
  </Card>

  <Card title="Partial Refund" icon="circle-half-stroke" color="#8b5cf6">
    Part of the payment has been refunded.
  </Card>

  <Card title="Declined" icon="xmark" color="#ef4444">
    Payment was rejected by the payment processor.
  </Card>

  <Card title="Chargeback" icon="triangle-exclamation" color="#dc2626">
    Customer disputed the charge with their bank.
  </Card>
</CardGroup>

## Filtering Payments

Filter your payment list by:

| Filter     | Options                                            |
| ---------- | -------------------------------------------------- |
| Status     | All, Paid, Pending, Refunded, Declined, Chargeback |
| Product    | Any product in your catalog                        |
| Date Range | Custom start and end dates                         |
| Customer   | Search by email                                    |
| Amount     | Min/Max amount range                               |

### Search

Search payments by:

* Payment ID
* Customer email
* Product name
* Last 4 digits of card

## Payment Details

Click on any payment to view full details:

### Transaction Info

* Payment ID
* Amount and currency
* Tax amount
* Net amount (after fees)
* Timestamp
* Test/Live mode indicator

### Payment Method

* Card brand (Visa, Mastercard)
* Last 4 digits
* Expiration date
* Country of issue

### Customer Info

* Email
* Name (if provided)
* IP address
* Country

### Associated Records

* Product purchased
* Subscription ID (if applicable)
* Invoice link

## Processing Refunds

<Steps>
  <Step title="Find the Payment">
    Locate the payment in the list or use search.
  </Step>

  <Step title="Click 'Refund'">
    Open the payment details and click the Refund button.
  </Step>

  <Step title="Choose Refund Type">
    * **Full Refund** - Return the entire amount
    * **Partial Refund** - Enter a custom amount
  </Step>

  <Step title="Add Reason (Optional)">
    Document why the refund is being processed.
  </Step>

  <Step title="Confirm">
    Review and confirm the refund.
  </Step>
</Steps>

<Warning>
  Refunds typically take 5-10 business days to appear on the customer's statement. Refunds cannot be reversed once processed.
</Warning>

### Refund Policies

| Scenario             | Recommendation                     |
| -------------------- | ---------------------------------- |
| Duplicate charge     | Full refund                        |
| Partial service used | Partial refund                     |
| Service issue        | Full or partial based on situation |
| Fraud                | Full refund + review account       |

## Payment Statistics

At the top of the Payments page:

| Metric           | Description                  |
| ---------------- | ---------------------------- |
| Total Revenue    | Sum of all paid transactions |
| Net Revenue      | Total revenue minus refunds  |
| Total Refunded   | Sum of all refunds issued    |
| Successful       | Count of successful payments |
| Avg. Order Value | Average payment amount       |

## Payment Methods

Buyers can pay by card or digital wallet. Which options appear at checkout depend on the buyer's device, region, and — most importantly — the order's pricing currency.

### Global Methods

Available to buyers worldwide.

<CardGroup cols={3}>
  <Card title="Cards" icon="credit-card">
    Visa and Mastercard — credit, debit, and prepaid, worldwide.
  </Card>

  <Card title="Apple Pay" icon="apple">
    iOS and Safari, where Apple Pay is enabled.
  </Card>

  <Card title="Google Pay" icon="google">
    Android and Chrome, where Google Pay is enabled.
  </Card>
</CardGroup>

### Local Methods

Region-specific methods, shown to buyers in their market.

<CardGroup cols={3}>
  <Card title="WeChat Pay" icon="comment">
    Mainland China and Hong Kong, for USD and CNY orders.
  </Card>
</CardGroup>

### Method and Currency Support

Each method supports a specific set of currencies. The order's pricing currency decides which methods a buyer sees at checkout.

| Pricing currency | Cards | Apple Pay | Google Pay | WeChat Pay |
| ---------------- | :---: | :-------: | :--------: | :--------: |
| USD              |   ✓   |     ✓     |      ✓     |      ✓     |
| EUR              |   ✓   |     ✓     |      ✓     |      —     |
| GBP              |   ✓   |     ✓     |      ✓     |      —     |
| JPY              |   ✓   |     ✓     |      ✓     |      —     |
| HKD              |   ✓   |     ✓     |      ✓     |      —     |
| CNY              |   —   |     —     |      —     |      ✓     |

<Note>
  **CNY is WeChat Pay only.** An order priced in CNY can be paid **only** with WeChat Pay — cards and other wallets don't accept CNY. WeChat Pay itself accepts only **USD and CNY**.
</Note>

### Per-Order Price Limits

A product's price must fall within the range allowed for its currency. Prices outside the range are rejected when you create or edit the product.

| Currency | Minimum  | Maximum       |
| -------- | -------- | ------------- |
| USD      | \$1.00   | \$7,500.00    |
| EUR      | €1.00    | €7,400.00     |
| GBP      | £1.00    | £6,400.00     |
| JPY      | ¥100     | ¥1,250,000    |
| CNY      | ¥1.00    | ¥1,000.00     |
| HKD      | HK\$8.00 | HK\$61,000.00 |

### WeChat Pay Notes

Beyond the currency rules above, WeChat Pay only appears at checkout when:

* The order is a **one-time payment** — WeChat Pay does not support subscriptions.
* The order total is **roughly \$140 USD** (or **¥1,000 CNY**) **or less**.

When an order doesn't qualify, WeChat Pay is hidden and the buyer pays by card. The per-order limit may increase over time.

#### Why CNY orders can differ slightly at checkout

WeChat Pay settles in **HKD**, so a CNY-priced order is converted twice — CNY to HKD for settlement, then HKD back to CNY when the buyer pays. The two conversions may use different rates, so the amount paid can differ slightly from your listed CNY price.

<Tip>
  **Price in USD for the most predictable experience** — no double conversion, so the amount charged matches your listed price.
</Tip>

<Card title="Request a payment method" icon="circle-plus" href="https://docs.google.com/forms/d/e/1FAIpQLSdJY9RDcUsUQ83bkUNWB_irQ0uFl4D_BhznFQ9p9cOhrKxK6A/viewform">
  Need a regional method we don't list yet? Tell us which one and where you sell — submissions feed directly into our roadmap prioritization.
</Card>

## Chargebacks

When a customer disputes a charge:

1. You'll receive a notification
2. Payment status changes to "Chargeback"
3. Funds are held pending resolution
4. You can submit evidence to fight the dispute

<Note>
  Chargebacks carry fees and can impact your merchant reputation. Prevent them with clear product descriptions, good customer service, and recognizable billing descriptors.
</Note>

## Exporting Payments

Export payment data for accounting or analysis:

1. Apply desired filters
2. Click "Export"
3. Select format (CSV or PDF)
4. Download the file

Export includes:

* All payment details
* Customer information
* Tax amounts
* Refund status
* Timestamps
