# Order

### 1. Purpose

Use this page to:

* Review referral orders and validate reward eligibility
* Approve or decline rewards for each order
* Monitor reward status across all orders
* Manage payout processes for referrers

<figure><img src="/files/JoZuo43vmRuGoWiD5fwX" alt=""><figcaption></figcaption></figure>

***

### 2. Order Lifecycle

Each referral order goes through the following stages:

1. **Pending**\
   The order is under review (waiting period or validation rules)
2. **Approved (Reward sent)**\
   The reward has been approved and issued to the referrer
3. **Declined**\
   The reward is rejected (e.g. invalid order, fraud suspicion)

***

### 3. Order List

The order table displays all referral-generated orders and their reward status.

#### Key Fields

| Field             | Description                                    |
| ----------------- | ---------------------------------------------- |
| **Order ID**      | Shopify order ID generated from a referral     |
| **Created at**    | Date and time the order was created            |
| **Referrer**      | Customer who referred the order                |
| **Referee**       | Customer who placed the order                  |
| **Order value**   | Total value of the order                       |
| **Reward status** | Current reward state (Pending, Sent, Declined) |
| **Action**        | Approve or decline the reward                  |

***

### 4. Reward Status

Each order includes a reward status indicator:

* **Pending**
  * The reward is under review
  * May include a countdown (e.g. “X days left in review period”)
* **Reward sent**
  * The reward has been successfully issued
* **Reward declined**
  * The reward has been rejected
* **Suspicious**
  * The order is flagged for potential fraud
  * Requires manual review before approval

***

### 5. Filters

Use tabs to filter orders by reward status:

* **All orders**\
  View all referral orders
* **Pending rewards**\
  Orders awaiting review
* **Sent rewards**\
  Orders with rewards already issued
* **Declined rewards**\
  Orders with rejected rewards
* **Cash payout**\
  Orders grouped for payout processing

***

### 6. Search

Use the search bar to quickly find orders by:

* Order ID
* Referrer email
* Referee email

***

### 7. Actions

#### Approve Reward

* Confirms the order is valid
* Issues the reward to the referrer

#### Decline Reward

* Rejects the reward for the order
* Common reasons:
  * Fraud suspicion
  * Order cancellation
  * Not meeting campaign conditions

***

### 8. Cash Payout

The **Cash payout** tab allows you to manage reward payments for referrers.

#### Key Fields

| Field              | Description                    |
| ------------------ | ------------------------------ |
| **Referrer**       | Customer receiving payout      |
| **Payment method** | Selected payout method         |
| **Reward**         | Total reward amount to be paid |
| **Payment status** | Current payout status          |
| **Action**         | Manage or process payout       |

***

### 9. Create Payout

When processing payouts, you can:

* Select approved orders
* Review total sales and commission
* Confirm payout for selected orders

#### Key Actions

* **Select orders**\
  Choose one or multiple approved orders
* **Review totals**
  * Total sales
  * Total commission
* **Process payout**\
  Finalize and send payment to the referrer

***

### 10. Notes

* Rewards should only be approved after the validation period is completed
* Suspicious orders should be reviewed carefully before approval
* Declined rewards cannot be reversed unless manually reprocessed
* Payouts are typically based on approved orders only


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloop.plus/referral-program/order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
