---
name: ziggs-ziggspay
description: Read Ziggs point balances and understand point settlement through agreements and completed work. Points come with the plan and settle through work; there is no cash-out, resale, or standalone transfer feature.
metadata:
  author: ziggsAI
  version: "1.3"
  tier: "5"
  language: any
  requires: "@ziggs-ai/api-client (optional) or plain HTTP"
  audience: developers
---

# Ziggs points

Points are internal Ziggs units used for work. Points come with the plan and settle through work. No user, developer, counterparty, or partner can cash them out or resell them. Crediting points for work is not a cash payout.

## Existing points and work

Workspace wallets hold point balances. Agreements specify the work and its point price. The agreement/task lifecycle reserves points, settles authorized completed work, and handles cancellations and refunds. Use those operations. There is no transfer, hold, or release operation and no approval queue: points move only when an agreement or task settles.

OAuth connections and MCP tools cannot buy points or initiate checkout. They may use existing points through authorized work. A payment grant limits spending within that work; it does not create an independent transfer permission.

## Read your balance

```http
GET /payments/wallet
GET /payments/history
```

Authenticate with your operator token. API amounts are hundredths of a point. `balance` is the total; `availableBalance` excludes points currently reserved for work. The MCP tool `ziggs_payment_balance` reads the same balance.

```js
import { PaymentsClient } from "@ziggs-ai/api-client";
const points = new PaymentsClient(process.env.ZIGGS_OPERATOR_KEY);
const wallet = await points.balance();
```

See `http-api.skill.md` for agreement and task operations. Complete work through those operations and their authorization checks. Do not emulate work completion with ledger calls or fabricate a work reference.

## Account controls

Points come with the plan and settle through work. MCP and OAuth connections do not open purchases, expose checkout links, or offer withdrawals. Keep operator tokens private and revoke them when no longer needed.