> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Points administration

> Manage the points your organization issues and redeems — recharge wallets, audit movement, fix unmapped transactions, and run point-history reports.

Points administration is the finance back-office for Empuls's points system. From this page you can recharge the organization wallet, view every points movement (issued, deducted, redeemed), inspect wallet criteria rules, troubleshoot transactions that didn't map to a user, and pull point-history reports for accounting.

## Before you start

* You must be a **Super Admin** or have **Finance Admin** permission.
* Reward points and karma (engagement score) are different — this page only governs reward points. For karma, see [engagement scoring](/admin/programs/promotional-points).
* Adjustments here are auditable. Every add/deduct creates a record visible in points history.

## Sub-pages

The Points Administration hub has several specialized sub-pages:

| Sub-page                        | What it shows                                                                 | URL                                                               |
| ------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| **Points history (statement)**  | Every points credit and debit by user, with date, amount, reason              | `/home/points-administration/points-history`                      |
| **Recharge history**            | Every wallet top-up — who did it, when, for how much                          | `/home/points-administration/recharge-history`                    |
| **Redemption wallet statement** | Movement on the redemption wallet specifically                                | `/home/points-administration/redemption-wallet-statement-history` |
| **Redemption point statement**  | Points that flowed out via employee redemption                                | `/home/points-administration/redemption-point-statement-history`  |
| **Wallet criteria list**        | Rules that determine which wallet funds which event type                      | `/home/points-administration/wallet-criteria-list`                |
| **Unmapped transactions**       | Transactions Empuls couldn't attribute to a user; needs manual reconciliation | `/home/points-administration/transactions-not-mapped`             |
| **Wallet details**              | Per-wallet view with balance and movement                                     | `/home/points-administration/wallet/:id`                          |
| **Create wallet**               | Spin up an additional wallet for a specific program                           | `/home/points-administration/create-wallet`                       |

## Add or deduct points for an individual

<Steps>
  <Step title="Open Add/Deduct Points" />

  <Step title="Pick the user">
    Search by name or email. Select the user whose balance you're adjusting.
  </Step>

  <Step title="Choose Add or Deduct">
    Toggle between **Add points** and **Deduct points**.
  </Step>

  <Step title="Enter amount and reason">
    Points must be a whole number. Reason is required and appears in points history for audit.
  </Step>

  <Step title="Submit">
    The adjustment posts immediately. The user sees the updated balance on their next page load.
  </Step>
</Steps>

## Bulk add or deduct via CSV

The same form supports CSV upload for bulk adjustments. Download the sample CSV, fill in `email,points,reason`, upload, and Empuls processes each row in the background. The job result shows successes and failures.

## Wallet criteria

Wallet criteria control which wallet funds which event. For example:

* A "Peer Recognition Wallet" funds all peer-to-peer recognition.
* A "Service Awards Wallet" funds milestone gifts only.
* A general "Redemption Wallet" funds anything not matched by a more specific criterion.

Edit criteria from the Wallet Criteria List page. Empuls matches transactions to wallets in priority order; the most specific match wins.

## Unmapped transactions

If a transaction comes in (typically from an HRIS-driven event) and Empuls can't find a matching user, it lands in the unmapped transactions page. From there you can:

* **Map manually** — Pick a user; the transaction posts retroactively.
* **Reject** — Discard the transaction.

Unmapped transactions are the most common signal of HRIS-Empuls data drift. Resolving them quickly keeps your audit clean.

## Reports

CSV exports are available from each sub-page. The CSV includes the same columns the page shows. Use these for:

* Quarterly board reporting on recognition spend.
* Year-end finance close.
* Reconciling Empuls points movement against the redemption-wallet financial wallet.

## Limits and gotchas

* Adjustments to negative balances are allowed but rare. Empuls flags users with negative balances on the points-history page.
* Deleting an unmapped transaction is permanent.
* Wallet criteria changes apply to new transactions only. Already-recorded transactions are not retroactively reassigned.

## Related

<CardGroup cols={2}>
  <Card title="Redemption wallets" href="/admin/finance/redemption-wallets">
    Top-level wallet management.
  </Card>

  <Card title="Budgets" href="/admin/finance/budgets">
    Automated distribution of points.
  </Card>

  <Card title="Engagement scoring" href="/admin/programs/promotional-points">
    Karma for the leaderboard, separate from reward points.
  </Card>

  <Card title="Reports" href="/admin/reports/overview">
    Cross-cutting analytics including points spend.
  </Card>
</CardGroup>