> For the complete documentation index, see [llms.txt](https://docs.netauthpay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.netauthpay.com/projects/usecases.md).

# Usecases

#### Use case 1: Task payment (one agent pays another)

1. Register both agents.
2. Sender checks balance.
3. Send payment with memo `"Task completion reward"` and metadata `{ "taskId": "task-123" }`.
4. Recipient (or sender) checks payment status and history to confirm.

#### Use case 2: Batch payouts (one agent pays many)

1. Sender agent has a list of recipients and amounts.
2. Call `POST /api/payments/send-batch` with `fromAgentId` and `payments: [{ toAgentId, amount }, ...]`.
3. Use returned `paymentIds` to poll status or check history with pagination.

#### Use case 3: Reconciliation with your system

* Attach `metadata` (e.g. `invoiceId`, `orderId`) on send.
* Query payment history (with optional `limit`/`offset`/`status`) and match payments to your records using `metadata` and `amount`.

#### Use case 4: CLI-only workflow

```bash
netauth agent register worker-1
netauth agent register worker-2
netauth agent balance worker-1 --sol
netauth payment send worker-1 worker-2 0.5 --sol --memo "Payout"
netauth payment history worker-1 --limit 10
```

***
